托管智能体参考

参考

Claude Managed Agents 的事件类型、自托管工作器 CLI 标志、支持的 MCP 服务器类型、速率限制和品牌指南。

本页汇集了 Claude Managed Agents 的参考资料。有关面向任务的指南，请点击各部分中的链接。有关会话资源的操作，请参阅会话操作。

Managed Agents API 请求需要 managed-agents-2026-04-01 beta 标头，但内存存储端点除外，它们使用 agent-memory-2026-07-22。SDK 会自动设置正确的 beta 标头。请参阅Beta 标头。

事件类型

持久化的事件类型字符串遵循 {domain}.{action} 命名约定；仅限流式传输的事件增量（请参阅"事件增量"选项卡）是例外。有关发送、流式传输和列出事件，请参阅会话事件流。

类型	描述
`user.message`	包含文本、图像或文档内容的用户消息。
`user.interrupt`	在执行过程中停止代理。
`user.custom_tool_result`	对代理发出的自定义工具调用的响应。
`user.tool_confirmation`	当权限策略要求确认时，批准或拒绝代理或 MCP 工具调用。
`user.define_outcome`	定义代理要努力实现的结果。
`user.tool_result`	仅适用于具有 `self_hosted` 环境的会话，您的集成负责提供 `agent_toolset` 结果。SDK 辅助工具和 CLI 会自动完成此操作。

自托管工作器

以下是驱动 self_hosted 环境的预构建工作器的 ant beta:worker CLI 标志。有关设置环境、运行工作器以及 SDK 辅助工具选项，请参阅自托管沙箱。

标志	描述
`--environment-id`	要轮询工作的环境。也可从 `ANTHROPIC_ENVIRONMENT_ID` 读取。
`--environment-key`	使用此环境对工作器进行身份验证。也可从 `ANTHROPIC_ENVIRONMENT_KEY` 读取。
`--workdir`	下载技能以及工具读写文件的目录。默认为 `.`（当前目录）；系统默认工作目录为 `/workspace`。
`--on-work`	为每个已认领的工作项调用的脚本，而不是在进程内运行工具。通过环境变量接收会话详细信息。
`--unrestricted-paths`	允许文件工具读写 `--workdir` 之外的路径。workdir 检查仅是针对文件工具的防护措施，而不是沙箱；它不会约束 bash。
`--max-idle`	在会话以 `end_turn` 停止原因进入空闲状态后，等待多长时间再关闭。默认为 `60s`。
`--log-format`	日志输出格式。使用 `json` 进行结构化日志摄取。默认为 `text`。

支持的 MCP 服务器类型

Claude Managed Agents 可连接到公开 HTTP 端点的远程 MCP 服务器，或通过 MCP 隧道连接到私有 MCP 服务器。服务器应支持 MCP 协议的可流式 HTTP 传输；仅支持已弃用的 SSE 传输的服务器仍可通过自动回退机制工作。有关在代理上声明服务器的信息，请参阅 MCP 连接器。

有关 MCP 和构建 MCP 服务器的更多信息，请参阅 MCP 文档。

速率限制

Managed Agents 端点按组织进行速率限制：

操作	限制
创建端点（例如代理、会话和环境）	每分钟 300 个请求
读取端点（例如检索、列出和流式传输）	每分钟 1,200 个请求

组织级别的支出限制和使用层级速率限制也同样适用。

品牌指南

对于集成 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 的事件类型、自托管工作器 CLI 标志、支持的 MCP 服务器类型、速率限制和品牌指南。

本页汇集了 Claude Managed Agents 的参考资料。有关面向任务的指南，请点击各部分中的链接。有关会话资源的操作，请参阅会话操作。

事件类型

类型	描述
`user.message`	包含文本、图像或文档内容的用户消息。
`user.interrupt`	在执行过程中停止代理。
`user.custom_tool_result`	对代理发出的自定义工具调用的响应。
`user.tool_confirmation`	当权限策略要求确认时，批准或拒绝代理或 MCP 工具调用。
`user.define_outcome`	定义代理要努力实现的结果。
`user.tool_result`	仅适用于具有 `self_hosted` 环境的会话，您的集成负责提供 `agent_toolset` 结果。SDK 辅助工具和 CLI 会自动完成此操作。

自托管工作器

以下是驱动 self_hosted 环境的预构建工作器的 ant beta:worker CLI 标志。有关设置环境、运行工作器以及 SDK 辅助工具选项，请参阅自托管沙箱。

标志	描述
`--environment-id`	要轮询工作的环境。也可从 `ANTHROPIC_ENVIRONMENT_ID` 读取。
`--environment-key`	使用此环境对工作器进行身份验证。也可从 `ANTHROPIC_ENVIRONMENT_KEY` 读取。
`--workdir`	下载技能以及工具读写文件的目录。默认为 `.`（当前目录）；系统默认工作目录为 `/workspace`。
`--on-work`	为每个已认领的工作项调用的脚本，而不是在进程内运行工具。通过环境变量接收会话详细信息。
`--unrestricted-paths`	允许文件工具读写 `--workdir` 之外的路径。workdir 检查仅是针对文件工具的防护措施，而不是沙箱；它不会约束 bash。
`--max-idle`	在会话以 `end_turn` 停止原因进入空闲状态后，等待多长时间再关闭。默认为 `60s`。
`--log-format`	日志输出格式。使用 `json` 进行结构化日志摄取。默认为 `text`。

支持的 MCP 服务器类型

有关 MCP 和构建 MCP 服务器的更多信息，请参阅 MCP 文档。

速率限制

Managed Agents 端点按组织进行速率限制：

操作	限制
创建端点（例如代理、会话和环境）	每分钟 300 个请求
读取端点（例如检索、列出和流式传输）	每分钟 1,200 个请求

组织级别的支出限制和使用层级速率限制也同样适用。

品牌指南

对于集成 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?

事件类型

自托管工作器

支持的 MCP 服务器类型

速率限制

品牌指南

事件类型

自托管工作器

支持的 MCP 服务器类型

速率限制

品牌指南

事件类型

自托管工作器

支持的 MCP 服务器类型

速率限制

品牌指南

事件类型

自托管工作器

支持的 MCP 服务器类型

速率限制

品牌指南