プラグイン コンポーネントを一緒にテストする

プラグイン パッケージに含まれているものや参照文字列 (スキル、リモート MCP コネクタ、宣言型エージェントが含まれている場合) をテストします。 この パッケージ & テスト タスクは、リリースアーティファクトを作成する前にコンポーネントの動作と統合を確立します。 パッケージの最終的な検証、インストール、リリース エクスペリエンスのチェックは、「 プラグインのテストと検証」で行われます。 コンポーネントのテストを選択し、 テスト レコードを保持してから、 パッケージ化する前に完了します。

テストの選択

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

プラグインで でテストする セクション
エージェントの有無にかかわらず、プラグイン レベルのスキル Cowork 開発セッション。Chat スキルの選択をサポート スキルのテスト
リモート MCP サーバーを指すプラグイン コネクタ インスペクターを選択し、Cowork のプラグインを使用して同じタスクを実行します リモート MCP コネクタのテスト
宣言型エージェント (含まれている場合) Work IQ Dev Tools askコマンドとDevUI 含まれている宣言型エージェントをテストする
ソリューションで使用される依存関係 コネクタの診断を行った後、統合されたタスクを繰り返す 依存関係のテスト

テストしているコネクタを確認する

  • プラグイン コネクタ: アプリ マニフェスト agentConnectors[] エントリ。 この記事では、リモート MCP の種類をテストします。パッケージはサーバーを参照します。実行中のサービスは含まれません。
  • Copilot コネクタ (同期済み): Microsoft Graph にナレッジを取り込みます。 その取り込みとその後の取得を依存関係としてテストします。
  • Copilot コネクタ (フェデレーション): 接続された ID でライブ データを取得します。 ライブ アクセスは取り込みとは別にテストします。
  • Power Platform コネクタ:Copilot Studio ツール。 テストしても、そのエージェントがレジストリ プラグインであることは確認されません。

プラグイン作成リファレンスには、既存の OpenAPI カスタムコネクタリファレンスの明示的なルートも記載されています。 該当する場合は、そのルートの要件を使用します。この記事の MCP 手順では、そのコネクタの種類はテストされません。

結果の判定方法

各コンポーネントを個別にチェックしてから、それらのコンポーネントを一緒に使用するタスクを実行します。 直接サービス呼び出しが成功すると、サーバーの動作が確立されます。 統合タスクは、返されたデータの選択、入力、認証、および使用を確立します。

テストの前に、各コンポーネントとターゲットのエクスペリエンスに必要なチェックと許容される証拠を定義します。 コンポーネントの選択、正しい結果、アクセス境界を含めます。 主張にふさわしい証拠を使用する:

コンポーネントまたは要求 保持する証拠
スキルの選択と動作 選択または読み込まれたスキルに加えて、必要な出力とファイルを識別するホスト証拠。 Cowork のサイド パネルの[スキル] は、読み込まれたスキルを識別します。 明示的な選択では、自動呼び出しは確立されません。
リモート MCP 呼び出し 認証されたサービス ログはホスト要求と関連付けられ、操作、入力、結果を識別します。 直接 Inspector 呼び出しでは、プラグインを介した呼び出しは確立されません。
含まれているエージェント エージェント ID、要求と応答、および利用可能な機能の選択、取得、引用診断が展開されました。 エージェント診断だけでは、含まれるすべてのスキルまたはスクリプトの呼び出しが確立されるわけではありません。
スキル スクリプトの実行 公開されたときの実行診断。 必要な出力ファイルによって出力結果が確立されますが、特定のスクリプトが実行されたことを証明するものではありません。 そのスクリプトの実行がリリース要件である場合は、それを立証する証拠を入手します。
  • 呼び出しの証拠とは別に応答の正しさを判断します。 エージェントは、スキルをロードすることなく、もっともらしいリリースノートを作成できます。
  • 必要なチェックの証拠が見つからない場合は未確認のままとなり、準備がブロックされます。 診断が利用できないからといって、必要なチェックを弱めないでください。
  • ホストが追加の診断の詳細を公開しない場合は、詳細が検証されたと主張せずにその制限を記録します。 エビデンスがすでに必要なチェックを満たしている場合、利用できない診断は別のブロッカーにはなりません。
  • サイレント フォールバックまたは不完全な結果は失敗として扱います。
  • 認証情報ではなく、認証されたストレージにサニタイズされた証拠を保存します。 エージェントのスナップショットには、機密性の高いコンテンツを含めることができます。

