プラグインのパッケージで作成した正確なバージョン管理された成果物を検証してテストします。 これはパッケージ化とテストの 3 番目の手順です。パッケージの検証、インストール、アクセス、動作、サポートされている Microsoft 365 エクスペリエンスの確認を行います。
プラグインによって参照されるコンポーネントと外部サービスは、既に個別に連携して動作している必要があります。 この記事では、パッケージ化されたプラグインをテストします。コンポーネント レベルのテストや認証に代わるものではありません。
重要
公開する成果物を正確に使用します。 パッケージ化ルートが意図したコンポーネントとターゲット エクスペリエンスをサポートしていない場合は、 プラグインのパッケージ化 に戻り、サポートされているルートを選択してください。
開始する前に
準備:
- リリースする予定の正確なバージョン固定プラグイン パッケージ。
- パッケージ化ルートのインストールまたはサイドローディング手順。
- 必要なアクセス権を持つテスト環境と ID。
- 各ターゲット Microsoft 365 エクスペリエンスの代表的なシナリオと期待される結果。
パッケージを検証する
パッケージ化ルートの検証手順を使用します。
| パッケージ化ルート | 検証手順 |
|---|---|
| Work IQ 開発ツール | パッケージを作成したら、 wiqd agent validate --mode deep を使用して解決済みのアプリ パッケージを検証します。 自動化されたワークフローでは、プロセス終了コードだけに依存するのではなく、JSON data.valid 結果を調べます。
「検証と Microsoft 検証レイヤー」を参照してください。 |
| Alpha WIQD プラグイン パッケージ |
wiqd plugin package によって成果物が作成されたら、wiqd plugin validate --mode deep を実行します。 このパッケージ優先検証では、静的プラグイン検証ではカバーされないトップレベルのアプリ マニフェスト、スキル、リモート MCP コネクタがチェックされます。 自動化されたワークフローでは、プロセス終了コードだけに依存するのではなく、構造化された検証結果を検査します。 「 Work IQ Dev Toolsを使用してプラグインを構築する」を参照してください。 |
| Microsoft 365 Agents Toolkit | Use Validate app package using validation rules or run atk validate --app-package-file-path <path>. 「 アプリの検証」を参照してください。 |
| Copilot Studio |
.zipをダウンロードする前に、公開と構成ワークフローを完了し、エラーを解決します。 |
| 別のプラグイン固有のワークフロー | そのパッケージ タイプについて記載されている検証手順に従います。 |
生成されたアーティファクトが、そのパッケージ タイプに対して定義された要件を満たし、目的の ID、バージョン、環境を使用し、資格情報、シークレット、テスト データ、ログ、または無関係なファイルが含まれていないことを確認します。
パッケージ エラーを修正し、新しいパッケージ バージョンを作成し、インストールする前に検証を繰り返します。
パッケージをインストールまたはサイドロードする
- パッケージ化ルートのインストールまたはサイドローディング手順を使用します。
- パッケージ検証に成功した成果物を正確にインストールします。
- アーティファクトのバージョン、テスト環境、ID、およびインストール結果を記録します。
- インストールされているプラグインと予期されるコンポーネントが認識されていることを確認します。
インストールに失敗した場合は、パッケージを修正し、新しいバージョンを作成して再インストールし、再テストします。
パッケージ化されたプラグインをテストする
- インストールされたプラグインを使用して、完全なユーザー シナリオを実行します。
- 期待されるコンポーネントが読み込まれ、正しいコンポーネントが選択されていることを確認します。
- プラグインがサポートするコンポーネントと Microsoft 365 エクスペリエンスに必要な成功、失敗、回復のシナリオをテストします。
- 各シナリオの予想される結果と実際の結果を記録します。
コンポーネントが独自の要件を満たしていない場合は、そのビルドまたはコンポーネント検証のガイダンスに戻ります。 コンポーネントの失敗をプラグイン パッケージの成功として再定義しないでください。
認証とアクセスのテスト
テスト:
- サインイン、同意、トークンの更新、再接続。
- アクセスが拒否された、十分なアクセス許可がない、接続がない、サービスを利用できない。
- ユーザーのアクセス許可外のデータとアクション。
テストされた ID、アクセス許可、認証、同意、接続、エンドポイント、サービスのバージョンを記録します。
サポートされているエクスペリエンスをテストする
サポートするすべての Microsoft 365 エクスペリエンスにパッケージをインストールしてテストします。 あるエクスペリエンスのサポートを別のエクスペリエンスの結果から推測しないでください。
リリースのエクスペリエンス、環境、制限事項、サポートされていない組み合わせ、受け入れられたリスクを記録します。
必要に応じてエージェントの品質を評価する
パッケージにエージェントが含まれており、エージェント品質評価がリリース基準の一部である場合は、展開された正確なバージョンを評価し、結果を公開準備レコードに追加します。 エージェント評価の概要から始めます。
エージェント評価は、応答の品質と回帰を測定します。 パッケージの検証、インストール テスト、アクセス テスト、またはサポートされている各 Microsoft エクスペリエンスでのテストに代わるものではありません。
リリース準備の決定
1 つの結果を代入する:
- 準備完了 - 正確なプラグイン パッケージは、必要なすべてのチェックに合格し、未解決のリリース ブロッカーはありません。
- ブロック - パッケージ、参照、アクセス、互換性、またはランタイムの障害により、公開が妨げられます。
- 制限付き準備完了 - 必要なチェックに合格し、残りの制限が文書化され、受け入れられ、公開プロセスでの開示に適しています。
ブロック エラーごとに、所有者と必要な解決策を記録します。 問題を修正し、プラグインを再パッケージ化し、新しい成果物を再インストールし、影響を受けるテストを繰り返します。
この正確な成果物が、必要なパッケージ、インストール、アクセス、シナリオ、エクスペリエンス、および該当するエージェント品質チェックに合格した場合にのみ、プラグインを公開する準備が整います。
プラグイン の発行と配布を続行します。