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

テストしてリリースする正確なバージョン管理された成果物を作成します。 これは、完成したコンポーネントが目的の開発環境またはテスト環境で連携した後の、パッケージ化とテストの 2 番目のステップです。

重要

エージェントまたは Microsoft 365 アプリ用に生成された .zip は、自動的にすべてのコンポーネントの組み合わせに対応するプラグイン パッケージになるわけではありません。 ルートは、公開するコンポーネントと Microsoft 365 エクスペリエンスをサポートしている場合にのみ使用してください。

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

開始する前に

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

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

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

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

何を構築しましたか? パッケージを作成する 結果
Work IQ 開発ツールでサポートされる宣言型エージェント プロジェクト 静的プロジェクトの検証のために wiqd agent validate を実行してから、 wiqd agent package を実行します。 次の手順で、解決されたパッケージを詳細に検証します。 サイドローディングまたはアップロード用の配置可能な .zip 。
サポートされているエージェント、スキル、またはリモート MCP コネクタを作成するアルファ WIQD プラグイン プロジェクト wiqd plugin validate を実行し、選択した環境をプロビジョニングしてパッケージ ID をバインドしてから、wiqd plugin packageを実行します。 次の手順でビルドされたパッケージを詳細に検証します。 「 Work IQ Dev Toolsを使用してプラグインを構築する」を参照してください。 共有または管理者アップロードをサポートするための展開可能な .zip 。
Microsoft 365 Agents Toolkit でビルドされたサポートされている Microsoft 365 アプリマニフェスト プロジェクト Zip Teams アプリ パッケージを選択するか、teamsApp/zipAppPackage ライフサイクル アクションを使用します。 Agents Toolkit でのアプリ マニフェストのカスタマイズを参照してください。 appPackage/build/appPackage.<environment>.zip.
Copilot Studio で作成された Microsoft 365 Copilot のエージェント [ 公開] を選択し、可用性オプションから [ .zipとしてダウンロード ] を使用します。 「Microsoft 365 Copilot のエージェントを発行して構成する」を参照してください。 手動でアップロードまたは管理者に送信するための .zip 。
別のプラグイン固有のワークフローでサポートされているコンポーネント 文書化されたコマンド、UI アクション、または自動化されたワークフローに従います。 その手順で識別されたインストール可能な成果物。

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

注:

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

パッケージを作成する

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

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

次の内容を確認する:

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

レコード公開の準備

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

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

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

引き続き、 正確なパッケージの検証とテストを行います。 該当するパッケージ、インストール、アクセス、シナリオ、エクスペリエンス、エージェントの品質チェックに合格するまで、成果物を公開しないでください。