Microsoft 365 Copilot 用のプラグインをテストして検証する

プラグイン パッケージの作成によって生成された正確なバージョン管理された成果物をテストします。 パッケージ & テストでは、コンポーネント証拠をその ZIP に接続し、サポートされているルートを通じてインストールし、要求されたすべての Microsoft エクスペリエンスで配信されたバージョン、アクセス、および実際のランタイム動作を確認します。

最後に、"私はこれらのコンポーネントをテストし、これらの正確な参照をパッケージ化し、この正確なバージョンをインストールし、これらのシナリオを実行し、これらの結果を保持しました。"スキーマ チェック、プロビジョニング コマンド、またはもっともらしい応答が成功しても、そのチェーンは確立されません。

始める前に

保有者:

  • 既知のテスト データと期待される結果を含む完了した コンポーネント テストと統合テスト。
  • 候補 ZIP、そのパッケージ ID/バージョン、およびそれに含まれるコンポーネントのバージョン、エンドポイント、接続参照。
  • 開発テナント、非運用データ、パッケージのコンポーネントに対してサポートされているインストール ルート、およびそれを使用するためのアクセス許可。
  • 許可されたユーザーと制限されたユーザーの ID をテストします。可用性テストとブロッキング テストの承認された管理者。
  • 各ターゲット エクスペリエンスに必要なライセンス、サインイン、同意、接続、外部サービス。
  • 各シナリオと ID の テスト レコード 。

テストの前に、必要なパッケージ、インストール、アクセス、実行時のチェックと、それぞれの結果を立証する証拠を定義します。 実行時要求には コンポーネント固有の証拠基準 と、「 配信されたバージョンの確認」で説明されているインストールの証拠を使用します。

パッケージのアップロード、インストール、同意の付与、共有、または管理設定の変更を行う前に、承認を取得します。 これらの手順により、テナントの状態が変更されます。制御されたテスト ID と対象ユーザーを使用します。

スキーマとコンポーネント参照を検証する

候補の ZIP は変更せずに開きます。 そのルート manifest.json を読み取り、 id、 version、 manifestVersionを記録します。 次の内容を確認します。

  • マニフェストは、ルートで必要な Microsoft 365 アプリ マニフェスト スキーマ を使用します。
  • 含まれるエージェント定義とアクション マニフェストは、適用可能なスキーマを使用します。 API プラグイン マニフェストは、外部のレジストリ プラグインではなく、エージェント アクションを記述します。
  • 参照されているスキル フォルダー、コンパニオン ファイル、アイコン、ツールの説明は、宣言されたパッケージ パスに存在します。
  • バージョン、識別子、エンドポイント、および接続参照は、コンポーネントのテスト レコードおよび意図した環境と一致します。
  • 資格情報、シークレット、ログ、または関連しないテスト ファイルは含まれません。

Work IQ Dev Tools の場合は、これらの Windows の例に Node.js 24.15+、npm、PowerShell 7+ など、文書化された CLI の前提条件を使用します。 既存のプロジェクトでのオプションのオフライン ソース チェックは次のとおりです。

wiqd plugin validate --mode source --env "<test-environment>"

確認:適用可能なソース チェックに合格し、スキップまたはカバーされなかった機能が記録されます。

ソース モードは、保存された宣言型エージェントの診断と基本的なプロジェクト ガードを確認します。 アプリ スキーマ、スキル コンテンツ、ルート agentConnectors[]、または参照される API/OpenAPI コンテンツは完全には検証されません。 スキルのみのプロジェクトまたはコネクタのみのプロジェクトでは、該当するエージェント チェックはありません。 source明示的に使用します。既定のモードは、オフライン チェックではなく、パッケージ検証です。

正確なパッケージを検証する

複数の候補を含むビルド ディレクトリに依存するのではなく、1 つの ZIP ファイルを明示的に選択します。 PowerShell で、パスの例を成果物に置き換えます。

$packageFile = (Resolve-Path '.\appPackage\build\<candidate>.zip').Path
Get-FileHash -LiteralPath $packageFile -Algorithm SHA256

