--- title: 檢查工作階段並追蹤用量 url: https://platform.claude.com/docs/zh-TW/managed-agents/session-observability description: 在 Claude Console 中檢查工作階段、讀取其 token 用量與定價成本，並對非預期的代理行為進行除錯。 featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- 使用 Claude Console 中的工作階段檢視器來檢查代理在工作階段中做了什麼，無需撰寫任何程式碼。使用工作階段的 `usage` (csharp, go: `Usage`) 總計來查看這些工作消耗了多少資源。 ## 在 Console 中檢查工作階段 工作階段檢視器僅供 Developer 和 Admin 存取。若要開啟它，請前往 Claude Console 中的 [Sessions](https://platform.claude.com/sessions) 頁面（`platform.claude.com/sessions`）。清單會顯示工作區中的每個工作階段，以及其狀態、代理、token 用量、成本和建立時間。選取一個工作階段即可開啟它。 工作階段檢視器會顯示： * **時間軸縮圖（Timeline minimap）：** 工作階段隨時間推移之活動的可縮放概覽，在 [multiagent](https://platform.claude.com/docs/zh-TW/managed-agents/multiagent-orchestration)（多代理）工作階段中，每個執行緒各有一條軌道。選取一條軌道即可檢視該執行緒，或選取一個標記以跳至其事件。 * **對話記錄（Transcript）：** 依模型請求分組的對話，包括思考、工具呼叫及其輸入與結果，以及串流中的訊息文字。您可以篩選事件，並將其複製或下載為 JSON。 * **檢查器（Inspector）：** 一個可調整大小的側邊面板，以五個分頁顯示工作階段的詳細資訊。 | 檢查器分頁 | 顯示內容 | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Session** | 工作階段的詳細資訊與中繼資料、其隨時間累計的成本，以及在設定了工作階段[預算](https://platform.claude.com/docs/zh-TW/managed-agents/budgets)時相對於預算的支出。 | | **Events** | 目前執行緒上的每個原始事件，依伺服器傳送的順序排列。選取一個事件即可查看其 JSON。在頁面開啟期間串流的訊息，還會有一個 **Deltas** 檢視，顯示其[事件增量](https://platform.claude.com/docs/zh-TW/managed-agents/event-deltas)。 | | **Tools** | 工作階段的代理所設定的工具，以及呼叫次數、失敗次數和中位數持續時間。選取一個工具即可查看其呼叫，並跳至對話記錄中的某次呼叫。 | | **Resources** | 掛載於其容器路徑的[檔案](https://platform.claude.com/docs/zh-TW/managed-agents/files)、[儲存庫](https://platform.claude.com/docs/zh-TW/managed-agents/github)和[記憶儲存區](https://platform.claude.com/docs/zh-TW/managed-agents/memory)，包括每個儲存區中的記憶，以及此工作階段對其所做的變更。也會列出代理寫入 `/mnt/session/outputs` 的檔案，以及附加至工作階段代理的[技能](https://platform.claude.com/docs/zh-TW/managed-agents/skills)。 | | **Threads** | 每個執行緒及其狀態、上下文大小和成本。選取一個執行緒即可檢視其詳細資訊，例如代理、模型、上下文用量和成本。 | 在工作階段 URL 後附加 `?event={event_id}`，即可在特定事件處開啟該工作階段。 透過 `ant beta:sessions connect`，您可以從 `ant` CLI 開啟相同的檢視器，或在終端機中追蹤工作階段。請參閱[從終端機連線至 Managed Agents 工作階段](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/sessions-connect)。 ## 追蹤用量 工作階段物件包含一個 `usage` 欄位，記錄該工作階段的累計用量：token 數量、伺服器工具使用、活躍時間，以及追蹤的定價成本。請在工作階段進入閒置狀態後擷取該工作階段，以讀取最新的總計數值。 ```json { "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`，它會加總每個執行緒各自的活動時間，而不是將重疊活動只計算一次。 ### 每個執行緒的用量 每個[工作階段執行緒](https://platform.claude.com/docs/zh-TW/managed-agents/session-threads)自己的 `usage` 也帶有 `list_cost` 和 `active_seconds`。每個執行緒的數值會各自獨立四捨五入，且不包含工作階段的執行時間成本，因此其加總不會與工作階段的 `list_cost` 完全相符。以工作階段的數值為準。 ### 從串流讀取用量 您不必輪詢工作階段即可觀察這些總計。`session.usage` 事件會在工作階段串流和事件歷史記錄中帶有相同的累計快照。該快照包含 `usage` (csharp, go: `Usage`) 物件，若工作階段有預算，還會包含工作階段的 `budget` (csharp, go: `Budget`)。 此事件是在閒置轉換時發出，而非依計時器發出： * 工作階段會在進入閒置狀態前立即發出一次，無論停止原因為何。 * 當執行緒因[工作階段預算](https://platform.claude.com/docs/zh-TW/managed-agents/budgets)而暫停時，工作階段會發出一次。 ### 強制執行支出上限 若要強制執行支出上限，請設定工作階段預算，而不是自行輪詢用量並停止工作階段。平台會持續為工作階段的消耗計價，並在定價成本達到上限後，於每個執行緒的下一次模型請求之前將其暫停。請參閱[當工作階段達到預算時](https://platform.claude.com/docs/zh-TW/managed-agents/budgets#when-a-session-reaches-its-budget)，了解這在串流上的呈現方式。 ## 除錯技巧 * **檢查工作階段事件：** 工作階段會透過 [`session.error`](https://platform.claude.com/docs/zh-TW/managed-agents/reference#event-types) 事件回報錯誤。 * **檢閱工具結果：** 工具執行失敗通常可以解釋非預期的代理行為。檢查器的 **Tools** 分頁會顯示每個工具的失敗情況。 * **使用系統提示：** 在系統提示中加入記錄指示，讓代理摘要說明它做了什麼以及發現了什麼。 * **預覽疑難排解：** 如果選擇啟用事件增量的串流未如您預期般運作，請參閱[預覽疑難排解](https://platform.claude.com/docs/zh-TW/managed-agents/event-deltas#troubleshoot-previews)。 ## 後續步驟 傳送事件、串流回應，並在執行過程中中斷或重新導向您的工作階段。 以公開定價費率強制執行的硬性美元預算，為工作階段的支出設定上限。