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,將結果以「streaming」(串流)方式回傳。事件歷史記錄會保存在伺服器端,並可完整擷取。
引導或中斷
在執行過程中傳送額外的使用者事件以引導代理,或中斷它以改變方向。
Claude Managed Agents 最適合需要以下條件的工作負載:
Claude Managed Agents 讓 Claude 能夠存取一組內建工具:
請參閱工具以取得完整清單與設定選項。
若要開始使用,您需要:
managed-agents-2026-04-01 beta 標頭在 beta 版中,MCP 通道與 dreaming 處於較為受限的研究預覽階段。請申請存取權限以啟用它們。
Claude Managed Agents 在設計上即為有狀態:工作階段可長時間執行、在暫停後順利恢復,並將對話歷史記錄、沙箱狀態與輸出儲存於伺服器端。因此,Managed Agents 目前不符合零資料保留或 HIPAA 商業夥伴協議(BAA)的涵蓋資格。您仍保有對這些資料的控制權:您可以隨時透過 API 刪除工作階段,並另行刪除您上傳的任何檔案。如需了解所有功能的資格,請參閱 API 與資料保留。
Was this page helpful?