確認:解決されたファイルが意図された候補です。 必要に応じて、 ローカルで計算されたハッシュ を保持して、後続の変更を検出します。ローカル ハッシュは、ホストが実行するバイトを証明しません。

  1. 認証検証の前に、目的の Microsoft 365 ID でサインインします。

    wiqd auth login --interactive
    wiqd doctor
    

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

  2. この ZIP ファイルをプラットフォーム検証サービスにアップロードすることが承認されたら、次を実行します。

    wiqd plugin validate --mode package --package-file "$packageFile"
    

    確認:この正確な ZIP ファイルの検索結果は、必要なチェックを満たしています。返された不変の JSON および HTML レポートを保持します。

  3. 公開ルートで追加のマーケットプレース ポリシーと証拠チェックが必要な場合は、次を実行します。

    wiqd plugin validate --mode marketplace --package-file "$packageFile"
    

    確認:必要なパッケージ、ポリシー、証拠のチェックが合格し、必須証拠の不足はありません。

packageとmarketplaceの両方がビルドされた ZIP ファイルを使用してアップロードし、サインインが必要になる場合があります。 自動的に作成またはサインインすることはありません。 また、ソース プロジェクトを含まない ZIP ファイルも受け入れます。 マーケットプレース モードでは、ポリシーと証拠のチェックが追加されます。 そのレポートは、ストアまたはパートナー センターの公式の承認ではありません。 古いdeep、static、またはmanifestモード名ではなく、現在の WIQD 検証契約に従います。

コマンドの終了結果だけでなく、検索結果、カバレッジ、チェックのスキップ、必要な証拠を読み取ります。 サポートされている Agents Toolkit パッケージ ルートの場合は、「アプリの検証」に記載されているように、検証ルールまたはatk validate --app-package-file-path <path>を使用してアプリ パッケージを検証します。

ZIP ファイルに変更がある場合は、新しい候補を作成して検証を繰り返します。 リモート サービスを変更するには、ZIP ファイルが変更されていない場合でも、関連するランタイムの再テストが必要です。

パッケージをインストールまたはサイドロードする

ネイティブ Microsoft 365 アプリ パッケージを受け入れ、そのコンポーネントをサポートするルートを使用します。 WIQD プロビジョニング、インストール、テスト リンクはデプロイを識別します。このフォルダーを開いても、最終的に検証された ZIP がインストールされたとは関係ありません。

個人用 exact ZIP インストール

そのパッケージとターゲットのエクスペリエンスがサポートされている場合は、CLI のインストール、認証、パッケージのインストールについて、Cowork の個人用サイドローディング手順に従います。 [--file-path] の値として $packageFile、スコープとして Personal を使用して、選択した正確なパッケージを渡します。

確認:目的のアカウントのインストールが成功します。 返された TitleId と AppId を、パッケージ ID/バージョンとインストーラーの出力と共に保存します。 サポートされているエクスペリエンスで、インストールされているプラグインが想定されるコンポーネントと ID を公開していること、および必要な接続が完了していることを確認します。

ポリシーで個人用ルートが無効になっている場合、または候補に対してルートがサポートされていない場合は、セキュリティ コントロールを変更するのではなく、承認された互換性のあるルートを使用してください。

Cowork パッケージのアップロード

サポートされている Cowork パッケージについては、「プラグイン パッケージのアップロードとその共有ガイダンス」に従ってください。 検証済みのネイティブ Microsoft 365 ZIP ファイルを正確に選択し、テスト ID または明示的に承認されたテスト対象ユーザーへのアクセスを制限します。 フォロー Cowork でプラグインを使用してプラグインを有効にし、新しい会話で必要な接続を完了します。

確認:選択したファイルと表示されたプラグイン ID は、候補レコードと一致します。 プラグインが目的の ID 用にインストールされると、期待されるスキルとコネクタの状態が表示され、保護された操作では目的の接続アカウントが使用されます。

外国形式のアップロードは、自動的に変換できます。 このような変換は、元の Microsoft 365 ZIP が変更されていない状態でテストされたことを証明するものではありません。 ルートによって変換された場合は、アーティファクトと検証の証拠を再確立します。

配信済みバージョンを確認する

正確に選択した ZIP とそのマニフェスト id と version を、正常なインストール、目的のアカウント、返されたインストール ID にリンクするインストール レコードを保持します。 文書化された個人用サイドローディング ルートについては、解決されたファイル パス、候補のマニフェスト メタデータ、および TitleId と AppIdを含むインストーラー出力を含むコマンドを保持します。 サポートされているネイティブ Cowork アップロードの場合は、選択したファイルと、表示されたプラグイン ID とテスト アカウントを使用してアップロード/インストールの成功したレコードを保持します。

