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