Microsoft 365 Copilot용 플러그 인 패키징

테스트 및 릴리스하려는 정확한 버전이 있는 플러그인 패키지를 만듭니다. 이 단계는 플러그 인의 구성 요소가 의도된 개발 또는 테스트 환경에서 함께 작동한 후에 수행됩니다.

중요

.zip 파일은 자동으로 지원되는 플러그 인 패키지가 아닙니다. 패키징 경로는 플러그 인의 구성 요소와 게시하려는 Microsoft 365 환경을 지원하는 경우에만 사용합니다.

이 문서에서는 문서화된 Copilot Cowork 플러그 인 워크플로에서 사용하는 Microsoft 365 앱 패키지에 대해 설명합니다. 일부 도구는 패키지를 자동으로 생성합니다. 다른 워크플로에서는 수동으로 어셈블할 수 있습니다. 지원되는 구성 요소, 매니페스트 버전 및 게시 경로에 대해 선택한 제품의 지침을 사용합니다. 공유 패키지 형식이 모든 제품에서 동일한 기능을 지원한다고 보장하지는 않습니다.

원격 MCP 서버, API 및 기타 연결된 서비스는 별도로 실행됩니다. 패키지에는 실행 중인 서비스가 아니라 연결하는 데 필요한 지원되는 선언 또는 참조가 포함되어 있습니다.

시작하기 전에

통합 테스트를 완료합니다. 다음 사항을 확인합니다.

  • 구성 요소를 개별적으로 또는 함께 빌드하고 테스트했습니다.
  • 종속성, 인증, 권한, 연결, 엔드포인트 및 외부 서비스를 구성했습니다.
  • 플러그 인이 지원해야 하는 Microsoft 365 환경을 알고 있습니다.
  • 구성 요소 버전, 알려진 제한 사항 및 해결되지 않은 문제를 기록했습니다.

패키징을 사용하여 미완성 구성 요소 또는 통합을 resolve 사용하지 마세요. 빌드로 돌아가거나 필요한 구성 요소가 작동하지 않는 경우 다시 사용합니다 .

Microsoft 365 앱 패키지 이해

패키지는 루트에 참조된 아이콘이 있는 manifest.json ZIP 파일입니다. Microsoft 365 앱 매니페스트 스키마는 해당 ID, 메타데이터 및 기능 선언을 정의합니다.

패키지 내용물 용도
manifest.json 앱, 버전, 개발자, 이름, 설명, 아이콘 및 지원되는 기능을 식별합니다.
아이콘 앱 매니페스트에서 참조하는 색 및 윤곽선 이미지 파일입니다. Cowork 워크플로 문서 color.png 및 outline.png.
에이전트 기술 스킬 폴더가 포함되어 있는 경우, 지원 파일이 포함되어 SKILL.md 있습니다. 앱 매니페스트는 를 통해 agentSkills폴더를 참조합니다.
원격 커넥터 구성 포함된 agentConnectors 경우 앱 매니페스트의 항목은 원격 MCP 엔드포인트 및 해당 권한 부여 구성을 식별합니다. 서버 자체는 패키지되지 않았습니다.
참조된 구성 요소 파일 커넥터 구성이 하나를 참조할 때 도구 설명 파일 또는 지원되는 에이전트 패키지의 에이전트 정의와 같이 선택한 구성 요소에 필요한 파일을 포함합니다.

예를 들어 Cowork 설명서에는 다음 레이아웃의 패키지가 표시됩니다.

manifest.json
color.png
outline.png
skills/
  contract-analysis/
    SKILL.md
    references/
      clause-taxonomy.md
tools/
  contoso-legal-tools.json

기술 폴더는 플러그인에 기술이 포함된 경우에만 표시됩니다. 도구 설명 파일은 커넥터 구성에서 참조할 때만 필요합니다. 예제를 모든 제품에 대한 템플릿으로 취급하는 대신 현재 파일, 스키마 버전, 아이콘 및 기술 요구 사항에 대해 Copilot Cowork용 빌드 플러그 인을 따르세요.

참고

플러그 인 매니페스트 스키마 2.4는 외부 Microsoft 365 앱 패키지가 아닌 선언적 에이전트에 대한 API 또는 MCP 작업 구성 요소를 설명합니다. 이러한 작업은 포함하는 에이전트만 사용할 수 있습니다. 외부 패키지에 대한 앱 매니페스트 스키마를 사용합니다.

지원되는 패키징 경로 선택

플러그인 패키지 경로 패키지 만들기 결과
Work IQ Dev 도구 플러그인 프로젝트(지원되는 시나리오에 권장되는 프로 코드 경로) 선택한 환경에 대해 문서화된 소스 유효성 검사 및 프로비저닝 단계를 수행한 다음, 을 실행 wiqd plugin package합니다. Work IQ Dev 도구를 사용하여 플러그인 빌드를 참조하십시오. 공유 또는 게시 전에 유효성을 검사할 버전이 있는 앱 패키지입니다.
선택한 워크플로가 플러그 인의 구성 요소 및 대상 환경을 지원하는 경우 Microsoft 365 에이전트 도구 키트로 빌드된 플러그 인 패키지 Zip Teams 앱 패키지를 선택하거나 수명 주기 작업을 사용합니다teamsApp/zipAppPackage. 에이전트 도구 키트에서 앱 매니페스트 사용자 지정을 참조하세요. 지원되는 워크플로에서 생성된 플러그인 패키지입니다.
수동으로 조립한 Cowork 플러그인 패키지 Copilot Cowork용 플러그 인 빌드의 매니페스트, 기술, 커넥터, 아이콘 및 ZIP 레이아웃 지침을 따릅니다. 문서화된 Cowork 경로에 대한 Microsoft 365 앱 패키지입니다.

