Claude 托管智能体 API
创建智能体，在云端运行会话，通过事件收取回复。官方 95 个操作全部声明：41 个已支持或部分支持，其余如实返回 501；具体状态见各端点徽标。
加载中…
- 创建智能体，保存返回的
agent_… ID。
- 创建会话，将
agent 替换为该 ID，保存 sesn_… ID。
- 先订阅事件流，再发送消息。将两个请求的会话 ID 替换为同一个真实 ID。
- 收到
agent.message 后等待 session.status_idle；也可查询历史事件。
SDK 基础地址就是上面的基础地址。每个请求均需 API Key、anthropic-version: 2023-06-01 和 anthropic-beta: managed-agents-2026-04-01。在线试调会自动带上这些协议头，资源 ID 需自行替换。
官方 95 个操作已全部声明：其中 41 个已支持或部分支持（见端点清单徽标）；其余 54 个平台尚未实现，调用如实返回 501（not_implemented_error，响应带 x-should-retry: false），不产生任何副作用、不计费。各项能力与凭据库的具体限制见端点说明。
- 创建智能体：支持文本提示词、模型、元数据与内置工具。MCP、Skills 及额外模型控制尚不支持，传入会返回 400。 multiagent 接受 null 或 coordinator 名册，1–20 项：智能体 ID、{type:"agent",id,version?} 或最多一个 {type:"self"}。创建/更新时固定版本；成员去重且须存在、未归档、不能自身带 multiagent。兼容 API 只提供 bash、edit、glob、grep、read、write、web_search、web_fetch 这 8 个官方工具；configs 不接受其他工具名，经此入口创建的会话不提供后台任务、Monitor 或子智能体。完整原生工具请使用 /agent/v1。每个 coordinator 最多一个 advisor，模型须可用且不同于智能体模型；仅主会话可咨询，每次咨询为独立 advisor 线程，建议以 agent.thread_message_received 返回。
- 读取智能体：将示例中的资源 ID 替换成你创建的资源 ID。
- 更新智能体：version 可用于乐观并发控制，版本冲突返回 409；无变化的更新不增加版本。MCP、Skills 尚不支持。 multiagent 接受 null 或 coordinator 名册，1–20 项：智能体 ID、{type:"agent",id,version?} 或最多一个 {type:"self"}。创建/更新时固定版本；成员去重且须存在、未归档、不能自身带 multiagent。兼容 API 只提供 bash、edit、glob、grep、read、write、web_search、web_fetch 这 8 个官方工具；configs 不接受其他工具名，经此入口创建的会话不提供后台任务、Monitor 或子智能体。完整原生工具请使用 /agent/v1。每个 coordinator 最多一个 advisor，模型须可用且不同于智能体模型；仅主会话可咨询，每次咨询为独立 advisor 线程，建议以 agent.thread_message_received 返回。
- 列出版本：将示例中的资源 ID 替换成你创建的资源 ID。
- 归档智能体：归档后保留查询与历史版本，不能继续更新。请只归档自己的测试智能体。
- 创建会话：先创建智能体，将示例 agent_123 换成返回的 id。Anthropic 兼容 API 的 environment_id 必填，可用 node22 或租户自建 cloud 环境；/agent/v1 可省略 environment_id 得到轻量机器。不支持内联智能体覆盖、预算与凭据库。 支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/<file_id>，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。
- 列出会话：支持 limit、page 与 agent_id；agent_version、时间范围、deployment_id、memory_store_id、include_archived、order、statuses 尚不支持，传入返回 400。
- 读取会话：将示例中的资源 ID 替换成你创建的资源 ID。
- 发送事件：将 sesn_123 换成创建会话返回的 id。每条 user.message 只接受一个非空文本块。支持文本 user.message、user.interrupt 和工具确认；其它事件变体尚不支持。返回的是已接纳事件；模型回复从事件历史或订阅读取。会话等待工具授权时发送的 user.message 会排队：返回的事件 processed_at 为 null，授权处理完成后按发送顺序执行。
- 列出事件：先发送消息再读取历史；处理完成前可能只看到已接纳的输入。支持分页、事件类型和时间过滤。会话等待工具授权时停在 session.status_idle，stop_reason 为 requires_action，event_ids 列出待确认的 agent.tool_use；运行失败时先出现 session.error，再出现 session.status_terminated。agent.thinking 与官方一致，是不带内容的进度信号。
- 订阅事件：保持 SSE 连接以接收事件；请求不会像普通 JSON 接口一样立刻结束。先创建会话并替换 sesn_123，再从另一请求发送消息；停止按钮只断开订阅，不会停止智能体。SDK 0.124.0 会过滤 session.usage，完整用量请读历史。传 event_deltas[]=agent.message 可在最终事件到达前收到逐段文本预览；agent.thinking 与官方一致，只有 event_start。
- 列出环境：支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。
- 创建环境：支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。
- 读取环境：支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。
- 更新环境：支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。
- 归档环境：支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。
- 更新会话：支持 title 与 metadata（官方补丁语义：字符串值写入、null 删除该键、整包 null 清空，未提及的键保留）。官方的 agent 覆盖（tools/mcp_servers）、budget 与 vault_ids 不支持，传入返回 400 并点名字段。归档后的会话更新返回 409。
- 归档会话：归档后的会话拒绝新消息（400 invalid_request_error，写明会话已归档），读取与事件历史仍可用；重复归档幂等，archived_at 保持首次归档时间。
- 列出会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/<file_id>，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。
- 添加会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/<file_id>，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。
- 删除会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/<file_id>，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。
- 读取会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/<file_id>，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。
- 列出线程：按 created_at 升序返回主线程及全部子线程。线程 id 为 sthr_ 加所属会话 id 的后缀；子线程的 parent_thread_id 指向主线程，session_id 始终为父会话。agent 是实际运行的定义，内置类型的 name 为类型名，未注册的 id/version 为 null。归档子线程的 status 为 terminated，archived_at 为归档时间；stats/usage 无线程级追踪时如实为 null。
- 读取线程：返回本会话的主线程或子线程，与列表项逐字段一致。其他会话的线程、未知线程或非 sthr_ id 一律返回 404，不泄露其存在性。
- 归档线程：主线程沿用会话归档动作；子线程仅归档对应子会话，不归档父会话或其他子线程。子线程归档后 status 为 terminated，带 archived_at；历史事件仍可读。
- 列出线程事件：读取所选线程自己的事件记录：主线程读主会话，子线程读对应子会话。沿用会话事件接口的查询参数、公开事件类型和 data + next_page 信封。使用网页工具时，两个接口均返回 search_result 块；回答 citations 为 /agent/v1 扩展，/anthropic 将引用显示为正文 [n]。
- 订阅线程事件：订阅所选线程自己的实时事件流。复用会话 SSE 实现；/agent 接口支持同址只读 WebSocket。主会话流同时包含子线程创建、状态和消息事件，子线程审批带 session_thread_id 上浮；确认或中断携带该字段时路由到所属子线程。
- 列出凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 创建凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 删除凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 读取凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 更新凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 归档凭据库：支持创建、列出、读取、更新、归档与删除。列表支持 limit、page 和 include_archived。归档会同时归档库内全部凭据并清除凭据的值；删除会一并删除全部凭据，不可恢复。以 anthropic. 开头的 metadata 键由平台保留，不能写入。同一个库也可以通过原生接口 /vault/v1 管理。
- 列出凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 创建凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 删除凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 读取凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 更新凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 归档凭据：支持 environment_variable 与 static_bearer。environment_variable 的 networking 只支持 limited，传 unrestricted 返回 400；secret_name 只能使用大写字母、数字和下划线，且不能以数字开头；injection_location 的默认值与官方一致。static_bearer 的令牌只在 mcp_server_url 所在主机上可用。创建或更新 mcp_oauth 返回 501（not_implemented_error），不产生副作用，官方 SDK 不会重试；需要 OAuth 令牌时请使用 /vault/v1/authorizations 一键授权。每个库最多 20 个有效凭据。以 anthropic. 开头的 metadata 键由平台保留，不能写入。
- 校验凭据 MCP OAuth：只适用于 OAuth 凭据，对其他类型返回 400。结果总是 HTTP 200，status 为 valid、invalid 或 unknown；mcp_probe 只在未通过时给出失败的一步，refresh 只在尝试了续期时给出。
参数与字段的权威定义以 Claude Managed Agents 官方文档为准。
错误按 Claude Managed Agents 格式返回，参见错误；额度与响应头参见限流。