そのチェーンを、テストされた候補のインストール証拠として使用します。 ホストまたは管理ルートによって公開されたバージョン メタデータを候補と関連付け、テスト前に不一致を調査します。 呼び出しとは別にインストールの証拠を記録します。

引用した個人用インストール手順では、ユニバーサル インストール バージョンのクエリまたはサーバー側パッケージ ハッシュは文書化されていません。 どちらもこの手順では必要ありません。インストール レコードは、どの候補が提出され、正常にインストールされたかを確立するのであって、ホストが実行するバイトの独立した検証ではありません。 リリース条件で独立したホスト側のバージョンまたはバイト検証が必要な場合は、その証拠を取得します。その存在は 未確認 のままであり、そのリリースの主張をブロックします。 プロビジョニング リンク、プラグイン名、正常な応答、またはローカル ハッシュだけでは、インストール チェーンは確立されません。

管理者が管理する候補の場合は、現在の レジストリ アップロードおよびインストール手順に従い、テスト ユーザーの範囲を設定し、受け入れられた成果物とインストール レコードを保持します。 ルートが別のアーティファクト タイプを受け入れる場合、または検証された ZIP との関係を確立できない場合は、アーティファクト バインディング チェックを未確認として扱い、同等ではありません。

パッケージ化されたプラグインをテストする

以前の開発展開ではなく、インストールされた候補を使用して 完全な統合シナリオ を繰り返します。

  1. 要求されたそれぞれのエクスペリエンスで新しい会話を開始します。 コンポーネント テストと同じ ID ロール、既知のレコード、入力、および予想される結果を使用します。

    確認:目的のインストール済みコンポーネントが選択されます。

  2. コンポーネント固有の証拠を収集します。 リモート呼び出しの場合は、認証されたサービス ログを要求、入力、および返されたデータと関連付けます。

    確認:ホスト証拠は、該当する場合は、選択またはロードされたスキルを識別します。 必要なツール呼び出しには相関する呼び出し証拠があり、返されるデータが応答に貢献します。

  3. 出力ファイルと引用を調べます。 該当する エラー ケースと境界ケースを繰り返します。

    確認:正確性、アクセス境界、承認、および失敗動作は、事前定義された基準を満たしています。

リリース ノートのスキルについては、 Added CSV export; Fixed duplicate rows; Updated help text. Check Features、Fixes、Other および promised ファイルを再利用します。 MCP 検索の場合は、既知の問題の正確なタイトル、状態、URL をサービス ログと比較します。 コンポーネント固有の証拠ツールを使用します。エージェント診断ルートだけでは、スタンドアロンでインストールされたプラグインが実行されたとはわかりません。

正確性と呼び出し結果は分けておきます。 必要なチェックの証拠が見つからない場合は、未確認のままです。 利用できない追加の診断は、検証済みの実行の詳細や自動エラーとしてではなく、制限として記録します。 検出、接続、選択、ランタイム テストを Chat と Cowork の両方を要求した場合は、個別に繰り返します。

認証とアクセスのテスト

承認された管理者に、[ ユーザーのプラグインの可用性の設定 ] と [ プラグイン、スキル、MCP サーバーの管理] を使用して、制御されたテスト設定を準備してもらいます。 元の設定を記録し、承認されたテスト後に復元します。 プラグインがサポートしているのと同じ無害なルックアップ、または同等のシナリオを使用します。 スキルのみのシナリオでのサービス同意など、適用できないチェックの場合は、機能を追加するのではなく、理由を記録します。

