Claude Managed Agents 概述
在托管基础设施中运行的预构建、可配置的智能体框架。最适合长时间运行的任务和异步工作。
Anthropic 提供两种使用 Claude 进行构建的方式,每种方式适用于不同的使用场景:
| Messages API | Claude Managed Agents | |
|---|---|---|
| 它是什么 | 直接的模型提示访问 | 预构建、可配置的智能体框架,运行在托管基础设施中 |
| 最适合 | 自定义智能体循环和细粒度控制 | 长时间运行的任务和异步工作 |
Claude Managed Agents 提供了将 Claude 作为自主智能体运行所需的 harness(框架)和基础设施。您无需自行构建智能体循环、工具执行和运行时,即可获得一个完全托管的环境,Claude 可以在其中安全地读取文件、运行命令、浏览网页和运行代码。该框架支持内置的 prompt caching(提示缓存)、compaction(压缩)以及其他性能优化,以实现高质量、高效率的智能体输出。如果您希望通过直接访问模型来构建自己的智能体循环,请参阅使用 Messages API。
核心概念
Claude Managed Agents 围绕四个概念构建:
| 概念 | 描述 |
|---|---|
| Agent(智能体) | 模型、系统提示、工具、MCP 服务器和技能 |
| Environment(环境) | 会话运行位置的配置:Anthropic 托管的云沙箱,或在您自己的基础设施上自托管的沙箱 |
| Session(会话) | 在环境中运行的智能体实例,执行特定任务并生成输出 |
| Events(事件) | 您的应用程序与智能体之间交换的消息(用户轮次、工具结果、状态更新) |
工作原理
创建智能体
定义模型、系统提示、工具、MCP 服务器和技能。只需创建一次智能体,即可在各个会话中通过 ID 引用它。
创建环境
配置智能体的运行位置:云沙箱,或在您自己的基础设施上的自托管沙箱。
启动会话
启动一个引用您的智能体和环境配置的会话。
发送事件并流式传输响应
以事件形式发送用户消息。Claude 会自主运行工具,并通过 “server-sent events”(服务器发送事件),即 SSE,以流式传输方式返回结果。Managed Agents 服务会保存事件历史记录,您可以完整获取。
引导或中断
在智能体运行时发送额外的用户事件来引导它,或中断它以改变方向。
何时使用 Claude Managed Agents
Claude Managed Agents 最适合具有以下需求的工作负载:
- 长时间运行的执行: 运行数分钟或数小时、涉及多次工具调用的任务
- 云基础设施: 预装软件包并具备网络访问能力的安全沙箱
- 自托管执行: 在您控制的基础设施上运行沙箱,以满足合规性或数据驻留要求
- 自托管服务: 通过自托管 Claude Managed Agents,在您自己的基础设施上运行整个 Managed Agents 服务
- 最少的基础设施: 无需自行构建智能体循环、沙箱或工具执行层
- 有状态会话: 跨多次交互持久保存的文件系统和对话历史
- 定时执行: 通过定时部署按 cron 计划定期运行智能体
支持的工具
Claude Managed Agents 为 Claude 提供了一组内置工具:
- Bash: 在沙箱中运行 shell 命令
- 文件操作: 在沙箱中读取、写入、编辑、glob 和 grep 文件
- 网页搜索和抓取: 搜索网页并从 URL 获取内容,可选择限制为域名允许列表或阻止列表
- MCP 服务器: 连接到外部工具提供商
请参阅工具了解完整列表和配置选项。
Beta 访问
要开始使用,您需要:
- 一个从 Claude Console 获取的 Claude API 密钥。
- 在所有请求中添加
managed-agents-2026-04-01beta 请求头。 - Claude Managed Agents 的访问权限(默认对所有 API 账户启用)。
在 beta 阶段内,MCP 隧道和 dreaming(梦境)处于更为有限的研究预览阶段。要启用它们,请申请研究预览的访问权限。
Claude Managed Agents 在设计上是有状态的:会话可长时间运行,暂停后可顺利恢复,并在服务器端存储对话历史、沙箱状态和输出。因此,Managed Agents 目前不符合零数据保留或 HIPAA 商业伙伴协议(BAA)的覆盖条件。零数据保留的例外情况是自托管 Claude Managed Agents,在这种情况下由您自行存储这些数据,如数据保留多长时间中所述。您保留对这些数据的控制权:您可以随时通过 API 删除会话,并单独删除您上传的任何文件。有关所有功能的适用资格,请参阅 API 与数据保留。
可用性
Managed Agents在所有模型上处于 beta 阶段。
API 支持
| 状态 | 云平台 | 模型 |
|---|---|---|
| Beta | Claude API, Claude Platform on AWS, Claude Models on Google Cloud (Anthropic managed) | 所有模型 |
所需的 beta 请求头
Beta 请求头让您可以在实验性功能和新模型能力成为标准 API 的一部分之前访问它们。
managed-agents-2026-04-01
数据处理
| 项目 | 零数据保留 | HIPAA |
|---|---|---|
| 状态 | 不具备资格 | 不具备资格 |
| 详细信息 | 不具备 ZDR 资格,自托管 Managed Agents 除外。会话是有状态的资源;对话记录会一直保留,直到您将其删除。 了解更多 | 不具备 HIPAA 资格。适用于所有 Managed Agents 子功能。 |
适用的端点:
/v1/agents/v1/sessions/v1/environments