参考
Claude Managed Agents 的事件类型、自托管 worker CLI 标志、支持的 MCP 服务器类型、速率限制以及品牌指南。
本页汇集了 Claude Managed Agents 的参考资料。如需面向任务的指南，请点击各节中的链接。有关会话资源的操作，请参阅会话操作。
事件类型
持久化的事件类型字符串遵循 {domain}.{action} 命名约定；仅限流式传输的 event deltas（事件增量，参见"事件增量"选项卡）是例外。有关发送、流式传输和列出事件的信息，请参阅会话事件流。Webhook 事件类型在订阅 webhook 中单独列出，其中一些名称与事件流中的名称不同（例如，session.status_idled 而非 session.status_idle）。
| 类型 | 描述 |
|---|---|
user.message | 包含文本、图像或文档内容的用户消息。 |
user.interrupt | 在执行过程中停止智能体。 |
user.custom_tool_result | 对智能体发起的自定义工具调用的响应。 |
user.tool_confirmation | 当权限策略要求确认时，批准或拒绝智能体或 MCP 工具调用。 |
user.define_outcome | 定义一个供智能体努力达成的 outcome（结果）。 |
user.tool_result | 仅适用于使用 self_hosted 环境的会话，您的集成负责提供 agent_toolset 结果。SDK 辅助工具和 CLI 会自动完成此操作。 |
自托管 worker
以下是用于驱动 self_hosted 环境的预构建 worker 的 ant beta:worker CLI 标志。有关设置环境、运行 worker 以及 SDK 辅助工具选项的信息，请参阅自托管沙箱。
| 标志 | 描述 |
|---|---|
--environment-id | 要轮询工作的环境。也可从 ANTHROPIC_ENVIRONMENT_ID 读取。 |
--environment-key | 使用此环境对 worker 进行身份验证。也可从 ANTHROPIC_ENVIRONMENT_KEY 读取。 |
--workdir | 下载技能以及工具读写文件的目录。默认为 .（当前目录）；系统默认工作目录为 /workspace。 |
--on-work | 为每个已领取的工作项调用的脚本，而非在进程内运行工具。以环境变量的形式接收会话详细信息。 |
--unrestricted-paths | 允许文件工具读写 --workdir 之外的路径。workdir 检查仅是针对文件工具的防护措施，而非沙箱；它不约束 bash。 |
--max-idle | 会话以 end_turn 停止原因进入空闲状态后，在关闭之前等待的时长。默认为 60s。 |
--log-format | 日志输出格式。使用 json 进行结构化日志采集。默认为 text。 |
CLI worker 不会挂载记忆存储：附加了记忆存储的会话仍会运行，但智能体在存储的 mount_path 处找不到任何内容，且任何更改都不会同步回存储。要在自托管环境上的会话中使用记忆存储，请改为运行 SDK worker；请参阅使用记忆存储。
支持的 MCP 服务器类型
Claude Managed Agents 可连接到公开 HTTP 端点的远程 MCP 服务器，或通过 MCP 隧道连接到私有 MCP 服务器。服务器应支持 MCP 协议的 streamable 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?