在 Agentforce Builder 中追蹤面板
「追蹤」面板是內建於 Agentforce Builder 中「預覽」與「即時測試」體驗中的推斷除錯器。它會顯示您的工作人員如何做出決策,包括選取的子工作人員、觸發的動作、主題轉換的發生時間,以及變數值的變更。
必要版本
| 提供版本:Lightning Experience |
| 提供版本:Enterprise、Performance、Unlimited 及 Developer Edition。所需附加元件授權會因工作人員類型而有所不同。 |
傳送測試訊息後,「互動摘要」會將工作人員決策流程中的每個事件顯示為視覺化時間表。視測試個案而定,事件包括:
| 事件 | 描述 |
|---|---|
| 輸入:[訊息] | 此輪開始的訊息 |
| 原因:[工作人員名稱] | 工作人員的推理通過概述其接下來決定執行的動作和原因 |
| 動作:[函數標籤] | 工作人員觸發的工作人員動作 (流程、Apex 等等) |
| 轉換至子工作人員:[目標工作人員] | 工作人員將交談轉交給相同工作人員內的子工作人員 |
| 轉換至工作人員:[開發人員名稱] | 工作人員將交談轉交給個別相關工作人員 |
| 輸出評估:[種類] | 將工作人員回應退回給使用者之前的評估 |
| MCP 工具評估:[工作人員名稱] | MCP 工具呼叫工作人員評估 |
在「互動摘要」中選取任何事件,以在「追蹤」索引標籤中開啟其詳細資料檢視。「追蹤」索引標籤會顯示該事件的每毫秒細目,以及每個子作業的時間長條。逐層細分至個別範圍以查看其完整輸出資料,以及工作人員在該時間點收到的和傳回的內容。
「變數」子索引標籤會顯示工作階段中每個決策點中每個變數的狀態。每個事件都會顯示執行前的值,以及事件完成後的值。例如,在條件檢查通過後,布林值從 False 切換為 True。使用「變數」子索引標籤:
- 確認正確的資料已到達工作人員動作或提示範本
- 確認動作完成後已更新正確的變數
- 識別工作階段中變數收到非預期值的位置
在開始測試之前,請先在「內容變數」中設定初始值或覆寫值,然後在工作階段期間使用變數來追蹤這些值的演進方式。
在任何「原因」步驟中,「追蹤」索引標籤會顯示傳送至 LLM 的確切提示。使用此資訊瞭解:
- 工作人員選取子工作人員或決定觸發工作人員動作時所擁有的內容
- 如果提示包含您預期的變數值和指示
- 工作人員的推理為何導致非預期成果
檢閱追蹤時,詢問內建 Agentforce Assistant 關於您看到的內容。例如,「說明在此推理步驟中產生的提示」或「如何修正工作人員來處理此個案?」
套用之前,請仔細檢閱任何建議的修正。建議有時會參照組織中不存在的工作人員動作或流程,因此請先驗證再進行變更。
以下是一些更常見的除錯問題,以及如何解決這些問題的步驟。
| 事件 | 解決方案 |
|---|---|
| 工作人員動作未觸發 | 立即在預期動作之前開啟「原因」步驟。檢閱產生的提示,瞭解工作人員是否具有呼叫動作所需的內容。然後檢查「原因」步驟之後是否顯示 FunctionStep (動作)。如果沒有,工作人員會根據可用的內容決定不觸發動作。 |
| 發生非預期子工作人員轉換 | 在「互動摘要」中尋找 TransitionStep。展開之前的「原因」步驟,以瞭解導致工作人員轉換的內容。確認「工作人員路由器」的組態是否符合您測試訊息所表達的意圖。 |
| 輸出不符合期望 | 檢查序列結尾的 OutputEvaluationStep。接著透過「原因」步驟和「變數」子索引標籤回溯,以找出工作人員的決定與您預期的差異為何。 |
此文章是否解決您的問題?
請讓我們知道,以便我們改進!
