에이전트 기술을 사용하여 지니 코드 확장

Genie Code는 Notebook에서 코드 작성, Unity 카탈로그의 데이터 탐색, 대시보드 빌드, 파이프라인 만들기 및 MLflow 작업과 같은 일반적인 Azure Databricks 워크플로에 대한 기본 제공 기술을 제공합니다. 팀의 도메인별 작업에 대한 특수 기능을 사용하여 Genie 코드 에이전트 모드를 확장하는 사용자 지정 기술을 만듭니다. 이 페이지에서는 만들고 최적화하는 방법을 설명합니다.

기술이란?

특수한 기능을 사용하여 Genie Code를 확장하는 기술을 만듭니다. 기술은 에이전트 기술의 개방형 표준을 따릅니다. Genie Code는 기술 패키지에 포함된 도메인별 지식과 워크플로를 관련성이 있을 때 특정 작업을 수행하기 위해 로드할 수 있습니다. 기술에는 지침, 모범 사례, 재사용 가능한 코드 및 실행 가능한 스크립트가 포함될 수 있습니다.

기술은 도메인별 작업에 맞게 조정되어야 합니다. 기술을 사용하면 지침보다 더 큰 컨텍스트(예: 스크립트, 예제 및 기타 리소스)를 작업에 제공할 수 있습니다. 전역적으로 적용되는 사용자 지정 지침과 달리 기술은 관련 컨텍스트에서만 자동으로 로드됩니다. 에이전트 모드에서 Genie Code는 요청 및 기술 설명에 따라 관련되는 경우 자동으로 기술을 로드합니다. 또한 기술을 언급하여 @ 수동으로 호출할 수도 있습니다. 이렇게 하면 효율적인 컨텍스트 창이 유지되고 여러 채팅에서 동일한 컨텍스트를 제공할 필요가 줄어듭니다.

두 가지 유형의 기술이 있습니다.

  • 작업 영역 기술: 작업 영역의 모든 사용자가 사용할 수 있습니다. 작업 영역 관리자는 작업 영역 기술을 만들고 다른 사용자에게 기술 폴더에 대한 액세스 권한을 부여하여 더 추가할 수 있습니다. 작업 영역 기술을 사용하여 조직 전체 표준을 적용하거나, 사용자 간에 일관된 출력을 제공하거나(예: 중요한 열을 마스킹하는 PII 처리 기술), 다른 팀(예: 데이터 엔지니어를 위한 파이프라인 템플릿 및 ML 플랫폼 사용자를 위한 모델 학습 플레이북)을 제공합니다.
  • 사용자 기술: 사용자만 사용할 수 있습니다. 기본 라이브러리, 코딩 스타일 또는 역할 및 배경 컨텍스트와 같은 개인 기본 설정에 사용자 기술을 사용합니다. 사용자 기술은 스킬을 작업 영역 수준으로 승격하기 전에 프로토타이핑하는 데에도 유용합니다.

메모

기술은 Genie 코드 에이전트 모드에서만 지원됩니다.

기술 만들기

기술은 디렉터리에 있습니다 .assistant/skills/ . 각 기술에는 고유한 폴더와 해당 폴더 내의 SKILL.md 파일이 있어야 합니다. 위치는 기술 유형에 따라 달라집니다.

  • 작업 영역 기술: Workspace/.assistant/skills/
  • 사용자 기술: /Users/{username}/.assistant/skills/

새 기술을 만들려면 다음을 수행합니다.

  1. 기술 유형에 적합한 경로에 새 기술 폴더를 만듭니다.

    만든 후에는 Genie Code 패널에서 기술 폴더에 빠르게 액세스할 수 있습니다. 기어 아이콘 을 클릭합니다. 설정을 클릭한 다음 아이콘에서 화살표를 클릭합니다. 기술 폴더를 엽니다.

  2. 기술 폴더 내에서 기술에 대한 전용 폴더를 만듭니다. 각 기술에는 고유한 폴더가 있어야 합니다. 다음은 그 예입니다.

    Workspace/.assistant/skills/
└── ml-workflows/
    └── SKILL.md

/Users/{username}/.assistant/skills/
└── personal-workflows/
    └── SKILL.md

  3. 기술 폴더 내에서 SKILL.md 파일을 만듭니다. 이 파일은 필수이며 기술을 정의합니다. 기술은 에이전트 기술의 사양을 따릅니다.

  4. 기술에 필요한 프런트매터를 추가합니다.

    ---
