Claude Managed Agents 概覽
預先建置、可設定的代理框架，在受管理的基礎設施中執行。最適合長時間執行的任務和非同步工作。
Anthropic 提供兩種使用 Claude 進行建構的方式，各自適用於不同的使用情境：
| Messages API | Claude Managed Agents | |
|---|---|---|
| 這是什麼 | 直接的模型提示存取 | 預先建構、可設定的代理框架（agent harness），在受管理的基礎設施中執行 |
| 最適合 | 自訂代理迴圈與細粒度控制 | 長時間執行的任務與非同步工作 |
Claude Managed Agents 提供將 Claude 作為自主代理執行所需的框架（harness）與基礎設施。您無需自行建置代理迴圈、工具執行與執行環境，即可獲得一個完全受管理的環境，讓 Claude 能夠安全地讀取檔案、執行指令、瀏覽網頁以及執行程式碼。此框架支援內建的「prompt caching」（提示快取）、壓縮（compaction）以及其他效能最佳化，以產出高品質、高效率的代理輸出。若您想改為透過直接存取模型來建置自己的代理迴圈，請參閱使用 Messages API。
核心概念
Claude Managed Agents 圍繞四個概念建構：
| 概念 | 說明 |
|---|---|
| Agent（代理） | 模型、系統提示、工具、MCP 伺服器與技能 |
| Environment（環境） | 工作階段執行位置的設定：由 Anthropic 管理的雲端沙箱，或在您自己的基礎設施上自行託管的沙箱 |
| Session（工作階段） | 在環境中執行的代理實例，負責執行特定任務並產生輸出 |
| Events（事件） | 您的應用程式與代理之間交換的訊息（使用者輪次、工具結果、狀態更新） |
運作方式
建立代理
定義模型、「system prompt」（系統提示）、工具、MCP 伺服器與技能。只需建立代理一次，即可在各個工作階段中透過 ID 參照它。
建立環境
設定代理的執行位置：雲端沙箱，或在您自己的基礎設施上的自行託管沙箱。
啟動工作階段
啟動一個參照您的代理與環境設定的工作階段。
傳送事件並串流回應
以事件形式傳送使用者訊息。Claude 會自主執行工具，並透過「server-sent events」（伺服器傳送事件），即 SSE，將結果串流回傳。事件歷史記錄會保存在伺服器端，並可完整擷取。
引導或中斷
在執行過程中傳送額外的使用者事件以引導代理，或中斷它以改變方向。
何時使用 Claude Managed Agents
Claude Managed Agents 最適合具有以下需求的工作負載：
- 長時間執行： 執行數分鐘或數小時、包含多次工具呼叫的任務
- 雲端基礎設施： 具備預先安裝套件與網路存取的安全沙箱
- 自行託管執行： 在您所控制的基礎設施上執行沙箱，以滿足合規或資料落地要求
- 最少的基礎設施： 無需自行建置代理迴圈、沙箱或工具執行層
- 具狀態的工作階段： 跨多次互動持續保存的檔案系統與對話歷史記錄
- 排程執行： 透過排程部署依 cron 排程定期執行代理
支援的工具
Claude Managed Agents 讓 Claude 能夠存取一組內建工具：
- Bash： 在沙箱中執行 shell 指令
- 檔案操作： 在沙箱中讀取、寫入、編輯、glob 及 grep 檔案
- 網頁搜尋與擷取： 搜尋網頁並從 URL 擷取內容，可選擇性地限制於網域允許清單或封鎖清單
- MCP 伺服器： 連接至外部工具提供者
完整清單與設定選項請參閱工具。
Beta 存取
若要開始使用，您需要：
- 一組 Claude API 金鑰
- 在所有請求中加上
managed-agents-2026-04-01beta 標頭 - Claude Managed Agents 的存取權限（所有 API 帳戶預設皆已啟用）
在 beta 版中，MCP 通道與夢境（dreaming）處於更為有限的研究預覽階段。請申請存取權限以啟用它們。
Claude Managed Agents 在設計上即為具狀態的：工作階段可長時間執行、在暫停後順利恢復，並將對話歷史記錄、沙箱狀態與輸出儲存於伺服器端。因此，Managed Agents 目前不符合零資料保留或 HIPAA 商業夥伴協議（BAA）的涵蓋資格。您仍保有對這些資料的控制權：您可以隨時透過 API 刪除工作階段，並另行刪除您上傳的任何檔案。關於所有功能的資格，請參閱 API 與資料保留。
Was this page helpful?