テスト セットアップとアクション 期待される結果
許可されたユーザー 承認された対象ユーザーにテスト ID を含めます。 そのユーザーとしてサインインし、必要な同意/接続を完了します。 サポートされているシナリオは、そのユーザーのソース アクセス許可の範囲内で成功します。呼び出し証拠は、期待される機能を識別します。
制限されたユーザー 承認された対象ユーザーに利用を制限し、その対象ユーザー以外のアカウントでテストします。 ユーザーはプラグインを使用できません。 Copilot チャネルでは、登録情報はブロック済みとして検出可能なままにしておくことができます。資格のあるユーザーはアクセスを要求できます。 可視性だけでは失敗ではありません。
拒否された同意 既存の許可なしでテスト ID/接続を使用します。 操作で必要な同意を拒否し、保護された参照を再試行します。 この操作では、要求された保護されたアクセスは取得されません。 サインイン/同意エラーを記録し、保護された結果が成功として表示されないことを確認します。 関連付けられていない許可された機能は引き続き動作します。
ブロックとブロック解除 管理者に「候補者の プラグインまたはスキルをブロック する」に従っているように依頼します。 以前に許可したユーザーで要求を繰り返してから、管理者にプラグインの ブロック解除 を選択して、もう一度要求を繰り返してもらいます。 ブロックされている間、プラグインと依存エージェントは使用できません。 関連付けられている MCP サーバー/コネクタは、引き続き他のプラグインで使用できます。 ブロックを解除すると、以前に許可されたユーザーは、元の可用性、アクセス許可、接続要件に応じてプラグインを再度使用できます。

パブリッシャー カテゴリの制限 は別のコントロールです。 テストする場合は、カテゴリとそのポリシー結果を記録します。1 人の候補者をテストするためだけに organization 全体の設定を変更しないでください。 該当する場合は、サインインの更新/再接続、ソースのアクセス許可、見つからない接続をテストします。

Microsoft Entra 認証コード認証の場合、拒否された同意は承認エラーを返します。すべてのホストで同じ文言を期待するのではなく、実際のプロバイダー エラーを使用してください。

サポートされているエクスペリエンスをテストする

エクスペリエンス、ID ロール、シナリオごとに、インストールと配信バージョンの証拠を含む結果を記録します。 Cowork のパスは、Chat や別のホストのパスを確立しません。 それぞれにサポートされているルートを使用します。未解決のインストールまたはバージョンの証拠は、そのエクスペリエンスに対するリリース要求を妨げます。

エージェント品質の結果を記録する

エージェントが含まれており、リリース基準で品質評価が必要な場合は、対応するデプロイされたバージョンを評価し、その結果を候補レコードにリンクします。 エージェント 評価の概要から始めます。 品質スコアは、パッケージ、インストール済みバージョン、アクセス、または呼び出しの証拠を置き換えるものではありません。

候補に対して回帰検定を繰り返す

記録されたベースライン シナリオ、アクセス テスト、エラー ケース、インストールされた候補に対する必要なエージェント評価を再実行します。 ベースラインを削除せずに、変更固有のケースを追加します。 両方の テスト レコード セットを保持し、結果を比較し、承認前に回帰や必要な 未確認の チェックを解決します。

公開、ロールアウト、置換、ロールバックの決定など、ベースラインの準備と更新ライフサイクルについては、次の手順に従って、 プラグインまたはエージェントの監視、更新、廃止を行います。 自動アップグレード、保持された割り当て、または特定の再同意トリガーを想定しないでください。 ロールアウト後、配信バージョンとランタイム検証を繰り返します。

リリース準備の決定

パッケージ ID とバージョン、正確な ZIP ファイルとオプションのハッシュ、コンポーネントのバージョンとエンドポイント、環境、テスト ID ロール、シナリオ、予想される結果と実際の結果、サニタイズされた呼び出しの証拠、状態、所有者を使用して、共有 テスト レコード を完了します。 検証レポート、インストール、およびバージョンの証拠を添付します。

1 つの結果を代入する:

  • 準備完了 - 正確な候補は、完全な証拠があり、未解決のリリース ブロッカーなしで、必要なすべてのチェックに合格しました。
  • ブロック - アーティファクト バインディング、配信バージョン、アクセス、呼び出しなど、必要なチェックが失敗したか、未確認のままです。
  • 制限付き準備完了 - 必要なチェックに合格しました。残りの非ブロック制限は文書化され、受け入れられており、開示に適しています。

テスト前に定義された必要なチェックと証拠基準を適用します。 受け入れられた診断制限は、必要な証拠の欠落をパスに変えることはできません。必要なチェックですでに十分な証拠がある場合、追加の診断は必須ではありません。 ブロッカーごとに、所有者と解決策を記録します。 アーティファクトが変更されたときに新しい候補を作成し、再インストールし、影響を受けるテストと回帰テストを繰り返します。

次のステップ

必要な証拠が完成したら、引き続き 公開 & 配布を行います。