Claude Platform Docs
Managed Agents將工作委派給您的代理

檢查工作階段並追蹤用量

在 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 支援

用法

永遠開啟

狀態Beta
雲端平台

必要的 Beta 標頭

Beta 標頭概覽

Beta 標頭可讓您在實驗性功能與新模型能力成為標準 API 的一部分之前搶先存取。

標頭
  • managed-agents-2026-04-01

資料處理

資料處理概覽

適用端點

  • /v1/agents
  • /v1/sessions
  • /v1/environments
零資料保留不符合資格

工作階段是具狀態的資源;對話記錄會保留至您將其刪除為止。適用於所有 Managed Agents 子功能,包括自行託管沙箱。

HIPAA不符合資格

適用於所有 Managed Agents 子功能,包括自行託管沙箱。

這個頁面有幫助嗎?