前提条件と既知のテスト データ

既存のプラグイン プロジェクト、開発テナント、既知のテスト ID、および非運用データを使用します。 サポートする環境と Microsoft エクスペリエンスを選択します。 テストの前に、必要なサインイン、同意、接続、外部サービスを承認します。

次のコマンドを実行するには、 Work IQ Dev Tools をインストールします。 CLI には Node.js 24.15+ と npm が必要であり、Windows では PowerShell 7+ が必要です。

準備:

  • 既知のレコード: ソースから記録された正確なタイトル、状態、URL を含むテスト リポジトリの問題 123。
  • スキル入力:Added CSV export; Fixed duplicate rows; Updated help text. リリースノートのスキルについては、それぞれ機能、修正プログラム、その他に加えて、約束されたファイルまたはスクリプトによって生成されたコンテンツを期待してください。

例の名前、ID、プレースホルダーを置き換えます。 テナント コマンドの前にサインインして準備状況をチェックします。

wiqd auth login --interactive
wiqd doctor

確認:目的のテナントのサインインと準備チェックが成功します。

オプションのアシスタント プロンプトについては、GitHub Copilot CLI をインストールします。 WIQD ガイド プラグインがまだインストールされていない場合は、次のコマンドを実行し、既存のプラグイン プロジェクトで新しいセッションを開始します。

copilot plugin install wiqd@awesome-copilot
copilot plugin list --json
copilot

確認:インベントリには、インストールされ、有効になっている WIQD ガイドが表示されます。 既存のインストールは、重複を追加するのではなく、インストール ガイドに従う必要があります。 このガイド プラグインでは、WIQD CLI はインストールされません。 アシスタントプロンプトをコーディングアシスタントセッションに貼り付けます。代わりに、デプロイされたエージェント要求は、含まれている宣言型エージェントをテストする-qオプションを使用します。

スキルのテスト

プラグイン コンポーネント: アプリのマニフェスト agentSkillsを通じて登録されたプラグイン レベルのスキル。

これが証明すること: 対象のスキルは、開発デプロイメントで期待されるアウトプットを読み込み、生成します。

パッケージ化後にまだ証明する必要があります: 正確なアーティファクトが検証され、配布ルートを通じてインストールされ、要求されているすべてのエクスペリエンスで実行されます。

保持する証拠: デプロイ/バージョン、読み込まれたスキル、入力ファイル、出力ファイル、使用可能なリモート通話ログ。

開発展開には Copilot Cowork を使用します。 使用可能な場合は、実際に印刷されたインストール/テスト リンクを再利用します。

  1. プロビジョニングが必要な場合は、まず、構成されたenvironmentFolderPathで m365agents.yml と選択した環境ファイルを調べます。 テナントと有効な AGENT_SCOPEを確認します。標準スキャフォールドでは、個人用スコープには local を使用し、共有スコープには dev を使用しますが、名前だけでは証明できません。 提案された変更を承認してから、次を実行します。

    wiqd plugin provision --env "<test-environment>"
    

    確認:プロビジョニングが成功し、デプロイのインストール/テスト リンクを返します。

  2. 返されたリンクを開き、インストールとテスト ID を使用して必要な接続を完了します。 Cowork セッションを開始し、既知の入力を使用してリリース ノートをリクエストします。

    確認:スキルは、セッション サイド パネルの [スキル] の下に表示されます。

  3. 応答と [出力フォルダー>プレビュー ] または [ダウンロード] の下にあるファイルを調べます。

    確認:すべての変更は意図したカテゴリに表示され、promised ファイルは要件に一致します。

  4. このデプロイと既知の入力を使用して、サポートされている各エクスペリエンスで 検出テストと呼び出しテスト を実行します。

    確認:検出、選択、および失敗の動作は、そのエクスペリエンスに対するスキルの要件を満たしています。

