다음을 통해 공유


어시스턴트를 에이전트 기술로 확장하기

도메인별 작업에 대한 특수 기능을 사용하여 에이전트 모드에서 Databricks Assistant를 확장하는 기술을 만듭니다. 이 페이지에서는 기술을 만들고 최적화하는 방법을 설명합니다.

기술이란?

특수한 기능을 사용하여 도우미를 확장하는 기술을 만듭니다. 기술은 에이전트 기술의 개방형 표준을 따릅니다. 스킬 패키지는 어시스턴트가 특정 작업을 수행할 때 로드할 수 있는 세분화된 지식과 워크플로입니다. 기술에는 지침, 모범 사례, 재사용 가능한 코드 및 실행 가능한 스크립트가 포함될 수 있습니다.

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

비고

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

기술 만들기

기술은 디렉터리에 있습니다 /Users/{username}/.assistant/skills/ . 각 기술에는 고유한 폴더와 해당 폴더 내의 SKILL.md 파일이 있어야 합니다.

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

  1. 사용자 작업 영역 폴더에서 새 기술 폴더를 만듭니다. 폴더 경로는 다음과 /Users/{username}/.assistant/skills/같습니다.

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

  2. 기술 폴더 내에서 기술에 대한 전용 폴더를 만듭니다. 각 기술에는 고유한 폴더가 있어야 합니다. 예를 들어 개인 워크플로에 대한 기술을 만드는 경우 폴더 구조는 다음과 같습니다.

    /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. (선택 사항) 더 복잡한 기술을 위해 추가 리소스를 제공하고 참조할 수 있습니다.

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

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

    예를 들어 파이프라인 설정 및 배포를 위한 ETL 모범 사례, 대시보드 템플릿 및 스크립트를 참조하는 개인 워크플로 기술이 있을 수 있습니다. 기술 폴더에는 다음 파일이 포함될 수 있습니다.

    /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
             └── model-deploy.py     # Model deployment automation
    

Databricks Assistant는 다음에 에이전트 모드에서 사용할 때 자동으로 당신의 기술을 인식합니다.

모범 사례

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

  • 기술을 집중하세요. 기술은 단일 작업 또는 워크플로에 집중할 때 가장 적합합니다. 범위를 좁히면 도우미가 기술이 적용되는 시기를 더 쉽게 인식할 수 있습니다.
  • 명확한 이름 및 설명을 사용합니다. 간결하고 설명이 포함된 이름 및 요약은 길잡이가 올바른 기술을 올바른 요청과 일치시킬 수 있도록 도와줍니다.
  • 명시적이고 예제 기반이어야 합니다. 워크플로를 단계별로 설명하고 길잡이가 다시 사용할 수 있는 구체적인 예제 또는 패턴을 포함합니다.
  • 불필요한 컨텍스트를 방지합니다. 작업에 필요한 정보만 포함합니다. 추가 세부 정보는 기술을 안정적으로 적용하기 어렵게 만들 수 있습니다.
  • 시간이 지남에 따라 반복합니다. 기술을 살아있는 워크플로로 취급합니다. 실제 사용을 기반으로 하는 작은 업데이트는 결과를 크게 향상시킬 수 있습니다.
  • 자동화와 별도의 지침입니다. markdown을 사용하여 의도 및 모범 사례 및 반복 가능한 작업에 대한 스크립트를 설명합니다. 이러한 문제를 고유하게 유지하면 기술을 더 쉽게 유지 관리하고 재사용할 수 있습니다.

참고하십시오