Anthropic 提供兩種使用 Claude 進行建構的方式,各自適用於不同的使用情境:
| Messages API | Claude Managed Agents | |
|---|---|---|
| 說明 | 直接存取模型提示功能 | 預先建構、可配置的代理框架,在託管基礎架構中執行 |
| 最適合 | 自訂代理迴圈與細粒度控制 | 長時間執行的任務與非同步工作 |
| 了解更多 | Messages API 文件 | Claude Managed Agents 文件 |
Claude Managed Agents 提供將 Claude 作為自主代理執行所需的框架(harness)和基礎設施。您無需自行建置代理迴圈、工具執行和執行環境,而是獲得一個完全受管理的環境,讓 Claude 可以安全地讀取檔案、執行命令、瀏覽網頁和執行程式碼。此框架支援內建的提示快取(prompt caching)、壓縮(compaction)以及其他效能最佳化,以產生高品質、高效率的代理輸出。
Claude Managed Agents 圍繞四個概念建構:
| 概念 | 說明 |
|---|---|
| Agent(代理) | 模型、系統提示、工具、MCP 伺服器與技能 |
| Environment(環境) | 工作階段執行位置的設定:由 Anthropic 管理的雲端沙箱,或在您自己的基礎架構上自行託管的沙箱 |
| Session(工作階段) | 在環境中執行的代理實例,用於執行特定任務並產生輸出 |
| Events(事件) | 您的應用程式與代理之間交換的訊息(使用者回合、工具結果、狀態更新) |
建立代理
定義模型、系統提示、工具、MCP 伺服器和技能。只需建立代理一次,即可在多個工作階段中透過 ID 參照它。
建立環境
配置代理的執行位置:雲端沙箱,或在您自己的基礎設施上的自架沙箱。
啟動工作階段
啟動一個參照您的代理和環境配置的工作階段。
傳送事件並串流回應
以事件形式傳送使用者訊息。Claude 會自主執行工具,並透過「server-sent events」(伺服器推送事件),即 SSE,串流回傳結果。事件歷史記錄會保存在伺服器端,並可完整擷取。
引導或中斷
在執行過程中傳送額外的使用者事件來引導代理,或中斷它以改變方向。
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?