個人的にアップロードされたスキルは、プラグインの agentSkills とは異なる登録をテストします。代わりに、エージェント添付スキルは宣言型エージェント マニフェストで agent_skills を使用します。 ロードされたスキルの証拠は、スクリプトごとの実行を確立しません。

文書化されたライフサイクルでは、プロビジョニングによって、選択したスコープ内でテナント展開が作成または更新され、環境バインドが書き込まれます。 既存のリソース ID を再利用すると、現在のユーザーに影響する可能性があります。それらの変更を承認します。 プロビジョニングでは、個別の公開または共有コマンドは実行されません。 インストール リンクは、レジストリの公開、対象ユーザーの可用性、または最終的な ZIP のインストールの証明ではありません。 [ 発行 & 配布 ] と [ & 利用可能] を通じて個別に続行し、該当する承認、インストール、同意、接続などの管理を行います。

GitHub Copilot CLI を使用したいですか?

Help test <skill-name> in this plugin's existing Cowork development deployment.
Reuse its printed install link. Ask before provisioning; inspect the actual
environment scope first. Don't publish or share. Request release notes for
"Added CSV export; Fixed duplicate rows; Updated help text." Compare categories
and promised files; test missing input. Guide explicit/automatic Chat selection
if supported. Let me operate inaccessible UI and handle sign-in/consent.
Show actual evidence and ask before installs, exposure, or external changes.

リモート MCP コネクタのテスト

プラグイン コンポーネント:agentConnectors[] リモート MCP サービスを指すエントリ。

これが証明すること: サーバーの動作を個別に実行した後、開発プラグインを介して認証された使用を行います。

パッケージ化後にまだ証明する必要があります: コネクタ宣言、接続設定、ランタイム呼び出しは、正確にインストールされた成果物から動作します。

保持する証拠: エンドポイント/バージョン、ツール スキーマ、入力/結果、ID、および関連付けられたホスト/サーバー レコード。

MCP インスペクターを Node.js 22.19.0+、信頼できる Streamable HTTP エンドポイント、その認証の詳細、安全な読み取り専用操作で使用します。

  1. Launch Inspector で、URL の例を置き換えます。

    $serverUrl = 'https://your-server.example/mcp'
    npx @modelcontextprotocol/inspector --server-url "$serverUrl" --transport http
    

    確認:認証が完了し、必要なサーバー ID と機能が表示されます。

  2. リスト ツールで、ルックアップ操作を選択し、既知のレコードのスキーマ定義フィールドを入力して実行します。

    確認:スキーマと返されるタイトル、状態、URL は期待通りです。

  3. 存在しないレコードと制限された ID を使用して繰り返します。

    確認:レコード欠落の動作は対処可能であり、承認されていないコンテンツはアクセスできないままです。

  4. 必要に応じてスキルのテストのプロビジョニング手順を使用して、開発プラグインの Cowork のインストールとテストのリンクを開きます。コネクタのみのプロジェクトにはスキルは必要ありません。 接続のセットアップを完了し、同じレコードを要求します。 スキルがコネクタを使用する必要がある場合は、その要求でコネクタを呼び出します。

    確認:認証されたサービス ログには、予期された操作と入力が表示され、返される値はセッションの結果と一致します。

  5. 取り消しを含む、破棄可能なレコードに対してのみ、承認された書き込み操作をテストします。

    確認:承認済みの変更は要求と一致し、取り消しの場合、ソース データは変更されません。

コンポーネント構成のエンドポイントと認証参照を、実際に実行された内容と比較します。 該当するツールの説明の要件を含む、 コネクタの要件に従います。サーバーの成功だけでは、ホスト接続の準備は確立されません。

ローカル サービスの場合は、そのプロジェクトのコマンドを使用して開始します。 公開を承認した後、 永続的な開発トンネルを作成する このプラグイン コネクタの場合は、実際の MCP パスを持つパブリック HTTPS エンドポイントに remoteMcpServer.mcpServerUrl を設定します。プロジェクトのワークフローを通じて開発デプロイを更新し、再テストします。 アプリケーション認証を保持し、テストが完了したらトンネルを停止します。

確認:サービス ログには、目的のエンドポイントで認証されたホスト要求が表示されます。

GitHub Copilot CLI を使用したいですか?

