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

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

重要

.zip ファイルは、自動的にサポートされているプラグイン パッケージではありません。 パッケージ化ルートは、プラグインのコンポーネントと、公開する予定の Microsoft 365 エクスペリエンスをサポートしている場合にのみ使用してください。

パッケージ化はツール固有です。 プラグイン パッケージを自動的に作成するツールもあれば、マニフェスト、メタデータ、構成、アセットをアセンブルする必要があるツールもあります。 パッケージは、リモート MCP サーバー、API、コネクタ サービス、およびその他の外部サービスを参照しており、それらを物理的に含めるのではありません。

開始する前に

統合テストを完了します。 次の内容を確認します。

  • コンポーネントは個別に構築およびテストされます。
  • 依存関係、認証、アクセス許可、接続、エンドポイント、および外部サービスが構成されます。
  • プラグインがサポートする必要がある Microsoft 365 エクスペリエンスがわかっている。
  • コンポーネントのバージョン、既知の制限事項、未解決の問題が記録されます。

未完成のコンポーネントまたは統合を解決するためにパッケージ化を使用しないでください。 必要なコンポーネントが機能しない場合は、 ビルドに戻るか再利用 します。

パッケージ化パスを選択する

プラグイン パッケージのルート パッケージを作成する 結果
サポートされているエージェント、スキル、またはリモート MCP コネクタを作成するアルファ WIQD プラグイン プロジェクト wiqd plugin validate を実行し、選択した環境をプロビジョニングしてパッケージ ID をバインドしてから、wiqd plugin packageを実行します。 次の手順でビルドされたパッケージを詳細に検証します。 「 Work IQ Dev Toolsを使用してプラグインを構築する」を参照してください。 共有または管理者アップロードをサポートするための展開可能な .zip 。
Microsoft 365 Agents Toolkit を使用してビルドされたプラグイン パッケージ。選択したワークフローがプラグインのコンポーネントとターゲット エクスペリエンスをサポートしている場合 Zip Teams アプリ パッケージを選択するか、teamsApp/zipAppPackage ライフサイクル アクションを使用します。 Agents Toolkit でのアプリ マニフェストのカスタマイズを参照してください。 サポートされているワークフローによって生成されたプラグイン パッケージ。
別のプラグイン固有のワークフローでサポートされているプラグイン パッケージ そのパッケージの文書化されたコマンド、UI アクション、または自動化されたワークフローに従います。 その手順で識別されるインストール可能なプラグイン パッケージ。

プラグインのコンポーネントとターゲット エクスペリエンスをサポートするパッケージ化ルートがない場合は、停止します。 サポートされているメソッドを選択するか、プラグインを変更します。 アーティファクトを結合または名前変更して、サポートされていないパッケージを作成しないでください。

注:

静的 wiqd plugin validate は、宣言型エージェント サーフェイスと参照される API プラグインまたは OpenAPI ファイルのみをチェックします。 スキルのみまたはコネクタのみのプラグインは、トップレベルの機能が検証されずに静的チェックに合格できます。 ビルドされたアプリ パッケージをチェックするには、パッケージ優先の詳細な検証が必要です。

パッケージを作成する

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

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

次の内容を確認する:

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

レコード公開の準備

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

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

次へ: プラグインのテストと検証

引き続き、正確なプラグイン パッケージの検証とテストを行います。 該当するパッケージ、インストール、アクセス、シナリオ、エクスペリエンス、および必要な評価チェックに合格するまで、公開しないでください。