檢查工作階段並追蹤用量
在 Claude Console 中檢查工作階段、讀取其 token 用量與定價成本,並對非預期的代理行為進行除錯。
使用 Claude Console 中的工作階段檢視器來檢查代理在工作階段中做了什麼,無需撰寫任何程式碼。使用工作階段的 usage 總計來查看這些工作消耗了多少資源。若要在您的可觀測性平台中查看工作階段的回合、模型請求和工具使用,請設定 OpenTelemetry 追蹤。
在 Console 中檢查工作階段
工作階段檢視器僅供 Developer 和 Admin 存取。若要開啟它,請前往 Claude Console 中的工作階段頁面(platform.claude.com/sessions)。清單會顯示工作區中的每個工作階段,以及其狀態、代理、token 用量、成本、建立者和建立時間。選取一個工作階段即可開啟它。
工作階段檢視器會顯示:
- 時間軸小地圖: 可縮放的工作階段活動時間總覽,在多代理工作階段中,每個執行緒各有一條軌道。選取一條軌道即可檢視該執行緒,或選取一個標記以跳至其事件。
- 逐字稿: 依模型請求分組的對話,包括思考內容、工具呼叫及其輸入與結果,以及串流中的訊息文字。您可以篩選事件,並將其複製或下載為 JSON。
- 檢查器: 可調整大小的側邊面板,以五個分頁顯示工作階段的詳細資訊。
| 檢查器分頁 | 顯示內容 |
|---|---|
| 工作階段 | 工作階段的詳細資訊與中繼資料、其隨時間累計的成本,以及在設定了工作階段預算時相對於預算的支出。 |
| 事件 | 目前執行緒上的每個原始事件,依伺服器傳送的順序排列。選取一個事件即可查看其 JSON。在頁面開啟期間串流的訊息,還會有一個差異檢視,顯示其事件增量。 |
| 工具 | 工作階段的代理所設定的工具,以及呼叫次數、失敗次數和中位數持續時間。選取一個工具即可查看其呼叫,並跳至對話記錄中的某次呼叫。 |
| 資源 | 掛載於其容器路徑的檔案、儲存庫和記憶儲存區,包括每個儲存區中的記憶,以及此工作階段對其所做的變更。也會列出代理寫入 /mnt/session/outputs 的檔案,以及附加至工作階段代理的技能。 |
| 討論串 | 每個執行緒及其狀態、上下文大小和成本。選取一個執行緒即可檢視其詳細資訊,例如代理、模型、上下文用量和成本。 |
在工作階段 URL 後附加 ?event={event_id},即可在特定事件處開啟該工作階段。
透過 ant beta:sessions connect,您可以從 ant CLI 開啟相同的檢視器,或在終端機中追蹤工作階段。請參閱從終端機連線至 Managed Agents 工作階段。
追蹤用量
工作階段物件包含一個 usage 欄位,記錄該工作階段的累計用量:token 數量、伺服器工具使用、活躍時間,以及追蹤的定價成本。請在工作階段進入閒置狀態後擷取該工作階段,以讀取最新的總計數值。
{
"id": "sesn_01...",
"status": "idle",
"usage": {
"input_tokens": 5000,
"output_tokens": 3200,
"cache_read_input_tokens": 20000,
"cache_creation": {
"ephemeral_5m_input_tokens": 2000,
"ephemeral_1h_input_tokens": 0
},
"list_cost": {
"amount": "187",
"currency": "USD"
},
"active_seconds": 342.5,
"server_tool_use": {
"web_search_requests": 3,
"web_fetch_requests": 0
}
}
}| 欄位 | 說明 |
|---|---|
input_tokens | 工作階段中所有模型呼叫的未快取輸入 token。 |
output_tokens | 工作階段中所有模型呼叫的輸出 token 總數。 |
cache_read_input_tokens | 從提示快取讀取的 token。 |
cache_creation | 快取建立 token,依快取存留期細分(ephemeral_5m_input_tokens 和 ephemeral_1h_input_tokens)。 |
list_cost | 以公開定價計算的工作階段累計消耗,以字串形式表示的整數美分數,並附帶貨幣代碼。 |
active_seconds | 工作階段至少有一個執行緒在執行的累計時間。並行執行緒的重疊活動只計算一次。工作階段的執行時間成本依此持續時間計價。 |
server_tool_use | 伺服器執行之工具請求的計數,用於計價。網頁搜尋請求會按每次請求計入定價成本。網頁擷取請求不收取每次請求費用且不計量,因此 web_fetch_requests 的值為 0。 |
快取項目預設使用 5 分鐘的 TTL,因此在該時間範圍內連續進行的回合可受益於快取讀取,從而降低每個 token 的成本。
工作階段的 stats 物件有其自己的 active_seconds,它會加總每個執行緒各自的活動時間,而不是將重疊活動只計算一次。
每個執行緒的用量
每個工作階段執行緒本身的 usage 也帶有 list_cost 和 active_seconds。各執行緒的數值會獨立四捨五入,且不包含工作階段的執行時間成本,因此其總和不會完全等於工作階段的 list_cost。以工作階段的數值為準。
從串流讀取用量
您不必輪詢工作階段即可觀察這些總計。session.usage 事件會在工作階段串流和事件歷史記錄中帶有相同的累計快照。該快照包含 usage 物件,若工作階段有預算,還會包含工作階段的 budget。
此事件是在閒置轉換時發出,而非依計時器發出:
- 工作階段會在進入閒置狀態前立即發出一次,無論停止原因為何。
- 當執行緒因工作階段預算而暫停時,工作階段會發出一次。
強制執行支出上限
若要強制執行支出上限,請設定工作階段預算,而不是自行輪詢用量並停止工作階段。平台會持續為工作階段的消耗計價,並在定價成本達到上限後,於每個執行緒的下一次模型請求之前將其暫停。請參閱當工作階段達到預算時,了解這在串流上的呈現方式。
查看整個組織的工作階段用量
工作階段用量會計入您組織在 Claude Console 中使用量頁面(platform.claude.com/usage)和費用頁面(platform.claude.com/cost)上的總計。若要依代理查看 token 用量,請在使用量頁面上將分組依據設定為代理。
若要依代理或依工作階段查看工作階段用量,請使用用量與成本分析 API,並依 agent_id 或 session_id 分組。工作階段用量也會出現在舊版用量與成本 API 的用量報告可檢視預覽,內含 API 參考文件連結——按 Tab 鍵直到焦點進入卡片,按 Escape 鍵返回。中。若要查看其記錄在哪個帳戶之下,請依下列其中一個欄位將該報告分組:
account_id: 啟動該工作階段的成員。這涵蓋在 Console 中啟動,或使用範圍限於單一工作區的個人金鑰啟動的工作階段。service_account_id: 由 Anthropic 管理的服務帳戶(svac_...)。這涵蓋使用工作區金鑰或由部署啟動的工作階段。對於此類用量,api_key_id和account_id為null。
Anthropic 會在每個執行工作階段的工作區中建立一個這樣的服務帳戶。它不會與您建立的服務帳戶一起列出,Admin API 的服務帳戶端點也不會傳回它。在使用量頁面上,帳戶篩選器會以其 ID 列出它。當您將分組依據設定為 API 金鑰時,其用量會標示為託管代理程式。
若要查看是誰啟動了工作階段,請查看工作階段頁面上的建立者欄位。
除錯技巧
- 檢查工作階段事件: 工作階段會透過
session.error事件回報錯誤。 - 檢閱工具結果: 工具失敗通常能解釋代理的非預期行為。Inspector 的工具分頁會顯示每個工具的失敗情形。
- 使用系統提示: 在系統提示中加入記錄指示,讓代理摘要說明其執行的動作與發現的結果。
- 預覽疑難排解: 如果選擇接收事件增量的串流行為不如預期,請參閱預覽疑難排解。
後續步驟
可用性
工作階段檢視器在所有模型上處於 Beta 階段。
API 支援
用法
永遠開啟
- Claude API
- Claude Platform on AWS
必要的 Beta 標頭
Beta 標頭概覽Beta 標頭可讓您在實驗性功能與新模型能力成為標準 API 的一部分之前搶先存取。
managed-agents-2026-04-01
資料處理
資料處理概覽適用端點
/v1/agents/v1/sessions/v1/environments
工作階段是具狀態的資源;對話記錄會保留至您將其刪除為止。適用於所有 Managed Agents 子功能,包括自行託管沙箱。
適用於所有 Managed Agents 子功能,包括自行託管沙箱。
這個頁面有幫助嗎?