プラグイン コンポーネントの統合とテスト

パッケージとテストにより、作業コンポーネントがテスト済みのリリース成果物になります。 次の順序で作業を完了してください。

手順 確認する内容 次の文字で始めることができない
機能の統合 完成したコンポーネントは、意図した開発環境またはテスト環境で連携して動作します。 この記事
パッケージを作成する サポートされている 1 つのパッケージ化ルートでは、リリースする予定の正確なバージョン固定成果物が生成されます。 プラグイン パッケージの作成
パッケージの検証とテスト 正確な成果物は、パッケージの検証に合格し、正常にインストールされ、すべての要求された Microsoft エクスペリエンスで機能します。 パッケージの検証とテスト
必要に応じてエージェントの品質を評価する デプロイされたエージェントは、リリースの応答品質基準を満たしています。 エージェント評価の概要

この記事では、最初の手順について説明します。 最終的なパッケージはテストされません。 パッケージの検証とインストールプラグインのテストは、成果物の作成後に開始されます。

テスト環境を準備する

テスト前:

  • すべてのコンポーネントの意図したバージョンを使用します。
  • 開発 ID、アクセス許可、同意、接続を構成します。
  • 開発環境またはテスト環境で必要なリモート サービスを開始または使用可能にします。
  • 対象ユーザーとテスト アカウントが目的の Microsoft エクスペリエンスにアクセスできることを確認します。
  • 運用環境の秘密や不要な個人情報を公開しない、代表的なテスト データを使用します。
  • 各シナリオで予想される結果、環境、所有者、必要な証拠を記録します。

統合されたシナリオでコンポーネントを確認する

コンポーネント 統合のチェック
宣言型エージェント ID、指示、会話のきっかけ、知識、機能の選択、応答、境界、サポートされていないプロンプト
スキル 検出または添付ファイル、命令、リソース、スクリプト、入力、出力、サポートされていない要求、および失敗
Connector 認証、スキーマ、インデックス作成または取得、鮮度、セキュリティ トリミング、アクセス許可、更新、削除、およびソース エラー
MCP サーバー ツールまたはリソースの検出、認証、入力、構造化された結果、確認、エラー、タイムアウト、可用性、ログ

該当する製品固有のテスト ガイダンスを使用します。

Work IQ DevUI は、選択したプラグイン、取得、引用、リクエスト識別子、生の結果を表示できるプレビューのブラウザーベースのデバッグ サーフェスです。 WIQD Work IQ コマンドは試験的であり、展開された宣言型エージェントを一覧表示したり、エージェント ID または名前でテスト プロンプトを送信したりできます。 これらのルートは、デプロイされた宣言型エージェントをテストします。パッケージの検証や、最終的にインストールされたプラグインのテストに代わるものではありません。

完全なユーザー シナリオをテストする

個々の機能のみをテストするのではなく、ソリューション概要からエンドツーエンドのシナリオをテストします。

  1. 代表的なユーザー プロンプトまたはタスクから始めます。
  2. 目的のエージェントまたは Microsoft エクスペリエンスが要求を処理していることを確認します。
  3. 正しいスキル、コネクタ、アクション、または MCP ツールが選択されていることを確認します。
  4. 認証、同意、確認、およびアクセス許可の動作を確認します。
  5. コンポーネントが意図した入力を受信し、期待どおりの結果を返すことを確認します。
  6. 最終的な応答が正確で、有用で、理解しやすいものであることを確認します。
  7. ログと診断によって、関係するコンポーネントが特定されていることを確認します。

Microsoft 365 Copilotでテストするときは、Copilot Chatに-developer onを入力して、エージェントのメタデータとアクションの選択を検査できます。 終了したら -developer off を入力します。

テストの失敗と境界

次の内容を含めます。

  • 認証が見つからないか、期限切れになっています。
  • アクセス許可が不十分であるか、同意が拒否されました。
  • データ、接続、API、またはリモート サービスが使用できません。
  • 無効、あいまい、またはサポートされていないユーザー入力。
  • 空、部分的、遅延、または誤った形式の結果。
  • タイムアウト、調整、再試行の動作。
  • ユーザーのアクセス許可外でデータにアクセスしようとします。
  • サポートされていない操作を防止またはリダイレクトする命令。

サイレント フォールバックを成功として扱わないでください。 ユーザーとサポート チームは、何が失敗し、どのアクションが必要かを理解できる必要があります。

統合結果を記録する

すべてのテスト シナリオで、以下を記録します。

  • マイクロソフトの経験を背景にしています。
  • コンポーネントとサービスのバージョン。
  • ID、アクセス許可、接続構成。
  • 予想される結果と実際の結果。
  • ログまたは証拠。
  • 既知の制限、所有者、解決策または受け入れの決定。

パッケージの作成者が使用する必要がある正確なファイル、構成、エンドポイント、コンポーネントのバージョン、所有者、証拠を記録します。

パッケージ化の準備状況を確認する

統合テストは、次の場合に完了します。

  • 必要なすべてのコンポーネントは、構築、構成、拡張、または再利用されます。
  • すべてのコンポーネントは、開発環境またはテスト環境で独立して動作します。
  • これらのコンポーネントは、エンド ツー エンドのシナリオで連携して動作します。
  • 必要な ID、アクセス許可、接続、データ、サービスが利用可能です。
  • 予期される認証、確認、エラー、および失敗の動作が実装されています。
  • コンポーネントの所有権、依存関係、バージョン、制限事項、サポート責任が文書化されています。
  • 実装ファイルと構成が特定され、アセンブルする準備が整います。
  • パッケージの作成を妨げる未解決の実装ブロッカーはありません。

プラグインのパッケージ化を続行します。