name: skill-name
description: A description of what this skill does and when to use it.
---

  5. 프런트매터 뒤의 Markdown 형식으로 기술 지침을 추가합니다. 다음 섹션을 포함하는 것이 좋습니다.

    • 단계별 지침: 명확한 절차 안내
    • 예: 샘플 입력 및 예상 출력
    • 에지 사례: 일반적인 변형 및 예외

  6. (선택 사항) 더 복잡한 기술을 위해 추가 리소스를 제공하고 참조할 수 있습니다.

    • 에이전트가 실행할 수 있는 실행 코드가 포함된 스크립트입니다.
    • 참조할 추가 설명서(예: 모범 사례 및 템플릿)가 포함된 파일입니다.

    다른 파일을 참조할 때 루트 기술의 상대 경로를 사용합니다.

    예를 들어 작업 영역 기계 학습 워크플로 기술과 개인 워크플로 기술에는 다음과 같은 구조가 있을 수 있습니다.

    Workspace/.assistant/skills/
├── ml-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── training-patterns.md    # Standard ML training patterns
   └── scripts/
         └── model-deploy.py   # Model deployment automation

/Users/{username}/.assistant/skills/
├── personal-workflows/
   ├── SKILL.md                # Workflow overview and best practices
   ├── etl-patterns.md         # Personal ETL best practices
   ├── dashboard-templates.md   # Reusable dashboard patterns
   └── scripts/
         └── pipeline-setup.sh   # Environment setup scripts

지니 코드는 에이전트 모드에서 다음에 기술을 사용할 때 자동으로 기술을 인식합니다. 또한 Genie Code가 기술을 사용하게 하려면 해당 기술을 언급할 수도 @ 있습니다.

기존 기술을 편집할 때 새 채팅 스레드를 시작하여 변경 내용을 적용합니다. 편집은 활성 스레드에서 적용되지 않습니다. 이전 동작 또는 오래된 설명을 표시하는 등 기술이 여전히 부실하게 표시되는 경우 브라우저 탭을 하드 새로 고쳐 캐시된 기술 메타데이터를 지웁니다.

모범 사례

효과적인 기술을 작성하려면 다음 지침을 따르세요.

  • 적절한 기술 유형을 선택합니다. 모든 사용자가 일관된 출력을 얻을 수 있도록 작업 영역 기술을 사용하여 공유 표준(예: PII 처리, 명명 규칙 또는 팀별 템플릿)을 명문화합니다. 개인 설정에는 사용자 스킬을 사용하고, 워크스페이스로 승격하기 전에 스킬을 프로토타이핑하세요.
  • 기술을 집중하세요. 기술은 단일 작업 또는 워크플로에 집중할 때 가장 적합합니다. 범위를 좁히면 Genie Code에서 기술이 적용되는 시기를 더 쉽게 인식할 수 있습니다.
  • 명확한 이름 및 설명을 사용합니다. 간결하고 설명적인 이름 및 요약은 Genie Code가 올바른 기술을 올바른 요청과 일치시킬 수 있도록 도와줍니다.
  • 명시적이고 예제 기반이어야 합니다. 워크플로를 단계별로 설명하고 Genie Code에서 다시 사용할 수 있는 구체적인 예제 또는 패턴을 포함합니다.
  • 불필요한 컨텍스트를 방지합니다. 작업에 필요한 정보만 포함합니다. 추가 세부 정보는 기술을 안정적으로 적용하기 어렵게 만들 수 있습니다.
  • 시간이 지남에 따라 반복합니다. 기술을 살아있는 워크플로로 취급합니다. 실제 사용을 기반으로 하는 작은 업데이트는 결과를 크게 향상시킬 수 있습니다.
  • Genie Code로 스킬 작성 Genie Code를 사용하여 기술 초안을 작성하고 구체화합니다. 대표 작업에 대한 신규 또는 업데이트된 기술을 테스트하여 에이전트가 어려움을 겪는 위치를 찾은 다음 지침을 업데이트하여 이러한 격차를 해소합니다.
  • 자동화와 별도의 지침입니다. markdown을 사용하여 의도 및 모범 사례 및 반복 가능한 작업에 대한 스크립트를 설명합니다. 이러한 문제를 고유하게 유지하면 기술을 더 쉽게 유지 관리하고 재사용할 수 있습니다.
  • 당신의 기술을 버전 관리하세요. Databricks Git 폴더를 사용하여 기술 폴더를 백업하여 변경 내용을 추적하고, 팀원과 공동 작업하고, 필요할 때 롤백합니다.

참고하십시오

  • Last updated on