Help test this plugin's remote MCP connector at <endpoint>. Show the Inspector
command and ask before downloads or launch. Let me authenticate and call
<read-only-tool/input>; compare with <expected-record>. Then guide the same
task in the existing Cowork deployment and correlate sanitized server logs.
Ask before exposure, deployment, or writes; report diagnostics you can't see.

含まれている宣言型エージェントをテストする

プラグイン コンポーネント: プラグイン プロジェクトに含まれるオプションの宣言型エージェント。

これが証明すること:エージェントの応答と利用可能な選択プラグイン、検索、および引用診断。

パッケージ化後にまだ証明する必要があります: パッケージ化されたエージェントの参照とインストールされたプラグインの完全なシナリオは、要求されたエクスペリエンスで機能します。

保持する証拠: エージェント/バージョン、要求/会話 ID、選択した機能、入力、実際の出力。

サポートされているプラグイン プロジェクトの分析調査に従います。 そのコンポーネントに対応する既にデプロイされたエージェントに対して、 Work IQ Dev Tools と DevUI を使用します。

  1. エージェントを一覧表示し、検索を実行します:

    wiqd agent list
    wiqd plugin ask --component agent --agent-id "<agent-id>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    確認:選択したエージェントと戻り値は、コンポーネントおよびソース レコードと一致します。

  2. 文書化された DevUI プレビュー フラグを有効にして、次のように繰り返します。

    wiqd config flags set devui true
    wiqd devui start --agent "<agent-name>"
    wiqd devui ask --agent "<agent-name>" -q "Find issue 123 in my test repository. Return its title, status, and source URL."
    

    選択したプラグイン、検索、引用、生の結果を検査します。

    確認:利用可能な診断により、意図した機能と期待される返されるデータが識別されます。

  3. エージェントにスキルが接続されている場合は、その出力をチェックします。

    wiqd devui ask --agent "<agent-name>" -q "Draft release notes from these changes: Added CSV export; Fixed duplicate rows; Updated help text."
    

    確認:変更とpromised ファイルがスキルの要件を満たしている。

  4. 診断サーバーを停止します。

    wiqd devui stop
    

    確認:このコマンドは、停止した、または実行されていないと報告します。

DevUI で公開されている診断では、スキルごとまたはスクリプトごとの呼び出しは確立されません。 出力の正確性を個別に記録します。 エージェント固有の指示、推奨されるプロンプト、定義された動作に対するスコープ外の要求もテストします。

GitHub Copilot CLI を使用したいですか?

Use WIQD to list agents; let me choose the component's deployed <agent-id>.
Ask it for issue 123 in <repository>, comparing with <expected-title/status/URL>.
Open DevUI and repeat; help inspect selected plugins, retrieval, citations,
raw results, and request IDs. If <skill-name> is attached, request release
notes for "Added CSV export; Fixed duplicate rows; Updated help text."
Compare outputs separately from invocation evidence. Show commands/results
and stop DevUI. Ask before configuration, deployment, sharing, or external
writes. Let me handle sign-in and inaccessible UI; don't publish anything.

文書化された DevUI エージェント ワークフローを参照してください。

依存関係のテスト

コンポーネントが依存するサービスと知識をテストしてから、統合プラグイン タスクを繰り返します。 これらの依存関係チェックは、追加のプラグイン コンポーネント登録ではありません。

同期された Copilot コネクタ

依存関係: 含まれているエージェントによって使用されるインデックス付きナレッジ。

これが証明すること: 取り込み、更新、アクセス許可、その後の取得。

パッケージ化後にまだ証明する必要があります: インストールされたプラグインは、意図した接続を使用して記録します。

保持する証拠: 接続 ID、クロール出力、インデックス付きカウント、引用文献、およびソース値。

GitHub の問題テンプレートの場合は、前提条件、リポジトリ構成、同意、クロール、インデックス作成のチェック用に最初の 同期されたコネクタ を構築する を参照してください。 その他の実装については、文書化されたクロールおよび診断手順を使用します。

  1. 含まれるエージェント用に構成された接続 ID がテストされた接続と一致すること、および既知のレコードがインデックスが作成されていることを確認します。

    確認:接続診断により、意図したソースと予期されるインデックス付きアイテムが識別されます。

  2. その接続で構成されたエージェントに対してクエリを実行し、破棄可能な問題を更新し、コネクタを再実行して、再度クエリを実行します。 調整パスと制限付きアクセスを介して削除をテストします (アイテムのアクセス許可が適用される場合)。

    確認:値、引用、更新、削除処理、およびアクセス一致要件。

