鏈路追蹤與工作階段

把一次 agent 執行看成一條時間軸,把一整段對話看成一個工作階段:哪些呼叫是並行的、時間花在哪裡、哪裡出錯、花了多少錢。

在控制台側邊欄(該功能適用於你的帳戶時才會出現): Traces 開啟 ↗

操作步驟

同一次執行(一次使用者請求、一個 agent 任務)裡的每個呼叫都帶上 X-Trace-Id,用 X-Span-Id 為每個呼叫命名,同一段對話的每個呼叫都帶上 X-Session-Id。自帶 trace 或工作階段標頭的工具(例如 Claude Code)不需改動就能歸組。
開啟鏈路追蹤。這裡列出最近 7 天的 trace 和工作階段,以及各自的呼叫次數、時長和花費,最近有請求的排在最前;點選欄位標題可以依該欄排序。在 trace 或工作階段頁面點重新命名可以幫它取個名字,工作區內所有人都看得到。搜尋可以輸入完整的 ID,也可以輸入名稱中的任一段。
開啟一個 trace 就能看到瀑布圖:每個呼叫一條橫條,依時間排列,你自己的程式碼在執行的那段時間顯示為你的應用程式。並行的呼叫會重疊顯示。失敗的呼叫帶斜紋並標出狀態碼;選取一個呼叫可看到它的延遲、token 和花費。
開啟一個工作階段可以看到它的彙總、用到的模型、依狀態碼統計的錯誤,以及呼叫隨時間的分布。在日誌中查看這些呼叫會列出這個工作階段的每一個請求。

trace 和工作階段是根據你的請求日誌彙總出來的,所以涵蓋的是同樣的 90 天、同樣的呼叫。
失敗呼叫顯示的是你的程式碼實際收到的狀態碼,包括供應商回傳的錯誤。
ID 由你自己決定:每個最多 128 個可列印 ASCII 字元。它們會回顯在回應裡,不會傳給供應商。
如果程式設計 agent 標明了它的子 agent,工作階段頁會列出各個 agent 及其呼叫數和花費,鏈路裡會標出壓縮和輔助呼叫,並寫出兩次呼叫之間執行的工具。
閘道重試過的請求,會在詳情裡列出每次嘗試的模型、狀態碼和耗時。瀑布圖裡,失敗的嘗試畫成這筆呼叫開頭的斜紋段。

同一項功能的 API 參考: 請求標頭