Microsoft Copilot StudioのGitHub Copilotハーネスで動作するエージェントのアクティビティトレースは、エージェントが各メッセージをどのように処理するかを正確に示します。 これを使用して、エージェントの思考の連鎖の理解、サポート情報ソースの帰属の検証、ツール実行の確認、エラーのトラブルシューティングを行います。
注:
この記事の機能は、使用量に基づく請求にCopilot Creditsを用いるGitHub Copilotハーネスによって機能しています。 GitHub Copilotハーネスで動くエージェントの請求概要でCopilotクレジットについて詳しく学びましょう。
使用率に基づく請求は、エージェントの使用、構築、テスト、評価に適用されます。 これらの行動はCopilotクレジットを消費することがあります。
前提条件
- GitHub Copilotハーネスで作成されたエージェントです
- 少なくともプレビュー タブでテスト会話が 1 件ある
活動トレースを開く
Copilot Studio でエージェントを開き、プレビュー タブを選択します。
エンドユーザープレビュートグルがオフになっていることを確認してください（これがデフォルトのメーカービューです）。 アクティビティトレースはチャットペインの横に表示され、各メッセージの処理内容が表示されます。
エージェントにメッセージを送信します。 トレースはエージェントがメッセージを処理する過程でリアルタイムに更新されます。
トレースを理解する
アクティビティトレースは、エージェントの処理のチェーンオブソート（CoT）ビューを表示します。 トレースの各手順は、エージェントが何をしたのか、なぜそうしたのかを示すノードとして表示されます。
ノードの種類
トレースには以下のノードタイプが含まれる場合があります:
| ノード タイプ | 表示される内容 |
|---|---|
| ユーザー メッセージ | エージェントに送ったメッセージ |
| エージェントの応答 | エージェントの生成された応答 |
| 知識 | エージェントが根拠として利用したサポート情報ソース。 アクセスした各サポート情報ソースの情報源と、引用リンク（利用可能な場合）を表示する「検索済みサポート情報ソース」折りたたみカードとして表示されます。 |
| アクション実行 | コネクターやツールの呼び出しは、コネクター名、入力済みパラメーター、実行時間を示す折りたたみカードとして表示されます |
| Tool | エージェントが操作やデータ取得のために呼び出したツール |
| コネクタ | エージェントが外部データにアクセスするために使用したコネクター |
| フロー | エージェント フローがトリガーされた |
| スキル | スキルが実行された |
| エラー | 処理中に発生したエラー |
| 完了 | すべてのツール呼び出しが完了した際、トレースの下部に表示される緑色のチェックマークアイコン |
ノードの詳細を表示する
トレース内の任意のノードを選択して詳細を展開します。
表示される情報を確認してください。含まれる場合がある内容は次のとおりです:
- エージェントが手順に送った入力
- 出力または結果
- 処理時間と指標
- ステップが失敗した場合のエラーの詳細
サポート情報ソースの問題のデバッグ
エージェントがナレッジを使って質問に答える場合、トレースには参照されたソースが表示されます。
トレースの ナレッジ ノードを見つけてください。
アクセスされたサポート情報ソースを確認してください。
取得された特定のコンテンツを確認するには、ソースを選択してください。
エージェントが正しい情報源を使用し、取得したコンテンツが関連性のあるものであることを確認してください。
エージェントが誤った情報源を使用したり、誤った情報を提供した場合は、構築 タブで知識構成を確認してください。
ツール実行のデバッグ
エージェントがツールを呼び出すと、アクティビティトレースに実行の詳細が表示されます。
トレース内でツール、コネクタ、フロー、またはスキルノードを特定してください。
入力パラメーターや出力結果などを含めた実行の詳細を確認してください。
正しいツールが呼び出されたこと、そして結果が期待通りであることを確認しましょう。
ツールの実行が失敗した場合は、ノード内のエラー詳細を確認してください。
ツールを再設定するには、Buildタブを開き、エージェント構成内でツールを特定してください。
エラーのトラブルシューティング
処理中にエラーが発生すると、トレースがハイライトします。
トレースでエラーインジケーターが付いたノードを探してください。
エラーノードを選択すると、エラーメッセージやコンテキストを含むエラーの詳細が表示されます。
一般的な問題は次のとおりです。
- ツールやコネクタの認証エラー
- サポート情報ソースアクセスエラー
- 長時間にわたるツール呼び出しのタイムアウトエラー
- コンテンツ モデレーション フラグ
構築タブまたは設定で根本原因を特定し、再テストします。
トレースからビルドタブへ移動する
アクティビティトレースは ビルド タブと連携し、迅速な編集が可能です。
トレース内の任意のソース、ツール、コンポーネントを選択します。
Copilot Studioは ビルド タブで対応するコンポーネントに移動します。
変更を加えてから プレビュー タブに戻って再テストしてください。