테스트 및 릴리스하려는 정확한 버전이 있는 플러그인 패키지를 만듭니다. 이 단계는 플러그 인의 구성 요소가 의도된 개발 또는 테스트 환경에서 함께 작동한 후에 수행됩니다.
중요
.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 및 메타데이터와 함께 고객 조직 및 사용자가 구성해야 하는 인증, 연결 및 외부 종속성. |
패키지를 공유하거나 게시해도 설치, 할당, 동의 또는 연결 설정이 완료되지 않습니다. 선택한 경로의 현재 요구 사항을 따르십시오. 이 문서에서는 제출 계약을 정의하지 않습니다.
패키지 만들기
- 선택한 플러그인 경로에 대한 패키징 절차를 엽니다.
- 의도한 환경과 테스트한 정확한 구성 요소 버전을 선택합니다.
- 문서화된 명령, UI 작업 또는 자동화된 워크플로를 실행합니다.
- 아티팩트 이름, 위치, 버전, 환경 및 도구 버전을 기록합니다.
생성된 아티팩트 확인
다음 사항을 확인합니다.
- 플러그인 ID 및 패키지 버전이 올바른지 확인합니다.
- 패키지에는 필요한 매니페스트, 메타데이터, 구성 및 자산이 포함되어 있습니다.
- 구성 요소 선언, 파일, 식별자, 엔드포인트 및 서비스 참조가 테스트한 버전과 일치합니다.
- 패키지는 의도한 환경 구성을 사용합니다.
- 인증, 권한, 동의 및 연결 요구 사항은 자격 증명, 토큰 또는 비밀 없이 선언됩니다.
- 패키지에 임시 파일, 로그, 테스트 데이터 또는 관련 없는 아티팩트가 포함되어 있지 않습니다.
레코드 게시 준비
게시 준비 상태 레코드를 테스트 및 유효성 검사로 가져오고 게시하기 전에 완료합니다. 기록:
- 패키지 또는 아티팩트 ID 및 정확한 버전입니다.
- 구성 요소, 원격 서비스 및 외부 참조.
- 패키징 도구 및 의도된 게시 방법입니다.
- 테스트된 Microsoft 365 환경 및 환경.
- 인증, 사용 권한, 동의 및 연결 요구 사항.
- 검증 증거 및 결과.
- 알려진 제한 사항, 지원되지 않는 조합 및 허용되는 위험.
- 릴리스 소유자 및 유효성 검사 날짜입니다.