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

檢查工作階段並追蹤用量

在 Claude Console 中檢查工作階段、讀取其 token 用量與定價成本，並對非預期的代理行為進行除錯。

使用 Claude Console 中的工作階段檢視器來檢查代理在工作階段中做了什麼，無需撰寫任何程式碼。使用工作階段的 usage 總計來查看這些工作消耗了多少資源。

在 Console 中檢查工作階段

工作階段檢視器僅供 Developers 和 Admins 存取。若要開啟它，請前往 Console 側邊欄，並在 Managed Agents 下選取 Sessions。清單會顯示工作區中的每個工作階段，以及其狀態、代理、token 用量、成本和建立時間。選取一個工作階段即可開啟。

工作階段檢視器會顯示：

  • 時間軸縮圖（Timeline minimap）： 工作階段隨時間推移之活動的可縮放概覽，在 multiagent（多代理）工作階段中，每個執行緒各有一條軌道。選取一條軌道即可檢視該執行緒，或選取一個標記以跳至其事件。
  • 對話記錄（Transcript）： 依模型請求分組的對話，包括思考、工具呼叫及其輸入與結果，以及串流中的訊息文字。您可以篩選事件，並將其複製或下載為 JSON。
  • 檢查器（Inspector）： 一個可調整大小的側邊面板，以五個分頁顯示工作階段的詳細資訊。
檢查器分頁顯示內容
Session工作階段的詳細資訊與中繼資料、其隨時間累計的成本，以及在設定了工作階段預算時相對於預算的支出。
Events目前執行緒上的每個原始事件，依伺服器傳送的順序排列。選取一個事件即可查看其 JSON。在頁面開啟期間串流的訊息，還會有一個 Deltas 檢視，顯示其事件增量。
Tools工作階段的代理所設定的工具，以及呼叫次數、失敗次數和中位數持續時間。選取一個工具即可查看其呼叫，並跳至對話記錄中的某次呼叫。
Resources掛載於其容器路徑的檔案、儲存庫和記憶儲存區，包括每個儲存區中的記憶，以及此工作階段對其所做的變更。也會列出代理寫入 /mnt/session/outputs 的檔案，以及附加至工作階段代理的技能。
Threads每個執行緒及其狀態、上下文大小和成本。選取一個執行緒即可檢視其詳細資訊，例如代理、模型、上下文用量和成本。

在工作階段 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，若工作階段沒有預算，則為 null。

此事件是在閒置轉換時發出，而非依計時器發出：

  • 工作階段會在進入閒置狀態前立即發出一次，無論停止原因為何。
  • 當執行緒因工作階段預算而暫停時，工作階段會發出一次。

強制執行支出上限

若要強制執行支出上限，請設定工作階段預算，而不是自行輪詢用量並停止工作階段。平台會持續為工作階段的消耗計價，並在定價成本達到上限後，於每個執行緒的下一次模型請求之前將其暫停。請參閱當工作階段達到預算時，了解這在串流上的呈現方式。

除錯技巧

  • 檢查工作階段事件： 工作階段會透過 session.error 事件回報錯誤。
  • 檢閱工具結果： 工具執行失敗通常可以解釋非預期的代理行為。檢查器的 Tools 分頁會顯示每個工具的失敗情況。
  • 使用系統提示： 在系統提示中加入記錄指示，讓代理摘要說明它做了什麼以及發現了什麼。
  • 預覽疑難排解： 如果選擇啟用事件增量的串流未如您預期般運作，請參閱預覽疑難排解。

後續步驟

工作階段事件串流

傳送事件、串流回應，並在執行過程中中斷或重新導向您的工作階段。

工作階段預算

以公開定價費率強制執行的硬性美元預算，為工作階段的支出設定上限。

Was this page helpful?