플러그인의 구성 요소 및 대상 환경을 지원하는 패키징 경로가 없으면 중지합니다. 지원되는 방법을 선택하거나 플러그인을 수정합니다. 지원되지 않는 패키지를 만들기 위해 아티팩트를 결합하거나 이름을 바꾸지 마세요.

Copilot Chat에서 직접 사용하는 기술의 경우 앱 매니페스트의 agentSkills 속성을 통해 플러그 인 수준 기술을 패키지화합니다. 이는 선언적 에이전트 매니페스트의 agent_skills 속성과 다릅니다. Chat에서 허용하는 독립 실행형 SKILL.md 또는 기술 ZIP은 완전한 플러그인 앱 패키지가 아닙니다. 플러그인에서 기술 패키지를 참조하세요.

WIQD 소스 검사, 후보 패키징 및 패키지 우선 유효성 검사를 자동화하려면 Work IQ Dev 도구를 사용하여 플러그인 CI/CD 구성을 참조하십시오.

참고

WIQD 원본 유효성 검사는 빌드된 패키지의 전체 유효성 검사가 아닙니다. 플러그 인 테스트 및 유효성 검사의 현재 패키지 유효성 검사 절차를 사용하여 패키징 후 정확한 ZIP의 유효성을 검사합니다.

패키지 및 해당 종속 요소 식별

릴리스 아티팩트를 어셈블하기 전에 원하는 게시 및 배포 경로를 선택합니다. 모든 경로에 대해 다음을 식별합니다.

  • 아이덴티티: 앱 ID, 패키지 버전 및 구성 요소 식별자입니다.
  • 메타데이터: 이름, 설명, 개발자 정보, 아이콘, 해당 개인 정보 보호 및 약관 링크.
  • 인증: ID 모델, 지원되는 권한 부여 구성, 권한 및 동의 요구 사항 및 자격 증명 참조입니다.
  • 연결: 엔드포인트, 연결 참조 및 환경별 구성입니다.
  • 외부 종속성: 패키지 외부에 필요한 원격 서비스, 데이터 원본, 소유자 및 설정입니다.

패키지에는 스키마 지원 선언 및 참조만 넣습니다. 운영 세부 정보는 게시 준비 레코드에 유지하고 자격 증명이나 비밀은 포함하지 않습니다.

배포 경로 이 패키지에 대해 확인할 사항
테스트를 위해 직접 공유 선택한 대상 그룹, 테스트 환경, 패키지 ID 및 메타데이터, 테스터에게 필요한 인증, 연결 및 외부 서비스입니다.
조직 분포 관리자 검토를 위한 패키지 ID 및 메타데이터와 organization에 필요한 인증, 연결, 권한 및 외부 서비스 설정입니다.
공개 배포 선택한 제출 경로에 대한 패키지 ID 및 메타데이터와 함께 고객 조직 및 사용자가 구성해야 하는 인증, 연결 및 외부 종속성.

패키지를 공유하거나 게시해도 설치, 할당, 동의 또는 연결 설정이 완료되지 않습니다. 선택한 경로의 현재 요구 사항을 따르십시오. 이 문서에서는 제출 계약을 정의하지 않습니다.

패키지 만들기

  1. 선택한 플러그인 경로에 대한 패키징 절차를 엽니다.
  2. 의도한 환경과 테스트한 정확한 구성 요소 버전을 선택합니다.
  3. 문서화된 명령, UI 작업 또는 자동화된 워크플로를 실행합니다.
  4. 아티팩트 이름, 위치, 버전, 환경 및 도구 버전을 기록합니다.

생성된 아티팩트 확인

다음 사항을 확인합니다.

  • 플러그인 ID 및 패키지 버전이 올바른지 확인합니다.
  • 패키지에는 필요한 매니페스트, 메타데이터, 구성 및 자산이 포함되어 있습니다.
  • 구성 요소 선언, 파일, 식별자, 엔드포인트 및 서비스 참조가 테스트한 버전과 일치합니다.
  • 패키지는 의도한 환경 구성을 사용합니다.
  • 인증, 권한, 동의 및 연결 요구 사항은 자격 증명, 토큰 또는 비밀 없이 선언됩니다.
  • 패키지에 임시 파일, 로그, 테스트 데이터 또는 관련 없는 아티팩트가 포함되어 있지 않습니다.

레코드 게시 준비

게시 준비 상태 레코드를 테스트 및 유효성 검사로 가져오고 게시하기 전에 완료합니다. 기록:

  • 패키지 또는 아티팩트 ID 및 정확한 버전입니다.
  • 구성 요소, 원격 서비스 및 외부 참조.
  • 패키징 도구 및 의도된 게시 방법입니다.
  • 테스트된 Microsoft 365 환경 및 환경.
  • 인증, 사용 권한, 동의 및 연결 요구 사항.
  • 검증 증거 및 결과.
  • 알려진 제한 사항, 지원되지 않는 조합 및 허용되는 위험.
  • 릴리스 소유자 및 유효성 검사 날짜입니다.

다음 단계