フェデレーション Copilot コネクタ

依存関係: サポートされているシナリオで使用される 使用可能なフェデレーション接続 。

これが証明すること: 接続された ID でのライブ取得。

パッケージ化後にまだ証明する必要があります: インストールされたプラグインのシナリオ全体では、意図したデータ アクセス パスが使用されます。

保持する証拠: ID、ソース レコード、応答/引用文献、および使用可能なサービス ログ。

  1. Copilot Chat で、...> を選択します設定>ソースを見つけて、[接続] を選択して認証します。

    確認:目的の ID の接続が成功します。

  2. 既知のレコードをソース名または ID で要求します。 破棄可能なレコードを更新して繰り返します。 また、制限された ID もテストします。

    確認:ライブ変更が表示され、ソースのアクセス許可は引き続き適用されます。

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

必要なすべてのコンポーネントを有効にした状態で、意図したエクスペリエンスを通じて同じ既知のタスクを実行します。 たとえば、既知の問題を取得し、リリース ノートを作成するようにスキルに依頼するのは、その結合されたワークフローがソリューションの一部である場合のみです。

  1. 目的のテスト ID と入力を使用して新しい会話を開始します。

    確認:必要なスキルまたはエージェントが要求を処理します。

  2. コンポーネント固有の証拠を収集します。 リモート通話の場合は、利用可能なホスト診断を認証されたサービス ログと関連付けます。

    確認:目的のコンポーネントが選択されます。 ツールが必要な場合、ツールは正しい入力と ID を受け取り、その実際の出力が使用されます。

  3. 応答とファイルを期待される結果と比較します。

    確認:コンテンツ、引用、および約束された出力は要件と一致します。

テストの失敗と境界

入力がないかあいまいな、期限切れの認証、拒否された同意、制限されたデータ、使用できない依存関係、空または不正な結果、スクリプトの失敗、タイムアウト、スロットリング、再試行で繰り返します。 安全でアクション可能なエラー動作と必要な確認を確認します。 テストを実行する前に、予想されるそれぞれの結果を記録します。

統合結果を記録する

シナリオと ID ごとに 1 つのレコードを使用します。 パッケージ テストに持ち込む;パッケージ化後にパッケージ フィールドを入力します。

フィールド Keep
Components バージョン、ファイル、エンドポイント、接続参照、およびソース リビジョン
パッケージ ID、バージョン、ZIP パス、およびオプションの SHA256 ハッシュ。Pending before packaging
コンテキスト 環境、エクスペリエンス/リリース状態、機能フラグ、テスト ID ロール、および日付
シナリオ 必要なチェック、許容される証拠、反復可能な入力、予想される結果と実際の結果
証拠 サニタイズされた呼び出しログ、要求 ID、出力、レポートの場所
決定 合格、不合格、または未確認。必要な証拠のギャップ、診断上の制限、所有者、次のアクション

パッケージ化する前に

  • 呼び出し: 意図する機能の選択と期待される入力/出力を確認します。
  • アクセス: 承認/制限付きアクセス、同意、確認チェックを完了します。
  • 結果と失敗: 該当する エラー テストを完了します。
  • 意図したエクスペリエンス: サポートされているすべてのリリース エクスペリエンスについて、開発結果を個別に記録します。最終的なインストール済みアーティファクト チェックを計画します。
  • ハンドオフ レコード: パッケージ化する前に、 テスト レコード を保存し、実装ブロッカーを解決します。
  • パッケージの参照: テストするコンポーネントのバージョン、ファイル、識別子、接続参照、エンドポイントが、パッケージで参照されるものであることを確認します。

次のステップ

パッケージ & テストを続行する: プラグイン パッケージを作成し、同じ証拠レコードと正確なパッケージ参照を使用してパッケージを検証およびテストします。