第一步

Claude Managed Agents 概述

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

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

Claude Managed Agents 提供了運行 Claude 作為自主代理程序的框架和基礎設施。與其構建自己的代理程序循環、工具執行和運行時不同，您可以獲得一個完全託管的環境，其中 Claude 可以讀取文件、運行命令、瀏覽網頁並安全地執行代碼。該框架支持內置提示詞快取、壓縮和其他性能優化，以實現高質量、高效的代理程序輸出。

快速入門

建立您的第一個代理程序會話

API 參考

完整的端點文檔

核心概念

Claude Managed Agents 圍繞四個概念構建：

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

工作原理

建立代理程序
定義模型、系統提示詞、工具、MCP 伺服器和技能。建立一次代理程序並在會話中通過 ID 引用它。
建立環境
配置一個雲容器，預先安裝套件（Python、Node.js、Go 等）、網路存取規則和掛載的文件。
啟動會話
啟動一個引用您的代理程序和環境配置的會話。
發送事件並串流回應
將使用者訊息作為事件發送。Claude 自主執行工具並通過伺服器發送事件（SSE）串流回結果。事件歷史記錄在伺服器端保留，可以完整獲取。
引導或中斷
發送額外的使用者事件以在執行過程中引導代理程序，或中斷它以改變方向。

何時使用 Claude Managed Agents

Claude Managed Agents 最適合需要以下功能的工作負載：

長時間運行執行 - 運行數分鐘或數小時且具有多個工具呼叫的任務
雲基礎設施 - 具有預先安裝套件和網路存取的安全容器
最小基礎設施 - 無需構建自己的代理程序循環、沙箱或工具執行層
有狀態會話 - 跨多個互動的持久文件系統和對話歷史記錄

支援的工具

Claude Managed Agents 為 Claude 提供了一套全面的內置工具：

Bash - 在容器中運行 shell 命令
文件操作 - 在容器中讀取、寫入、編輯、全域搜尋和 grep 文件
網頁搜尋和擷取 - 搜尋網頁並從 URL 檢索內容
MCP 伺服器 - 連接到外部工具提供者

請參閱工具以了解完整列表和配置選項。

測試版存取

Claude Managed Agents 目前處於測試版。所有 Managed Agents 端點都需要 managed-agents-2026-04-01 測試版標頭。SDK 會自動設定測試版標頭。行為可能會在版本之間進行調整以改進輸出。

要開始使用，您需要：

一個 Claude API 金鑰
上述所有請求的測試版標頭
存取 Claude Managed Agents（預設為所有 API 帳戶啟用）

某些功能（結果、多代理程序和記憶）處於研究預覽版。請求存取以試用它們。

速率限制

Managed Agents 端點按組織進行速率限制：

操作	限制
建立端點（代理程序、會話、環境等）	每分鐘 60 個請求
讀取端點（檢索、列表、串流等）	每分鐘 600 個請求

組織級別的支出限制和基於層級的速率限制也適用。

品牌指南

對於整合 Claude Managed Agents 的合作夥伴，使用 Claude 品牌是可選的。在您的產品中引用 Claude 時：

允許：

"Claude Agent"（下拉菜單首選）
"Claude"（當已在標記為"Agents"的菜單中時）
"{YourAgentName} Powered by Claude"（如果您有現有的代理程序名稱）

不允許：

"Claude Code" 或 "Claude Code Agent"
"Claude Cowork" 或 "Claude Cowork Agent"
Claude Code 品牌 ASCII 藝術或模仿 Claude Code 的視覺元素

您的產品應保持自己的品牌，不應顯示為 Claude Code、Claude Cowork 或任何其他 Anthropic 產品。如有關於品牌合規性的問題，請聯繫 Anthropic 銷售團隊。

Was this page helpful?

第一步

Claude Managed Agents 概述

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

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

快速入門

建立您的第一個代理程序會話

API 參考

完整的端點文檔

核心概念

Claude Managed Agents 圍繞四個概念構建：

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	A configured container template (packages, network access)
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

工作原理

建立代理程序
定義模型、系統提示詞、工具、MCP 伺服器和技能。建立一次代理程序並在會話中通過 ID 引用它。
建立環境
配置一個雲容器，預先安裝套件（Python、Node.js、Go 等）、網路存取規則和掛載的文件。
啟動會話
啟動一個引用您的代理程序和環境配置的會話。
發送事件並串流回應
將使用者訊息作為事件發送。Claude 自主執行工具並通過伺服器發送事件（SSE）串流回結果。事件歷史記錄在伺服器端保留，可以完整獲取。
引導或中斷
發送額外的使用者事件以在執行過程中引導代理程序，或中斷它以改變方向。

何時使用 Claude Managed Agents

Claude Managed Agents 最適合需要以下功能的工作負載：

長時間運行執行 - 運行數分鐘或數小時且具有多個工具呼叫的任務
雲基礎設施 - 具有預先安裝套件和網路存取的安全容器
最小基礎設施 - 無需構建自己的代理程序循環、沙箱或工具執行層
有狀態會話 - 跨多個互動的持久文件系統和對話歷史記錄

支援的工具

Claude Managed Agents 為 Claude 提供了一套全面的內置工具：

Bash - 在容器中運行 shell 命令
文件操作 - 在容器中讀取、寫入、編輯、全域搜尋和 grep 文件
網頁搜尋和擷取 - 搜尋網頁並從 URL 檢索內容
MCP 伺服器 - 連接到外部工具提供者

請參閱工具以了解完整列表和配置選項。

測試版存取

要開始使用，您需要：

一個 Claude API 金鑰
上述所有請求的測試版標頭
存取 Claude Managed Agents（預設為所有 API 帳戶啟用）

某些功能（結果、多代理程序和記憶）處於研究預覽版。請求存取以試用它們。

速率限制

Managed Agents 端點按組織進行速率限制：

操作	限制
建立端點（代理程序、會話、環境等）	每分鐘 60 個請求
讀取端點（檢索、列表、串流等）	每分鐘 600 個請求

組織級別的支出限制和基於層級的速率限制也適用。

品牌指南

對於整合 Claude Managed Agents 的合作夥伴，使用 Claude 品牌是可選的。在您的產品中引用 Claude 時：

允許：

"Claude Agent"（下拉菜單首選）
"Claude"（當已在標記為"Agents"的菜單中時）
"{YourAgentName} Powered by Claude"（如果您有現有的代理程序名稱）

不允許：

"Claude Code" 或 "Claude Code Agent"
"Claude Cowork" 或 "Claude Cowork Agent"
Claude Code 品牌 ASCII 藝術或模仿 Claude Code 的視覺元素

您的產品應保持自己的品牌，不應顯示為 Claude Code、Claude Cowork 或任何其他 Anthropic 產品。如有關於品牌合規性的問題，請聯繫 Anthropic 銷售團隊。

Was this page helpful?