托管智能体第一步

Claude 托管智能体概述

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

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

	Messages API	Claude Managed Agents
是什么	直接访问模型提示功能	预构建、可配置的智能体框架，运行在托管基础设施上
最适合	自定义智能体循环和细粒度控制	长时间运行的任务和异步工作
了解更多	Messages API 文档	Claude Managed Agents 文档

Claude 托管智能体提供了将 Claude 作为自主智能体运行所需的框架和基础设施。您无需自行构建智能体循环、工具执行和运行时，即可获得一个完全托管的环境，Claude 可以在其中安全地读取文件、运行命令、浏览网页和执行代码。该框架支持内置的提示缓存、压缩以及其他性能优化，以实现高质量、高效的智能体输出。

Claude 托管智能体也可在 AWS 上的 Claude Platform 中使用，但在功能可用性和会话行为方面存在一些差异。请参阅 AWS 上的 Claude Platform 指南中的 Claude 托管智能体。

快速入门

创建您的第一个智能体会话

启动会话

创建会话并发送您的第一个事件

参考文档

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

核心概念

Claude 托管智能体围绕四个概念构建：

概念	描述
Agent（代理）	模型、系统提示、工具、MCP 服务器和技能
Environment（环境）	会话运行位置的配置：由 Anthropic 托管的云沙箱，或在您自己的基础设施上自托管的沙箱
Session（会话）	在环境中运行的代理实例，执行特定任务并生成输出
Events（事件）	您的应用程序与代理之间交换的消息（用户轮次、工具结果、状态更新）

工作原理

创建智能体
定义模型、系统提示、工具、MCP 服务器和技能。创建一次智能体，然后通过 ID 在多个会话中引用它。
创建环境
配置智能体的运行位置：云沙箱，或在您自己的基础设施上运行的自托管沙箱。
启动会话
启动一个引用您的智能体和环境配置的会话。
发送事件并流式传输响应
将用户消息作为事件发送。Claude 自主执行工具，并通过 "server-sent events"（服务器发送事件），即 SSE 流式返回结果。事件历史记录在服务器端持久化，可以完整获取。
引导或中断
发送额外的用户事件以在执行过程中引导智能体，或中断它以改变方向。

何时使用 Claude 托管智能体

Claude 托管智能体最适合具有以下需求的工作负载：

**长时间运行的执行：**需要运行数分钟或数小时并包含多次工具调用的任务
**云基础设施：**预装软件包并具有网络访问权限的安全沙箱
**自托管执行：**在您控制的基础设施上运行沙箱，以满足合规性或数据驻留要求
**最少的基础设施：**无需构建自己的智能体循环、沙箱或工具执行层
**有状态会话：**跨多次交互的持久化文件系统和对话历史记录
**定时执行：**通过定时部署按 cron 计划定期运行智能体

支持的工具

Claude 托管智能体为 Claude 提供了一组内置工具的访问权限：

**Bash：**在沙箱中运行 shell 命令
**文件操作：**在沙箱中读取、写入、编辑、glob 和 grep 文件
**网络搜索和获取：**搜索网络并从 URL 检索内容
**MCP 服务器：**连接到外部工具提供商

有关完整列表和配置选项，请参阅工具。

Beta 访问

Claude 托管智能体目前处于 beta 阶段。所有托管智能体端点都需要 managed-agents-2026-04-01 beta 标头。SDK 会自动设置 beta 标头。各版本之间可能会对行为进行优化以改进输出。

要开始使用，您需要：

一个 Claude API 密钥
在所有请求中包含 managed-agents-2026-04-01 beta 标头
Claude 托管智能体的访问权限（所有 API 账户默认启用）

在 beta 版本中，MCP 隧道和 dreaming 处于更受限的研究预览阶段。申请访问权限以启用它们。

Claude 托管智能体在设计上是有状态的：会话长时间运行，暂停后可干净地恢复，并在服务器端存储对话历史记录、沙箱状态和输出。因此，托管智能体目前不符合零数据保留或 HIPAA 业务伙伴协议（BAA）的覆盖条件。您对这些数据保留控制权：您可以随时通过 API 删除会话，并单独删除您上传的任何文件。有关所有功能的资格条件，请参阅 API 和数据保留。

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

Was this page helpful?

托管智能体第一步

Claude 托管智能体概述

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

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

	Messages API	Claude Managed Agents
是什么	直接访问模型提示功能	预构建、可配置的智能体框架，运行在托管基础设施上
最适合	自定义智能体循环和细粒度控制	长时间运行的任务和异步工作
了解更多	Messages API 文档	Claude Managed Agents 文档

快速入门

创建您的第一个智能体会话

启动会话

创建会话并发送您的第一个事件

参考文档

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

核心概念

Claude 托管智能体围绕四个概念构建：

概念	描述
Agent（代理）	模型、系统提示、工具、MCP 服务器和技能
Environment（环境）	会话运行位置的配置：由 Anthropic 托管的云沙箱，或在您自己的基础设施上自托管的沙箱
Session（会话）	在环境中运行的代理实例，执行特定任务并生成输出
Events（事件）	您的应用程序与代理之间交换的消息（用户轮次、工具结果、状态更新）

工作原理

创建智能体
定义模型、系统提示、工具、MCP 服务器和技能。创建一次智能体，然后通过 ID 在多个会话中引用它。
创建环境
配置智能体的运行位置：云沙箱，或在您自己的基础设施上运行的自托管沙箱。
启动会话
启动一个引用您的智能体和环境配置的会话。
发送事件并流式传输响应
将用户消息作为事件发送。Claude 自主执行工具，并通过 "server-sent events"（服务器发送事件），即 SSE 流式返回结果。事件历史记录在服务器端持久化，可以完整获取。
引导或中断
发送额外的用户事件以在执行过程中引导智能体，或中断它以改变方向。

何时使用 Claude 托管智能体

Claude 托管智能体最适合具有以下需求的工作负载：

**长时间运行的执行：**需要运行数分钟或数小时并包含多次工具调用的任务
**云基础设施：**预装软件包并具有网络访问权限的安全沙箱
**自托管执行：**在您控制的基础设施上运行沙箱，以满足合规性或数据驻留要求
**最少的基础设施：**无需构建自己的智能体循环、沙箱或工具执行层
**有状态会话：**跨多次交互的持久化文件系统和对话历史记录
**定时执行：**通过定时部署按 cron 计划定期运行智能体

支持的工具

Claude 托管智能体为 Claude 提供了一组内置工具的访问权限：

**Bash：**在沙箱中运行 shell 命令
**文件操作：**在沙箱中读取、写入、编辑、glob 和 grep 文件
**网络搜索和获取：**搜索网络并从 URL 检索内容
**MCP 服务器：**连接到外部工具提供商

有关完整列表和配置选项，请参阅工具。

Beta 访问

要开始使用，您需要：

一个 Claude API 密钥
在所有请求中包含 managed-agents-2026-04-01 beta 标头
Claude 托管智能体的访问权限（所有 API 账户默认启用）

在 beta 版本中，MCP 隧道和 dreaming 处于更受限的研究预览阶段。申请访问权限以启用它们。

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

Was this page helpful?

核心概念

工作原理

何时使用 Claude 托管智能体

支持的工具

Beta 访问

核心概念

工作原理

何时使用 Claude 托管智能体

支持的工具

Beta 访问

核心概念

工作原理

何时使用 Claude 托管智能体

支持的工具

Beta 访问

核心概念

工作原理

何时使用 Claude 托管智能体

支持的工具

Beta 访问