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，以流式传输方式返回结果。事件历史记录会在服务器端持久化保存，并可完整获取。
引导或中断
在执行过程中发送额外的用户事件来引导智能体，或中断它以改变方向。
何时使用 Claude Managed Agents
Claude Managed Agents 最适合具有以下需求的工作负载：
- 长时间运行的执行： 运行数分钟或数小时、涉及多次工具调用的任务
- 云基础设施： 预装软件包并具备网络访问能力的安全沙箱
- 自托管执行： 在您控制的基础设施上运行沙箱，以满足合规性或数据驻留要求
- 最少的基础设施： 无需自行构建智能体循环、沙箱或工具执行层
- 有状态会话： 跨多次交互持久保存的文件系统和对话历史
- 定时执行： 通过定时部署按 cron 计划定期运行智能体
支持的工具
Claude Managed Agents 为 Claude 提供了一组内置工具：
- Bash： 在沙箱中运行 shell 命令
- 文件操作： 在沙箱中读取、写入、编辑、glob 和 grep 文件
- 网页搜索和抓取： 搜索网页并从 URL 获取内容，可选择限制为域名允许列表或阻止列表
- MCP 服务器： 连接到外部工具提供商
请参阅工具了解完整列表和配置选项。
Beta 访问
要开始使用，您需要：
- 一个 Claude API 密钥
- 在所有请求中添加
managed-agents-2026-04-01beta 请求头 - Claude Managed Agents 的访问权限（默认对所有 API 账户启用）
在 beta 阶段内，MCP 隧道和 dreaming（梦境）处于更为有限的研究预览阶段。请申请访问权限以启用它们。
Claude Managed Agents 在设计上是有状态的：会话可长时间运行，暂停后可顺利恢复，并在服务器端存储对话历史、沙箱状态和输出。因此，Managed Agents 目前不符合零数据保留或 HIPAA 商业伙伴协议（BAA）的覆盖条件。您保留对这些数据的控制权：您可以随时通过 API 删除会话，并单独删除您上传的任何文件。有关所有功能的适用资格，请参阅 API 与数据保留。
Was this page helpful?