在 Microsoft Copilot Studio 中，使用 GitHub Copilot 架構驅動的代理程式中的活動追蹤，會精確顯示代理如何處理每則訊息。 用它來了解您的代理如何進行思維鏈式推理、驗證知識來源歸因、確認工具執行情況，以及對錯誤進行疑難排解。
Note
本文中的功能由由 GitHub Copilot 架構驅動的代理程式或工作流程所使用。
按使用量計費適用於代理程式的使用、建置、測試與評估。 這些行動可能會消耗 Copilot 點數。 在「管理由 GitHub Copilot 驅動的代理人員成本」中了解更多。
Prerequisites
- 使用 GitHub Copilot harness 建立的代理程式
- 預覽版索引標籤中至少有一則測試交談
開啟活動追蹤
在 Copilot Studio 中開啟您的 Agent，然後選取預覽版索引標籤。
確保終端使用者預覽切換開關為關閉 (預設的製作者視圖)。 活動追蹤會顯示在聊天窗格旁，詳細顯示每則訊息的處理細節。
傳送訊息給您的代理程式。 追蹤會在 Agent 處理訊息時即時更新。
了解追蹤
活動追蹤會顯示您 Agent 處理過程的思路鏈 (CoT) 檢視。 活動追蹤中的每個步驟都以節點形式顯示 Agent 執行的動作與原因。
節點類型
追蹤可包含以下節點類型：
| 節點類型 | 它顯示的內容 |
|---|---|
| 用戶訊息 | 傳送給 Agent 的訊息 |
| 代理程式回應 | 代理程式產生的回應 |
| 知識 | 代理程式為提供依據而查閱的知識來源。 呈現為「已搜尋知識」的可摺疊卡片，顯示每個已存取知識來源的來源，並附上引用連結 (若有)。 |
| 已執行動作 | 連接器或工具呼叫以可摺疊卡片呈現，顯示連接器、填入的輸入參數及傳遞期間 |
| Tool | 代理程式用來呼叫以執行動作或擷取資料的工具 |
| 連接器 | 代理程式用來存取外部資料的連接器 |
| 流程 | 已觸發的 Agent 流程 |
| 技能 | 已執行的技能 |
| Error | 處理期間發生錯誤 |
| 完成 | 在所有工具呼叫完成後，追蹤底部會顯示綠色勾號指示器 |
查看節點詳情
選取追蹤中的任一節點以展開其詳細資料。
檢閱所顯示的資訊，可能包括：
- 代理程式傳送至此步驟的輸入
- 傳回的輸出或結果
- 處理時間與指標
- 步驟失敗時的錯誤細節
對知識來源問題進行偵錯
當您的代理程式使用知識回答問題時，追蹤記錄會顯示查閱了哪些來源：
在追蹤中尋找知識節點。
檢閱來源，以查看已存取哪些知識來源。
選取來源以查看所檢索的特定內容。
驗證 Agent 已使用正確的來源，且檢索的內容相關。
如果 Agent 用了錯誤的來源或傳回不準確的資訊，請檢查您在建置索引標籤中的知識組態。
偵錯工具執行
當您的 Agent 叫用工具時，追蹤會顯示執行詳細資料：
在追蹤中尋找工具、連接器、流程或技能節點。
檢閱執行詳細資料，包括輸入參數與輸出結果。
驗證叫用正確的工具，且結果如預期。
如果工具執行失敗，請在該節點中查看錯誤詳細資料。
若要重新設定工具，請開啟建置索引標籤，並在 Agent 的組態中找出該工具。
錯誤排除
處理過程中發生錯誤時，追蹤會反白顯示這些錯誤：
在追蹤中尋找標有錯誤指示的節點。
選取錯誤節點以檢視錯誤詳細資料，包括錯誤訊息與上下文。
常見問題包括：
- 工具或連接器的驗證失敗
- 知識來源存取錯誤
- 長時間執行之工具呼叫的逾時錯誤
- 內容審核旗標
在建置索引標籤或設定中解決根本原因，然後再重新測試。
從追蹤瀏覽至建置索引標籤
活動追蹤會與建置索引標籤整合，方便快速編輯。
在追蹤中選取任何來源、工具或元件。
Copilot Studio 會瀏覽至 建置 索引標籤中的對應元件。
完成變更後，返回到預覽索引標籤以重新測試。