開発者モードを使用してエージェントをテストおよびデバッグする

テストは、Microsoft 365 Copilot Chatの宣言型エージェントを開発するプロセスの重要な部分です。 エージェントのテスト中に 開発者モード を使用して、Copilot オーケストレーターが、指定されたプロンプトに応答して使用するナレッジ ソースを選択するかどうかを確認できます。

Copilot Chatで開発者モードを使用する

開発者モードを有効にするには、Microsoft 365 Copilot Chatで「-developer on」と入力します。 開発者モードを無効にするには、「 -developer off」と入力します。

開発者モードが有効になっている間、オーケストレーターがエージェント内のエンタープライズナレッジ (データ)、機能、またはスキル (アクションまたはプラグイン) 内で特に検索してプロンプトに応答すると、デバッグ情報を含むカードが返されます。 デバッグ情報カードには、次のフィールドが含まれます:

• エージェント メタデータ: エージェントと会話の識別子。
• 機能: エージェント用に構成された機能の一覧。
• アクション: エージェント用に構成されたアクションの一覧
  • 一致した関数: ランタイム アプリのインデックス検索で一致した関数の状態
  • 実行用に選択された関数: オーケストレーター推論に基づいて呼び出し用に選択された関数の状態
• 実行: プロンプトに対して実行される機能とアクションの一覧
  • 実行された機能: 実行された機能の状態と応答の統計。
  • 実行されたアクション: アクションの要求と応答の実行状態。

エージェント メタデータ セクション

エージェント メタデータは、エージェントと現在のデバッグ セッションに関する次のような重要な詳細を提供します。

• エージェント ID - タイトル ID とマニフェスト ID を含む、エージェントの一意の識別子。
• エージェントのバージョン – 現在使用されているエージェントのバージョン番号。
• 会話 ID - アクティブなチャット セッションまたは会話を識別します。
• 要求 ID - 会話内の特定のプロンプトを識別します。

エージェント機能

[エージェントの機能] セクションには、エージェントに対して構成されている機能が表示され、アクセス可能なナレッジ ソースのスコープが定義されます。

エージェントアクション

エージェント アクションには、アクション ID とバージョン番号、アクションに対して構成された関数、一致および選択状態が表示されます。

アクションが有効になっていないカード

有効なアクションがない場合、アクション セクションはアクションが有効になっていないことを示します。

一致しない機能を持つカード

指定されたプロンプトに一致する関数が返されなかった場合、これは、プロンプトがアクション名を明示的にメンションしなかったことを示している可能性があります。

実行の詳細

実行された詳細セクションには、プロンプトに対して実行された構成済みの機能またはアクションと、実行の詳細と状態が表示されます。

機能の実行の詳細

機能の実行の詳細には、実行された機能とその状態が表示されます。 各機能には、使用される検索テキスト、機能の応答、返される結果の数など、実行の詳細が異なる場合があります。

アクション実行の詳細

アクション実行の詳細には、関数とその状態、待機時間、要求情報 (要求エンドポイント、HTTP メソッド、要求ヘッダー)、応答が含まれます。

実行に関数が選択されていないカード

プロンプトの検索意図に一致するアクション関数がない場合、デバッグ情報カードは、実行のために選択された関数がないことを報告します。 これは、マニフェストのコマンドの説明が、指定されたプロンプトの検索意図に意味的に関連していないためです。

Copilot が以前に一致して関数を正常に実行した場合、これは調整を示している可能性があります。

空または失敗した [関数の実行の詳細なし] のカード

メッセージ以外の拡張機能プラグインの場合、失敗した場合や関数の実行の詳細がない場合は、エージェントがプラグインの選択した関数にパラメーターを割り当てようとしたときに失敗したことを示します。 エラーが一貫性がない場合は、アクションまたはパラメーターの説明が不明であるか、無効なホスト URL、または Open API 定義に関するその他の問題が原因である可能性が最も高くなります。

メッセージ拡張プラグインの場合、ベスト プラクティスは、9 秒以下の応答を最適化することです。 詳細については、メッセージ拡張プラグインの 技術的要件 を確認してください。

現在、プラグイン API の Copilot 実行のタイムアウト制限は 10 秒に設定されています。

エラーのトラブルシューティング

エージェントをデバッグするときに発生する可能性がある一般的なエラーと、エラーの原因として考えられるエラーを次に示します。

デバッグカードなし

オーケストレーターがプロンプトに応答するために Microsoft 365 のデータまたはスキルを必要としない場合、デバッグ情報カードは返されません。

デバッグ カードは、容量調整の場合にも返されません。通常は、後でやり直すエラー メッセージが表示されます。

問題の報告

サムアップボタンまたはサムダウンボタンを使用して、エージェントに関するフィードバックや問題を報告します。 レポートに #extensibility タグを含めます。

テキスト ボックスに、#extensibility タグを含むメッセージを入力します。

関連コンテンツ

• Visual Studio Code を使用して宣言型エージェントを構築する
• Copilot Studio エージェント ビルダーを使用してエージェントをビルドする