Claude Managed Agents 概述

在托管基础设施中运行的预构建、可配置的智能体框架。最适合长时间运行的任务和异步工作。

Anthropic 提供两种使用 Claude 进行构建的方式,每种方式适用于不同的使用场景:

Messages APIClaude Managed Agents
它是什么直接的模型提示访问预构建、可配置的智能体框架,运行在托管基础设施中
最适合自定义智能体循环和细粒度控制长时间运行的任务和异步工作

Claude Managed Agents 提供了将 Claude 作为自主智能体运行所需的 harness(框架)和基础设施。您无需自行构建智能体循环、工具执行和运行时,即可获得一个完全托管的环境,Claude 可以在其中安全地读取文件、运行命令、浏览网页和运行代码。该框架支持内置的 prompt caching(提示缓存)、compaction(压缩)以及其他性能优化,以实现高质量、高效率的智能体输出。如果您希望通过直接访问模型来构建自己的智能体循环,请参阅使用 Messages API。

参考

事件类型、速率限制、CLI 标志及其他查询表

核心概念

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 访问

要开始使用,您需要:

  1. 一个从 Claude Console 获取的 Claude API 密钥。
  2. 在所有请求中添加 managed-agents-2026-04-01 beta 请求头。
  3. Claude Managed Agents 的访问权限(默认对所有 API 账户启用)。

在 beta 阶段内,MCP 隧道和 dreaming(梦境)处于更为有限的研究预览阶段。要启用它们,请申请研究预览的访问权限。

Claude Managed Agents 在设计上是有状态的:会话可长时间运行,暂停后可顺利恢复,并在服务器端存储对话历史、沙箱状态和输出。因此,Managed Agents 目前不符合零数据保留或 HIPAA 商业伙伴协议(BAA)的覆盖条件。零数据保留的例外情况是自托管 Claude Managed Agents,在这种情况下由您自行存储这些数据,如数据保留多长时间中所述。您保留对这些数据的控制权:您可以随时通过 API 删除会话,并单独删除您上传的任何文件。有关所有功能的适用资格,请参阅 API 与数据保留。

请参阅参考文档中的速率限制和品牌指南。

可用性

Managed Agents在所有模型上处于 beta 阶段。

API 支持

所需的 beta 请求头

Beta 请求头概览

Beta 请求头让您可以在实验性功能和新模型能力成为标准 API 的一部分之前访问它们。

  • managed-agents-2026-04-01

数据处理

数据处理概览

项目零数据保留HIPAA
状态不具备资格不具备资格
详细信息不具备 ZDR 资格,自托管 Managed Agents 除外。会话是有状态的资源;对话记录会一直保留,直到您将其删除。 了解更多不具备 HIPAA 资格。适用于所有 Managed Agents 子功能。

适用的端点:

  • /v1/agents
  • /v1/sessions
  • /v1/environments
文档内容持续同步更新