託管代理第一步

Claude Managed Agents 概覽

預先建置、可配置的代理框架，在託管基礎設施中執行。最適合長時間執行的任務和非同步工作。

Anthropic 提供兩種使用 Claude 進行建構的方式，各自適用於不同的使用情境：

	Messages API	Claude Managed Agents
說明	直接存取模型提示功能	預先建構、可配置的代理框架，在託管基礎架構中執行
最適合	自訂代理迴圈與細粒度控制	長時間執行的任務與非同步工作
了解更多	Messages API 文件	Claude Managed Agents 文件

Claude Managed Agents 提供將 Claude 作為自主代理執行所需的框架和基礎設施。您無需自行建置代理迴圈、工具執行和執行環境，即可獲得一個完全託管的環境，讓 Claude 能夠安全地讀取檔案、執行命令、瀏覽網頁和執行程式碼。此框架支援內建的提示快取、壓縮以及其他效能最佳化功能，以產出高品質、高效率的代理輸出。

Claude Managed Agents 也可在 AWS 上的 Claude Platform 中使用，但在功能可用性和工作階段行為方面有一些差異。請參閱 AWS 上的 Claude Platform 指南中的 Claude Managed Agents。

快速入門

建立您的第一個代理工作階段

啟動工作階段

建立工作階段並傳送您的第一個事件

參考資料

事件類型、速率限制、CLI 旗標及其他查詢表

核心概念

Claude Managed Agents 建立在四個概念之上：

概念	說明
Agent（代理）	模型、系統提示、工具、MCP 伺服器與技能
Environment（環境）	工作階段執行位置的設定：由 Anthropic 管理的雲端沙箱，或在您自己的基礎架構上自行託管的沙箱
Session（工作階段）	在環境中執行的代理實例，用於執行特定任務並產生輸出
Events（事件）	您的應用程式與代理之間交換的訊息（使用者回合、工具結果、狀態更新）

運作方式

建立代理
定義模型、系統提示、工具、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 Managed Agents 目前處於 beta 階段。所有 Managed Agents 端點都需要 managed-agents-2026-04-01 beta 標頭。SDK 會自動設定 beta 標頭。各版本之間可能會調整行為以改善輸出。

若要開始使用，您需要：

一個 Claude API 金鑰
在所有請求上加入 managed-agents-2026-04-01 beta 標頭
Claude Managed Agents 的存取權限（所有 API 帳戶預設啟用）

在 beta 階段中，MCP 通道和 dreaming 處於更受限的研究預覽階段。請申請存取權限以啟用這些功能。

Claude Managed Agents 在設計上是有狀態的：工作階段為長時間執行、在暫停後可乾淨地恢復，並在伺服器端儲存對話歷史記錄、沙箱狀態和輸出。因此，Managed Agents 目前不符合零資料保留或 HIPAA 商業夥伴協議（BAA）的涵蓋資格。您仍保有對這些資料的控制權：您可以隨時透過 API 刪除工作階段，並單獨刪除您上傳的任何檔案。有關所有功能的資格，請參閱 API 和資料保留。

請參閱參考資料中的速率限制和品牌指南。

Was this page helpful?

託管代理第一步

Claude Managed Agents 概覽

預先建置、可配置的代理框架，在託管基礎設施中執行。最適合長時間執行的任務和非同步工作。

Anthropic 提供兩種使用 Claude 進行建構的方式，各自適用於不同的使用情境：

	Messages API	Claude Managed Agents
說明	直接存取模型提示功能	預先建構、可配置的代理框架，在託管基礎架構中執行
最適合	自訂代理迴圈與細粒度控制	長時間執行的任務與非同步工作
了解更多	Messages API 文件	Claude Managed Agents 文件

快速入門

建立您的第一個代理工作階段

啟動工作階段

建立工作階段並傳送您的第一個事件

參考資料

事件類型、速率限制、CLI 旗標及其他查詢表

核心概念

Claude Managed Agents 建立在四個概念之上：

概念	說明
Agent（代理）	模型、系統提示、工具、MCP 伺服器與技能
Environment（環境）	工作階段執行位置的設定：由 Anthropic 管理的雲端沙箱，或在您自己的基礎架構上自行託管的沙箱
Session（工作階段）	在環境中執行的代理實例，用於執行特定任務並產生輸出
Events（事件）	您的應用程式與代理之間交換的訊息（使用者回合、工具結果、狀態更新）

運作方式

建立代理
定義模型、系統提示、工具、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-01 beta 標頭
Claude Managed Agents 的存取權限（所有 API 帳戶預設啟用）

在 beta 階段中，MCP 通道和 dreaming 處於更受限的研究預覽階段。請申請存取權限以啟用這些功能。

請參閱參考資料中的速率限制和品牌指南。

Was this page helpful?

核心概念

運作方式

何時使用 Claude Managed Agents

支援的工具

Beta 存取

核心概念

運作方式

何時使用 Claude Managed Agents

支援的工具

Beta 存取

核心概念

運作方式

何時使用 Claude Managed Agents

支援的工具

Beta 存取

核心概念

運作方式

何時使用 Claude Managed Agents

支援的工具

Beta 存取