Microsoft 365 Copilot の開発者モードを使用してエージェントのテストとデバッグを行う

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

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

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

ユーザーが '-developer on' と入力して開発者モードを正常に有効にした Microsoft 365 Copilot セッションのスクリーンショット

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

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

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

Copilot がエージェント メタデータを示すデバッグ情報を含むカードを返した Microsoft 365 Copilot セッションのスクリーンショット

エージェント メタデータには、エージェントと現在のデバッグ セッションに関する次のような重要な詳細が表示されます。

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

注

エージェント ID のプレフィックスは、エージェントの配布方法を示します。

  • U_ ユーザー スコープの (サイドロードされた) エージェントを示します。
  • T_ テナント スコープのエージェント (テナント ストアまたは組織カタログに発行) を示します。
  • P_ 一般公開されているエージェントを示します。

関連する公開ガイダンスについては、以下を参照してください。

エージェントの機能

Microsoft 365 Copilot セッションのスクリーンショット。ここで Copilot は、構成済みのエージェントの機能を示すデバッグ情報を含むカードを返しました

[エージェント機能] セクションには、エージェントの構成済み機能が表示され、アクセス可能なナレッジ ソースの範囲が定義されます。

重要

[エージェントの機能] セクションに WebSearch が有効になっていることが示されている場合、これはエージェントが機能を有効にしたことを意味するだけです。 これは、管理者がorganizationの Web 検索を無効にするために使用できるAllow web search in Copilotクラウド ポリシー設定は反映されません。 詳細については、「Microsoft 365 管理センターで Microsoft 365 Copilot シナリオを管理する」を参照してください。

エージェント アクション

Microsoft 365 Copilot セッションのスクリーンショット。ここで Copilot は、構成済みのエージェント アクションを示すデバッグ情報を含むカードを返しました

エージェントアクションには、アクション ID とバージョン番号、アクションに設定された機能、およびそれらの照合および選択ステータスが表示されます。

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

有効にされているアクションがない場合、[アクション] セクションには、有効になっているアクションがないことが示されます。

一致する関数のないカード

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

実行の詳細

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

機能実行の詳細

Copilot が実行された機能を示すデバッグ情報を含むカードを返した Microsoft 365 Copilot セッションのスクリーンショット

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

アクション実行の詳細

Copilot が実行されたアクションを示すデバッグ情報を含むカードを返した Microsoft 365 Copilot セッションのスクリーンショット

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

実行する機能が選択されていないカード

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

Copilot が以前に関数に一致し、正常に実行された場合、これは調整の兆候である可能性があります。

空または失敗したカード 関数 の実行の詳細はありません

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

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

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

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

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

デバッグ カードなし

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

また、容量調整の場合はデバッグ カードが返されません。通常はエラー メッセージが表示され、後でもう一度試してください。

問題の報告

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

Microsoft 365 Copilot の賛成または反対のフィードバック オプションのスクリーンショット

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

テキスト ボックスの Microsoft 365 Copilot フィードバックのスクリーンショット