Microsoft 365 에이전트 도구 키트로 만든 선언적 에이전트에 기술 추가

팁

권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.

중요

Microsoft Purview IB(정보 장벽)를 사용하는 테넌트에서 관리자는 기술이 있는 선언적 에이전트를 배포할 수 있지만 최종 사용자는 자신이 만든 선언적 에이전트에 기술을 추가할 수 없습니다.

스킬은 특정 작업에 대한 지침, 리소스 및 스크립트를 패키지화하기 위해 선언적 에이전트에 추가하는 모듈식 구성 요소입니다. 빌드 또는 재사용 중에 선택한 프로젝트에서 이미 Microsoft 365 ATK(Agents Toolkit)를 사용하는 경우 이 문서를 사용하세요. 에이전트에 등록된 기술, 저장된 작업 지침 및 프로비전된 테스트 버전으로 완료합니다.

새로운 전문 개발자 플러그인 프로젝트의 경우 Work IQ Dev Tools 및 문서화된 환경으로 시작합니다. 프로젝트 컨트롤이 선택한 에이전트 경로에 적합할 때 이 도구 키트 절차를 유지하십시오. 모든 플러그인에 필수적인 것은 아닙니다.

기술이 무엇인지, 왜 사용하는지, 전체 지원 매트릭스, 지원되는 파일 형식, 샌드박스 동작 및 거버넌스에 대해 알아보려면 선언적 에이전트의 기술을 참조하세요.

이 가이드는 에이전트 범위 기술을 추가합니다. 플러그 인을 통해 Copilot Chat에서 직접 사용할 기술을 배포하려면 Copilot Chat 기술 빌드를 참조하세요.

중요

이 가이드에서는 Microsoft 365 에이전트 도구 키트 및 JSON을 사용하여 선언적 에이전트 만들기 자습서를 완료했다고 가정합니다. 기술을 추가하려면 선언적 에이전트 매니페스트 버전 1.9가 필요합니다. 이전 버전의 에이전트 도구 키트로 만든 에이전트를 사용하는 경우 에이전트 매니페스트의 버전을 업데이트해야 할 수 있습니다. 자세한 내용은 선언적 에이전트 매니페스트 참조를 참조하세요.

필수 구성 요소

에이전트 기술 활성화

에이전트 기술 지원은 환경 변수에 의해 제어됩니다 TEAMSFX_AGENT_SKILLS . CLI 또는 Visual Studio Code를 실행하기 전에 설정하세요.

  • Windows(PowerShell) - 세션 간에 변수를 유지하려면 사용자 환경 변수에 추가합니다.

    [System.Environment]::SetEnvironmentVariable("TEAMSFX_AGENT_SKILLS", "true", "User")
    
  • macOS 또는 Linux - 변수를 설정합니다.

    export TEAMSFX_AGENT_SKILLS=true
    

    변수를 유지하려면 , , ~/.zshrc또는 이에 상응하는 셸 프로필에 ~/.bashrc줄을 export 추가합니다.

Visual Studio Code 확장을 설치한 후 변수를 설정한 경우 Visual Studio Code를 완전히 다시 시작하세요.

확인: 다시 시작된 도구 프로세스는 TEAMSFX_AGENT_SKILLS 로 설정됩니다.true 사용자 수준 Windows 설정은 이미 실행 중인 프로세스를 변경하지 않습니다.

에이전트에 기술 추가

  1. 기존 프로젝트에서 기술을 추가합니다. 새 기술을 만들려면 이름과 설명을 입력합니다.

    atk add skill --name skill-name --description description
    

    기존 기술 폴더를 추가하려면 다음 옵션을 사용합니다 --from .

    atk add skill --from PATH_TO_SKILL
    

    확인: 프로젝트에는 기술 디렉터리 및 SKILL.md가 포함되어 있으며 선언적 에이전트 매니페스트는 해당 기술을 참조합니다. 지원 매트릭스를 따르십시오. 이 가져오기 옵션은 에이전트 간 재사용을 설정하지 않습니다.

  2. 작업 지침, 리소스 및 지원되는 스크립트를 사용하여 기술을 SKILL.md 편집합니다.

    확인: 저장된 파일은 필수 메타데이터를 유지하고 작업, 예상 출력 및 경계를 설명합니다.

  3. 선언적 에이전트를 프로비전하여 환경에서 사용할 수 있도록 합니다.

    atk provision --env local
    

    확인: 의도한 테넌트 및 환경에 대한 프로비저닝이 성공합니다. 의도한 에이전트에서 기술의 작업을 테스트합니다. 프로비저닝 성공은 런타임 동작을 설정하지 않습니다.

제한

에이전트 도구 키트에서 기술을 디렉터리로 추가하면(사용할 .zip수 없음) 전체 앱 패키지는 10MB로 제한됩니다. 에이전트당 최대 8개의 기술을 추가할 수 있으며, 최대 디렉터리 깊이는 3개, 모든 기술에서 최대 350개의 파일을 추가할 수 있습니다. 전체 지원 매트릭스는 선언적 에이전트의 기술을 참조하세요.

에이전트 게시

ISV(독립 소프트웨어 공급업체)는 기술이 포함된 선언적 에이전트를 Microsoft Marketplace에 제출할 수 있습니다. Work IQ Dev 도구를 사용하여 기존 선언적 에이전트 프로젝트에서 제출 가능한 패키지를 검증하고 빌드합니다. 플러그인 패키지 wiqd publish pc 의 경우 파트너 센터 제품을 만들고, 초안 목록을 채우고, 패키지 및 이미지를 업로드하고, 별도의 인증을 통해 인증을 위해 제출하고, 상태를 추적할 수 있습니다. 파트너 센터 계정 등록 및 확인은 포털 단계로 유지되며 Microsoft가 인증 및 게시를 제어합니다.

필수 구성 요소, 패키지 유효성 검사, 목록 설정, 제출 및 상태 추적을 위해 WIQD를 사용하여 파트너 센터에 게시하는 단계를 따르세요. 포털 제출은 여전히 대안으로 남아 있습니다. Microsoft Marketplace 제출 가이드를 참조하세요. Office 추가 기능 예제나 구성된 플러그인에 대한 가정된 제안 유형이 아닌 확인된 에이전트 제출 경로를 따르세요.

다음 단계

패키지 를 입력& 사용하여 구성요소를 통합하고 테스트합니다. 에이전트를 공개적으로 배포할 준비가 되면 Microsoft Marketplace를 통해 게시를 계속합니다.