アクティビティトレースを使ってエージェントをデバッグしてください

Microsoft Copilot StudioのGitHub Copilotハーネスで動作するエージェントのアクティビティトレースは、エージェントが各メッセージをどのように処理するかを正確に示します。 これを使って、エージェントの思考過程における推論を把握し、知識ソースの出典を検証し、ツールの実行を確認し、エラーをトラブルシューティングできます。

Prerequisites

• GitHub Copilotハーネスで作成されたエージェントです
• 少なくともプレビュー タブでテスト会話が 1 件ある

活動トレースを開く

1. Copilot Studio でエージェントを開き、プレビュー タブを選択します。

2. エンドユーザープレビュートグルがオフになっていることを確認してください（これがデフォルトのメーカービューです）。 アクティビティトレースはチャットペインの横に表示され、各メッセージの処理内容が表示されます。

3. エージェントにメッセージを送信します。 トレースはエージェントがメッセージを処理する過程でリアルタイムに更新されます。

トレースを理解する

アクティビティトレースには、エージェントによる処理の思考連鎖（CoT）ビューが表示されます。 トレースの各手順は、エージェントが何をしたのか、なぜそうしたのかを示すノードとして表示されます。

ノードの種類

トレースには以下のノードタイプが含まれる場合があります:

ノードの詳細を表示する

1. トレース内の任意のノードを選択して詳細を展開します。

2. 表示される情報を確認してください。含まれる場合がある内容は次のとおりです:

   • エージェントがそのステップに送信した入力
   • 返される出力または結果
   • 処理時間と指標
   • ステップが失敗した場合のエラーの詳細

ナレッジ ソースの問題をデバッグ

エージェントがナレッジを基に質問に回答すると、トレースにはどのソースが参照されたかが示されます。

1. トレースの ナレッジ ノードを見つけてください。

2. どのナレッジ ソースにアクセスしたかを確認してください。

3. 取得された特定のコンテンツを確認するには、ソースを選択してください。

4. エージェントが正しい情報源を使用し、取得したコンテンツが関連性のあるものであることを確認してください。

エージェントが誤った情報源を使用したり、誤った情報を提供した場合は、構築 タブで知識構成を確認してください。

ツール実行のデバッグ

エージェントがツールを呼び出すと、アクティビティトレースに実行の詳細が表示されます。

1. トレース内でツール、コネクタ、フロー、またはスキルノードを特定してください。

2. 入力パラメーターや出力結果などを含めた実行の詳細を確認してください。

3. 正しいツールが呼び出されたこと、そして結果が期待通りであることを確認しましょう。

4. ツールの実行が失敗した場合は、ノード内のエラー詳細を確認してください。

ツールを再設定するには、Buildタブを開き、エージェント構成内でツールを特定してください。

エラーをトラブルシューティングする

処理中にエラーが発生すると、トレース上でそのエラーが強調表示されます。

1. トレースでエラーインジケーターが付いたノードを探してください。

2. エラーノードを選択すると、エラーメッセージやコンテキストを含むエラーの詳細が表示されます。

3. 一般的な問題は次のとおりです。

   • ツールやコネクタの認証エラー
   • ナレッジ ソースへのアクセス エラー
   • 長時間にわたるツール呼び出しのタイムアウトエラー
   • コンテンツ モデレーション フラグ

4. 構築タブまたは設定で根本原因を特定し、再テストします。

トレースからビルドタブへ移動する

アクティビティトレースは ビルド タブと連携し、迅速な編集が可能です。

1. トレース内の任意のソース、ツール、コンポーネントを選択します。

2. Copilot Studioは ビルド タブで対応するコンポーネントに移動します。

3. 変更を加えてから プレビュー タブに戻って再テストしてください。

関連情報

• エージェントのプレビューとテスト
• エージェントをテストする
• エージェントを他の人と共有しましょう
• プレビュー会話の管理
• エージェントを監視する