---
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
  zdr:
    eligibility: not-eligible
    note: 不具 ZDR 適用資格，自行託管的 Managed Agents 除外。工作階段是具狀態的資源；對話記錄會保留至您將其刪除為止。
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
---

使用 Claude Console 中的工作階段檢視器來檢查代理在工作階段中做了什麼，無需撰寫任何程式碼。使用工作階段的 `usage` (csharp, go: `Usage`) 總計來查看這些工作消耗了多少資源。若要在您的可觀測性平台中查看工作階段的回合、模型請求和工具使用，請設定 [OpenTelemetry 追蹤](https://platform.claude.com/docs/zh-TW/manage-claude/opentelemetry)。

## 在 Console 中檢查工作階段

工作階段檢視器僅供 Developer 和 Admin 存取。若要開啟它，請前往 Claude Console 中的[工作階段](https://platform.claude.com/sessions)頁面（`platform.claude.com/sessions`）。清單會顯示工作區中的每個工作階段，以及其狀態、代理、token 用量、成本、建立者和建立時間。選取一個工作階段即可開啟它。

工作階段檢視器會顯示：

* **時間軸小地圖：** 可縮放的工作階段活動時間總覽，在[多代理](https://platform.claude.com/docs/zh-TW/managed-agents/multiagent-orchestration)工作階段中，每個執行緒各有一條軌道。選取一條軌道即可檢視該執行緒，或選取一個標記以跳至其事件。
* **逐字稿：** 依模型請求分組的對話，包括思考內容、工具呼叫及其輸入與結果，以及串流中的訊息文字。您可以篩選事件，並將其複製或下載為 JSON。
* **檢查器：** 可調整大小的側邊面板，以五個分頁顯示工作階段的詳細資訊。

| 檢查器分頁 | 顯示內容 |
| ----- | ----- |
| **工作階段** | 工作階段的詳細資訊與中繼資料、其隨時間累計的成本，以及在設定了工作階段[預算](https://platform.claude.com/docs/zh-TW/managed-agents/budgets)時相對於預算的支出。 |
| **事件** | 目前執行緒上的每個原始事件，依伺服器傳送的順序排列。選取一個事件即可查看其 JSON。在頁面開啟期間串流的訊息，還會有一個**差異**檢視，顯示其[事件增量](https://platform.claude.com/docs/zh-TW/managed-agents/event-deltas)。 |
| **工具** | 工作階段的代理所設定的工具，以及呼叫次數、失敗次數和中位數持續時間。選取一個工具即可查看其呼叫，並跳至對話記錄中的某次呼叫。 |
| **資源** | 掛載於其容器路徑的[檔案](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)。 |
| **討論串** | 每個執行緒及其狀態、上下文大小和成本。選取一個執行緒即可檢視其詳細資訊，例如代理、模型、上下文用量和成本。 |

在工作階段 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` (csharp, go: `Usage`) 也帶有 `list_cost` (java, php: `listCost`; csharp, go: `ListCost`) 和 `active_seconds` (java, php: `activeSeconds`; csharp, go: `ActiveSeconds`)。各執行緒的數值會獨立四捨五入，且不包含工作階段的執行時間成本，因此其總和不會完全等於工作階段的 `list_cost` (java, php: `listCost`; csharp, go: `ListCost`)。以工作階段的數值為準。

### 從串流讀取用量

您不必輪詢工作階段即可觀察這些總計。`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)，了解這在串流上的呈現方式。

### 查看整個組織的工作階段用量

工作階段用量會計入您組織在 Claude Console 中[使用量](https://platform.claude.com/usage)頁面（`platform.claude.com/usage`）和[費用](https://platform.claude.com/cost)頁面（`platform.claude.com/cost`）上的總計。若要依代理查看 token 用量，請在**使用量**頁面上將**分組依據**設定為**代理**。

若要依代理或依工作階段查看工作階段用量，請使用[用量與成本分析 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-analytics-api)，並依 `agent_id` 或 `session_id` 分組。工作階段用量也會出現在舊版[用量與成本 API](https://platform.claude.com/docs/zh-TW/manage-claude/usage-cost-api) 的[用量報告](https://platform.claude.com/docs/zh-TW/api/beta/organization/usage_report/retrieve_messages)中。若要查看其記錄在哪個帳戶之下，請依下列其中一個欄位將該報告分組：

* **`account_id`：** 啟動該工作階段的成員。這涵蓋在 Console 中啟動，或使用範圍限於單一工作區的[個人金鑰](https://platform.claude.com/docs/zh-TW/manage-claude/authentication#key-types)啟動的工作階段。
* **`service_account_id`：** 由 Anthropic 管理的服務帳戶（`svac_...`）。這涵蓋使用工作區金鑰或由[部署](https://platform.claude.com/docs/zh-TW/managed-agents/scheduled-deployments)啟動的工作階段。對於此類用量，`api_key_id` 和 `account_id` 為 `null`。

Anthropic 會在每個執行工作階段的工作區中建立一個這樣的服務帳戶。它不會與您建立的服務帳戶一起列出，Admin API 的服務帳戶端點也不會傳回它。在**使用量**頁面上，**帳戶**篩選器會以其 ID 列出它。當您將**分組依據**設定為 **API 金鑰**時，其用量會標示為**託管代理程式**。

若要查看是誰啟動了工作階段，請查看[工作階段](https://platform.claude.com/sessions)頁面上的**建立者**欄位。

## 除錯技巧

* **檢查工作階段事件：** 工作階段會透過 [`session.error`](https://platform.claude.com/docs/zh-TW/managed-agents/reference#event-types) 事件回報錯誤。
* **檢閱工具結果：** 工具失敗通常能解釋代理的非預期行為。Inspector 的**工具**分頁會顯示每個工具的失敗情形。
* **使用系統提示：** 在系統提示中加入記錄指示，讓代理摘要說明其執行的動作與發現的結果。
* **預覽疑難排解：** 如果選擇接收事件增量的串流行為不如預期，請參閱[預覽疑難排解](https://platform.claude.com/docs/zh-TW/managed-agents/event-deltas#troubleshoot-previews)。

## 後續步驟

<CardGroup cols={2}>
  <Card title="工作階段事件串流" icon="lightning" href="https://platform.claude.com/docs/zh-TW/managed-agents/events-and-streaming">
    傳送事件、串流回應，並在工作階段執行期間中斷或重新導向工作階段。
  </Card>

  <Card title="工作階段預算" icon="coins" href="https://platform.claude.com/docs/zh-TW/managed-agents/budgets">
    以按公開定價費率強制執行的硬性美元預算，為工作階段的支出設定上限。
  </Card>
</CardGroup>

## 可用性

工作階段檢視器在所有模型上處於 Beta 階段。

### API 支援

#### [Managed Agents](https://platform.claude.com/docs/zh-TW/managed-agents/overview)

* 可用性：永遠開啟

| 狀態 | 雲端平台 |
| ----- | ----- |
| Beta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws) |

### 必要的 Beta 標頭

[Beta 標頭概覽](https://platform.claude.com/docs/zh-TW/api/beta-headers)

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

* `managed-agents-2026-04-01`

### 資料處理

[資料處理概覽](https://platform.claude.com/docs/zh-TW/manage-claude/api-and-data-retention#feature-eligibility)

| 項目 | 零資料保留 | HIPAA |
| ----- | ----- | ----- |
| 狀態 | 不符合資格 | 不符合資格 |
| 詳細資訊 | 不具 ZDR 適用資格，自行託管的 Managed Agents 除外。工作階段是具狀態的資源；對話記錄會保留至您將其刪除為止。 [深入了解](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | 不具 HIPAA 適用資格。適用於所有 Managed Agents 子功能。 |

適用端點：

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
