プラグインを Microsoft 365 Copilot 用にパッケージ化する

テストしてリリースする正確なバージョン管理されたプラグイン パッケージを作成します。 この手順は、プラグインのコンポーネントが目的の開発またはテスト環境で連携した後に行われます。

重要

.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 とメタデータ、および顧客の組織とユーザーが構成する必要がある認証、接続、外部依存関係。

パッケージを共有または公開しても、インストール、割り当て、同意、または接続のセットアップは完了しません。 選択したルートの現在の要件に従ってください。この記事では、提出契約を定義するものではありません。

パッケージを作成する

  1. 選択したプラグイン ルートのパッケージ化手順を開きます。
  2. 目的の環境と、テストした正確なコンポーネント バージョンを選択します。
  3. 文書化されたコマンド、UI アクション、または自動化されたワークフローを実行します。
  4. 成果物名、場所、バージョン、環境、およびツール バージョンを記録します。

生成された成果物を確認する

次の内容を確認する:

  • プラグイン ID とパッケージ バージョンが正しい。
  • パッケージには、必要なマニフェスト、メタデータ、構成、およびアセットが含まれています。
  • コンポーネント宣言、ファイル、識別子、エンドポイント、サービス参照が、テストしたバージョンと一致します。
  • パッケージは意図された環境構成を使用します。
  • 認証、アクセス許可、同意、接続要件は、資格情報、トークン、またはシークレットなしで宣言されます。
  • パッケージには、一時ファイル、ログ、テスト データ、または関連しない成果物は含まれていません。

レコード公開の準備

公開準備レコードを テストと検証に取り込み、公開する前に完了します。 記録:

  • パッケージまたは成果物の ID と正確なバージョン。
  • コンポーネント、リモート サービス、および外部参照。
  • パッケージ化ツールと目的の公開方法。
  • テスト済みの Microsoft 365 エクスペリエンスと環境。
  • 認証、アクセス許可、同意、接続の要件。
  • 検証の証拠と結果。
  • 既知の制限事項、サポートされていない組み合わせ、受け入れられるリスク。
  • リリース所有者と検証日。

次のステップ