テストしてリリースする正確なバージョン管理されたプラグイン パッケージを作成します。 この手順は、プラグインのコンポーネントが目的の開発またはテスト環境で連携した後に行われます。
重要
.zip ファイルは、自動的にサポートされているプラグイン パッケージではありません。 パッケージ化ルートは、プラグインのコンポーネントと、公開する予定の Microsoft 365 エクスペリエンスをサポートしている場合にのみ使用してください。
この記事では、文書化された Copilot Cowork プラグイン ワークフローで使用される Microsoft 365 アプリ パッケージについて説明します。 一部のツールはパッケージを作成します。他のワークフローでは、手動で組み立てることができます。 サポートされているコンポーネント、マニフェスト バージョン、公開ルートについては、選択した製品のガイダンスを使用してください。 共有パッケージ形式では、すべての製品が同じ機能をサポートすることが保証されるわけではありません。
リモート MCP サーバー、API、およびその他の接続されたサービスは個別に実行されます。 パッケージには、実行中のサービスではなく、接続するために必要なサポートされている宣言または参照が含まれています。
始める前に
統合テストを完了します。 次の内容を確認します。
- コンポーネントを個別に構築し、一緒にテストしました。
- 依存関係、認証、アクセス許可、接続、エンドポイント、および外部サービスを構成しました。
- プラグインがサポートする必要がある Microsoft 365 エクスペリエンスがわかっている。
- コンポーネントのバージョン、既知の制限事項、未解決の問題を記録しました。
未完成のコンポーネントまたは統合を解決するためにパッケージ化を使用しないでください。 必要なコンポーネントが機能しない場合は、 ビルドに戻るか再利用 します。
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 Tools プラグイン プロジェクト (サポートされているシナリオに推奨されるプロコード ルート) | 選択した環境に対して、文書化されたソース検証とプロビジョニングの手順に従ってから、 wiqd plugin package を実行します。 「 Work IQ Dev Toolsを使用してプラグインを構築する」を参照してください。 |
共有または公開前に検証するバージョン管理されたアプリ パッケージ。 |
| Microsoft 365 Agents Toolkit を使用してビルドされたプラグイン パッケージ。選択したワークフローがプラグインのコンポーネントとターゲット エクスペリエンスをサポートしている場合 |
Zip Teams アプリ パッケージを選択するか、teamsApp/zipAppPackage ライフサイクル アクションを使用します。
Agents Toolkit でのアプリ マニフェストのカスタマイズを参照してください。 |
サポートされているワークフローによって生成されたプラグイン パッケージ。 |
| 手動で組み立てた Cowork プラグイン パッケージ | 「Copilot Cowork プラグインのビルド」のマニフェスト、スキル、コネクタ、アイコン、ZIP レイアウトの指示に従います。 | 文書化された Cowork ルート用の Microsoft 365 アプリ パッケージ。 |
プラグインのコンポーネントとターゲット エクスペリエンスをサポートするパッケージ化ルートがない場合は、停止します。 サポートされているメソッドを選択するか、プラグインを変更します。 アーティファクトを結合または名前変更して、サポートされていないパッケージを作成しないでください。
Copilot Chat で直接使用するスキルの場合は、アプリ マニフェストの agentSkills プロパティを通じてプラグイン レベルのスキルをパッケージ化します。 これは、宣言型エージェント マニフェストの agent_skills プロパティとは異なります。 Chat が受け入れるスタンドアロンのSKILL.mdまたはスキル ZIP は、完全なプラグイン アプリ パッケージではありません。 プラグイン でスキルをパッケージ化するを参照してください。
WIQD ソース チェック、候補パッケージ化、パッケージ優先検証を自動化するには、「 Work IQ 開発ツールを使用したプラグイン CI/CD の構成」を参照してください。
注
WIQD ソースの検証は、ビルドされたパッケージの完全な検証ではありません。 プラグインの テストと検証の現在のパッケージ検証手順を使用して、パッケージ化後に正確な ZIP を検証します。
パッケージとその依存関係を識別する
リリース成果物をアセンブルする前に、目的の 公開および配布ルート を選択します。 すべてのルートで、次を特定します。
- ID: アプリ ID、パッケージ バージョン、コンポーネント識別子。
- メタデータ: 名前、説明、開発者情報、アイコン、該当するプライバシーと条件のリンク。
- 認証: ID モデル、サポートされている承認構成、アクセス許可と同意のニーズ、資格情報の参照。
- 接続: エンドポイント、接続参照、および環境固有の構成。
- 外部依存関係: パッケージ外で必要なリモート サービス、データ ソース、所有者、セットアップ。
スキーマでサポートされている宣言と参照のみをパッケージに入れます。 操作の詳細を公開準備レコードに保持し、資格情報やシークレットを含めないようにします。
| 配布ルート | このパッケージで確認すること |
|---|---|
| テスト用の直接共有 | 選択した対象ユーザー、テスト環境、パッケージ ID とメタデータ、およびそれらのテスターに必要な認証、接続、外部サービス。 |
| 組織の分布 | 管理者レビュー用のパッケージ ID とメタデータに加え、認証、接続、アクセス許可、および organization で必要な外部サービスのセットアップ。 |
| パブリック配布 | 選択した送信ルートのパッケージ ID とメタデータ、および顧客の組織とユーザーが構成する必要がある認証、接続、外部依存関係。 |
パッケージを共有または公開しても、インストール、割り当て、同意、または接続のセットアップは完了しません。 選択したルートの現在の要件に従ってください。この記事では、提出契約を定義するものではありません。
パッケージを作成する
- 選択したプラグイン ルートのパッケージ化手順を開きます。
- 目的の環境と、テストした正確なコンポーネント バージョンを選択します。
- 文書化されたコマンド、UI アクション、または自動化されたワークフローを実行します。
- 成果物名、場所、バージョン、環境、およびツール バージョンを記録します。
生成された成果物を確認する
次の内容を確認する:
- プラグイン ID とパッケージ バージョンが正しい。
- パッケージには、必要なマニフェスト、メタデータ、構成、およびアセットが含まれています。
- コンポーネント宣言、ファイル、識別子、エンドポイント、サービス参照が、テストしたバージョンと一致します。
- パッケージは意図された環境構成を使用します。
- 認証、アクセス許可、同意、接続要件は、資格情報、トークン、またはシークレットなしで宣言されます。
- パッケージには、一時ファイル、ログ、テスト データ、または関連しない成果物は含まれていません。
レコード公開の準備
公開準備レコードを テストと検証に取り込み、公開する前に完了します。 記録:
- パッケージまたは成果物の ID と正確なバージョン。
- コンポーネント、リモート サービス、および外部参照。
- パッケージ化ツールと目的の公開方法。
- テスト済みの Microsoft 365 エクスペリエンスと環境。
- 認証、アクセス許可、同意、接続の要件。
- 検証の証拠と結果。
- 既知の制限事項、サポートされていない組み合わせ、受け入れられるリスク。
- リリース所有者と検証日。