Agentforce Builder のトレースパネル

使用可能なインターフェース: Lightning Experience

使用可能なエディション: Enterprise Edition、Performance Edition、Unlimited Edition、および Developer Edition。必要なアドオンライセンスはエージェント種別によって異なります。

テストメッセージを送信すると、インタラクション概要にエージェントの意思決定プロセスの各イベントがビジュアルタイムラインとして表示されます。テストケースに応じて、イベントは次のとおりです。

イベント	説明
入力: [メッセージ]	このターンを開始したメッセージ
理由: [エージェント名]	次に何を実行するか、なぜ実行するかを示すエージェントの推論パス
アクション: [関数の表示ラベル]	エージェントがトリガーしたエージェントアクション (フロー、Apex など)
サブエージェントへの移行: [対象エージェント]	エージェントが同じエージェント内のサブエージェントに会話を引き渡した
エージェントへの移行: [開発者名]	エージェントが別の関連エージェントに会話を引き渡した
出力評価: [カテゴリ]	ユーザーに返される前のエージェントの応答の評価
MCP ツール評価: [エージェント名]	エージェントが評価した MCP ツールコール

[インタラクションの概要] で任意のイベントを選択すると、[追跡] タブでその詳細ビューが開きます。[トレース] タブには、そのイベントのミリ秒ごとの内訳と各サブ操作のタイミングバーが表示されます。個々のスパンにドリルインして、その完全な出力データと、その時点でエージェントが受信および返した正確な内容を確認します。

[変数] サブタブには、セッションの各決定ポイントのすべての変数の状態が表示されます。各イベントには、実行前とイベント完了後の値が表示されます。たとえば、条件チェックに合格した後で Boolean が False から True に切り替わるとします。[変数] サブタブを使用して、次の操作を行います。

• 正しいデータがエージェントアクションまたはプロンプトテンプレートに到達したことを確認する
• アクションの完了後に正しい変数が更新されていることを確認する
• セッションのどこで変数が予期しない値を受信したかを特定する

テストを開始する前に [コンテキスト変数] で初期値または上書き値を設定し、セッション中に変数を使用してそれらの値がどのように変化するかを追跡します。

[Reasoning (推論)] ステップ内の [Trace (追跡)] タブには、LLM に送信された正確なプロンプトが表示されます。この情報を使用して、次の点を理解します。

• エージェントがサブエージェントを選択したとき、またはエージェントアクションをトリガーすることを決定したときに、エージェントがどのようなコンテキストを使用していたか
• プロンプトに想定していた変数値と命令が含まれていた場合
• エージェントの推論が予期しない結果につながった理由

トレースを確認するときに、何が表示されているか組み込み Agentforce Assistant に質問します。たとえば、「この推論ステップで生成されたプロンプトを説明します」や「このケースを処理するようにエージェントを修正できますか?」などです。

推奨される修正は、適用する前に慎重に確認してください。提案では、組織に存在しないエージェントアクションまたはフローを参照することがあります。変更する前に確認してください。

一般的なデバッグの問題とその解決手順を次に示します。

行動	解決方法
エージェントアクションがトリガーされなかった	予想されるアクションの直前に [理由] ステップを開きます。生成されたプロンプトで、アクションをコールするために必要なコンテキストがエージェントにあったかどうかを確認します。次に、Reasoning ステップの後に FunctionStep (アクション) が表示されるかどうかを確認します。そうでない場合、エージェントは使用可能なコンテキストに基づいてアクションをトリガーしないことを決定しました。
予期しないサブエージェント移行が発生しました	インタラクション概要で TransitionStep を見つけます。[Reasoning (推論)] ステップをその前に展開して、エージェントが移行したコンテキストを確認します。エージェントルーターの設定がテストメッセージで表現されたインテントと一致するかどうかを確認します。
出力が期待と一致しない	シーケンスの最後にある OutputEvaluationStep を確認します。次に、[推論] ステップと [変数] サブタブを逆方向に操作して、エージェントの決定が期待していたものとどこで異なっているかを特定します。