# Claude 托管智能体 API (/docs/api/compatible/anthropic/managed-agents) ## 基础地址 [#基础地址] ## 接入 [#接入] ## 运行一次会话 [#运行一次会话] 1. [创建智能体](/docs/api/compatible/anthropic/managed-agents/createAgent)，保存返回的 `agent_…` ID。 2. [创建会话](/docs/api/compatible/anthropic/managed-agents/createSession)，将 `agent` 替换为该 ID，保存 `sesn_…` ID。 3. 先[订阅事件流](/docs/api/compatible/anthropic/managed-agents/streamEvents)，再[发送消息](/docs/api/compatible/anthropic/managed-agents/sendEvents)。将两个请求的会话 ID 替换为同一个真实 ID。 4. 收到 `agent.message` 后等待 `session.status_idle`；也可[查询历史事件](/docs/api/compatible/anthropic/managed-agents/listEvents)。 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），不产生任何副作用、不计费。各项能力与凭据库的具体限制见端点说明。 ## 端点 [#端点] ### 智能体（6 个端点，6 个可用） [#智能体6-个端点6-个可用] | 方法 | 路径 | 说明 | 支持 | | ---- | --------------------------------------------------------------------------------------------------- | ----- | ------ | | POST | [`/v1/agents`](/docs/api/compatible/anthropic/managed-agents/createAgent) | 创建智能体 | ◐ 部分支持 | | GET | [`/v1/agents`](/docs/api/compatible/anthropic/managed-agents/listAgents) | 列出智能体 | ● 支持 | | GET | [`/v1/agents/{agent_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveAgent) | 读取智能体 | ● 支持 | | POST | [`/v1/agents/{agent_id}`](/docs/api/compatible/anthropic/managed-agents/updateAgent) | 更新智能体 | ◐ 部分支持 | | GET | [`/v1/agents/{agent_id}/versions`](/docs/api/compatible/anthropic/managed-agents/listAgentVersions) | 列出版本 | ● 支持 | | POST | [`/v1/agents/{agent_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveAgent) | 归档智能体 | ● 支持 | ### 会话与事件（9 个端点，8 个可用） [#会话与事件9-个端点8-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | ------------------------------------------------------------------------------------------------------- | ---- | ------ | | POST | [`/v1/sessions`](/docs/api/compatible/anthropic/managed-agents/createSession) | 创建会话 | ◐ 部分支持 | | GET | [`/v1/sessions`](/docs/api/compatible/anthropic/managed-agents/listSessions) | 列出会话 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveSession) | 读取会话 | ● 支持 | | POST | [`/v1/sessions/{session_id}/events`](/docs/api/compatible/anthropic/managed-agents/sendEvents) | 发送事件 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}/events`](/docs/api/compatible/anthropic/managed-agents/listEvents) | 列出事件 | ● 支持 | | GET | [`/v1/sessions/{session_id}/events/stream`](/docs/api/compatible/anthropic/managed-agents/streamEvents) | 订阅事件 | ◐ 部分支持 | | POST | [`/v1/sessions/{session_id}`](/docs/api/compatible/anthropic/managed-agents/updateSession) | 更新会话 | ◐ 部分支持 | | DELETE | [`/v1/sessions/{session_id}`](/docs/api/compatible/anthropic/managed-agents/deleteSession) | 删除会话 | ○ 未支持 | | POST | [`/v1/sessions/{session_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveSession) | 归档会话 | ● 支持 | ### 定时部署（10 个端点，0 个可用） [#定时部署10-个端点0-个可用] | 方法 | 路径 | 说明 | 支持 | | ---- | ---------------------------------------------------------------------------------------------------------------- | ------ | ----- | | GET | [`/v1/deployment_runs`](/docs/api/compatible/anthropic/managed-agents/listDeploymentRuns) | 列出部署运行 | ○ 未支持 | | GET | [`/v1/deployment_runs/{deployment_run_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveDeploymentRun) | 读取部署运行 | ○ 未支持 | | GET | [`/v1/deployments`](/docs/api/compatible/anthropic/managed-agents/listDeployments) | 列出部署 | ○ 未支持 | | POST | [`/v1/deployments`](/docs/api/compatible/anthropic/managed-agents/createDeployment) | 创建部署 | ○ 未支持 | | GET | [`/v1/deployments/{deployment_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveDeployment) | 读取部署 | ○ 未支持 | | POST | [`/v1/deployments/{deployment_id}`](/docs/api/compatible/anthropic/managed-agents/updateDeployment) | 更新部署 | ○ 未支持 | | POST | [`/v1/deployments/{deployment_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveDeployment) | 归档部署 | ○ 未支持 | | POST | [`/v1/deployments/{deployment_id}/pause`](/docs/api/compatible/anthropic/managed-agents/pauseDeployment) | 暂停部署 | ○ 未支持 | | POST | [`/v1/deployments/{deployment_id}/run`](/docs/api/compatible/anthropic/managed-agents/runDeployment) | 运行部署 | ○ 未支持 | | POST | [`/v1/deployments/{deployment_id}/unpause`](/docs/api/compatible/anthropic/managed-agents/unpauseDeployment) | 恢复部署 | ○ 未支持 | ### 环境（6 个端点，5 个可用） [#环境6-个端点5-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | --------------------------------------------------------------------------------------------------------------- | ---- | ------ | | GET | [`/v1/environments`](/docs/api/compatible/anthropic/managed-agents/listEnvironments) | 列出环境 | ◐ 部分支持 | | POST | [`/v1/environments`](/docs/api/compatible/anthropic/managed-agents/createEnvironment) | 创建环境 | ◐ 部分支持 | | DELETE | [`/v1/environments/{environment_id}`](/docs/api/compatible/anthropic/managed-agents/deleteEnvironment) | 删除环境 | ○ 未支持 | | GET | [`/v1/environments/{environment_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveEnvironment) | 读取环境 | ◐ 部分支持 | | POST | [`/v1/environments/{environment_id}`](/docs/api/compatible/anthropic/managed-agents/updateEnvironment) | 更新环境 | ◐ 部分支持 | | POST | [`/v1/environments/{environment_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveEnvironment) | 归档环境 | ◐ 部分支持 | ### 环境任务（8 个端点，0 个可用） [#环境任务8-个端点0-个可用] | 方法 | 路径 | 说明 | 支持 | | ---- | -------------------------------------------------------------------------------------------------------------------------------------- | ----- | ----- | | GET | [`/v1/environments/{environment_id}/work`](/docs/api/compatible/anthropic/managed-agents/listEnvironmentWork) | 列出工作项 | ○ 未支持 | | GET | [`/v1/environments/{environment_id}/work/{work_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveEnvironmentWork) | 读取工作项 | ○ 未支持 | | POST | [`/v1/environments/{environment_id}/work/{work_id}`](/docs/api/compatible/anthropic/managed-agents/updateEnvironmentWork) | 更新工作项 | ○ 未支持 | | POST | [`/v1/environments/{environment_id}/work/{work_id}/ack`](/docs/api/compatible/anthropic/managed-agents/ackEnvironmentWork) | 确认工作项 | ○ 未支持 | | POST | [`/v1/environments/{environment_id}/work/{work_id}/heartbeat`](/docs/api/compatible/anthropic/managed-agents/heartbeatEnvironmentWork) | 工作项心跳 | ○ 未支持 | | POST | [`/v1/environments/{environment_id}/work/{work_id}/stop`](/docs/api/compatible/anthropic/managed-agents/stopEnvironmentWork) | 停止工作项 | ○ 未支持 | | GET | [`/v1/environments/{environment_id}/work/poll`](/docs/api/compatible/anthropic/managed-agents/pollEnvironmentWork) | 轮询工作项 | ○ 未支持 | | GET | [`/v1/environments/{environment_id}/work/stats`](/docs/api/compatible/anthropic/managed-agents/retrieveEnvironmentWorkStats) | 工作项统计 | ○ 未支持 | ### 记忆库（14 个端点，0 个可用） [#记忆库14-个端点0-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----- | | GET | [`/v1/memory_stores`](/docs/api/compatible/anthropic/managed-agents/listMemoryStores) | 列出记忆库 | ○ 未支持 | | POST | [`/v1/memory_stores`](/docs/api/compatible/anthropic/managed-agents/createMemoryStore) | 创建记忆库 | ○ 未支持 | | DELETE | [`/v1/memory_stores/{memory_store_id}`](/docs/api/compatible/anthropic/managed-agents/deleteMemoryStore) | 删除记忆库 | ○ 未支持 | | GET | [`/v1/memory_stores/{memory_store_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveMemoryStore) | 读取记忆库 | ○ 未支持 | | POST | [`/v1/memory_stores/{memory_store_id}`](/docs/api/compatible/anthropic/managed-agents/updateMemoryStore) | 更新记忆库 | ○ 未支持 | | POST | [`/v1/memory_stores/{memory_store_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveMemoryStore) | 归档记忆库 | ○ 未支持 | | GET | [`/v1/memory_stores/{memory_store_id}/memories`](/docs/api/compatible/anthropic/managed-agents/listMemoryStoreMemories) | 列出记忆 | ○ 未支持 | | POST | [`/v1/memory_stores/{memory_store_id}/memories`](/docs/api/compatible/anthropic/managed-agents/createMemoryStoreMemory) | 创建记忆 | ○ 未支持 | | DELETE | [`/v1/memory_stores/{memory_store_id}/memories/{memory_id}`](/docs/api/compatible/anthropic/managed-agents/deleteMemoryStoreMemory) | 删除记忆 | ○ 未支持 | | GET | [`/v1/memory_stores/{memory_store_id}/memories/{memory_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveMemoryStoreMemory) | 读取记忆 | ○ 未支持 | | POST | [`/v1/memory_stores/{memory_store_id}/memories/{memory_id}`](/docs/api/compatible/anthropic/managed-agents/updateMemoryStoreMemory) | 更新记忆 | ○ 未支持 | | GET | [`/v1/memory_stores/{memory_store_id}/memory_versions`](/docs/api/compatible/anthropic/managed-agents/listMemoryStoreMemoryVersions) | 列出记忆版本 | ○ 未支持 | | GET | [`/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveMemoryStoreMemoryVersion) | 读取记忆版本 | ○ 未支持 | | POST | [`/v1/memory_stores/{memory_store_id}/memory_versions/{memory_version_id}/redact`](/docs/api/compatible/anthropic/managed-agents/redactMemoryStoreMemoryVersion) | 抹除记忆版本 | ○ 未支持 | ### 会话资源（5 个端点，4 个可用） [#会话资源5-个端点4-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | ---------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | | GET | [`/v1/sessions/{session_id}/resources`](/docs/api/compatible/anthropic/managed-agents/listSessionResources) | 列出会话资源 | ◐ 部分支持 | | POST | [`/v1/sessions/{session_id}/resources`](/docs/api/compatible/anthropic/managed-agents/addSessionResource) | 添加会话资源 | ◐ 部分支持 | | DELETE | [`/v1/sessions/{session_id}/resources/{resource_id}`](/docs/api/compatible/anthropic/managed-agents/deleteSessionResource) | 删除会话资源 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}/resources/{resource_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveSessionResource) | 读取会话资源 | ◐ 部分支持 | | POST | [`/v1/sessions/{session_id}/resources/{resource_id}`](/docs/api/compatible/anthropic/managed-agents/updateSessionResource) | 更新会话资源 | ○ 未支持 | ### 会话线程（5 个端点，5 个可用） [#会话线程5-个端点5-个可用] | 方法 | 路径 | 说明 | 支持 | | ---- | --------------------------------------------------------------------------------------------------------------------------------- | ------ | ------ | | GET | [`/v1/sessions/{session_id}/threads`](/docs/api/compatible/anthropic/managed-agents/listSessionThreads) | 列出线程 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}/threads/{thread_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveSessionThread) | 读取线程 | ◐ 部分支持 | | POST | [`/v1/sessions/{session_id}/threads/{thread_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveSessionThread) | 归档线程 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}/threads/{thread_id}/events`](/docs/api/compatible/anthropic/managed-agents/listSessionThreadEvents) | 列出线程事件 | ◐ 部分支持 | | GET | [`/v1/sessions/{session_id}/threads/{thread_id}/stream`](/docs/api/compatible/anthropic/managed-agents/streamSessionThreadEvents) | 订阅线程事件 | ◐ 部分支持 | ### 技能（9 个端点，0 个可用） [#技能9-个端点0-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | ------------------------------------------------------------------------------------------------------------------------ | -------- | ----- | | GET | [`/v1/skills`](/docs/api/compatible/anthropic/managed-agents/listSkills) | 列出技能 | ○ 未支持 | | POST | [`/v1/skills`](/docs/api/compatible/anthropic/managed-agents/createSkill) | 创建技能 | ○ 未支持 | | DELETE | [`/v1/skills/{skill_id}`](/docs/api/compatible/anthropic/managed-agents/deleteSkill) | 删除技能 | ○ 未支持 | | GET | [`/v1/skills/{skill_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveSkill) | 读取技能 | ○ 未支持 | | GET | [`/v1/skills/{skill_id}/versions`](/docs/api/compatible/anthropic/managed-agents/listSkillVersions) | 列出技能版本 | ○ 未支持 | | POST | [`/v1/skills/{skill_id}/versions`](/docs/api/compatible/anthropic/managed-agents/createSkillVersion) | 创建技能版本 | ○ 未支持 | | DELETE | [`/v1/skills/{skill_id}/versions/{version}`](/docs/api/compatible/anthropic/managed-agents/deleteSkillVersion) | 删除技能版本 | ○ 未支持 | | GET | [`/v1/skills/{skill_id}/versions/{version}`](/docs/api/compatible/anthropic/managed-agents/retrieveSkillVersion) | 读取技能版本 | ○ 未支持 | | GET | [`/v1/skills/{skill_id}/versions/{version}/content`](/docs/api/compatible/anthropic/managed-agents/downloadSkillVersion) | 下载技能版本内容 | ○ 未支持 | ### 隧道（10 个端点，0 个可用） [#隧道10-个端点0-个可用] | 方法 | 路径 | 说明 | 支持 | | ---- | ----------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----- | | GET | [`/v1/tunnels`](/docs/api/compatible/anthropic/managed-agents/listTunnels) | 列出隧道 | ○ 未支持 | | POST | [`/v1/tunnels`](/docs/api/compatible/anthropic/managed-agents/createTunnel) | 创建隧道 | ○ 未支持 | | GET | [`/v1/tunnels/{tunnel_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveTunnel) | 读取隧道 | ○ 未支持 | | POST | [`/v1/tunnels/{tunnel_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveTunnel) | 归档隧道 | ○ 未支持 | | GET | [`/v1/tunnels/{tunnel_id}/certificates`](/docs/api/compatible/anthropic/managed-agents/listTunnelCertificates) | 列出隧道证书 | ○ 未支持 | | POST | [`/v1/tunnels/{tunnel_id}/certificates`](/docs/api/compatible/anthropic/managed-agents/createTunnelCertificate) | 创建隧道证书 | ○ 未支持 | | GET | [`/v1/tunnels/{tunnel_id}/certificates/{certificate_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveTunnelCertificate) | 读取隧道证书 | ○ 未支持 | | POST | [`/v1/tunnels/{tunnel_id}/certificates/{certificate_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveTunnelCertificate) | 归档隧道证书 | ○ 未支持 | | POST | [`/v1/tunnels/{tunnel_id}/reveal_token`](/docs/api/compatible/anthropic/managed-agents/revealTunnelToken) | 显示隧道令牌 | ○ 未支持 | | POST | [`/v1/tunnels/{tunnel_id}/rotate_token`](/docs/api/compatible/anthropic/managed-agents/rotateTunnelToken) | 轮换隧道令牌 | ○ 未支持 | ### 凭据保险库（13 个端点，13 个可用） [#凭据保险库13-个端点13-个可用] | 方法 | 路径 | 说明 | 支持 | | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- | ------ | | GET | [`/v1/vaults`](/docs/api/compatible/anthropic/managed-agents/listVaults) | 列出凭据库 | ● 支持 | | POST | [`/v1/vaults`](/docs/api/compatible/anthropic/managed-agents/createVault) | 创建凭据库 | ● 支持 | | DELETE | [`/v1/vaults/{vault_id}`](/docs/api/compatible/anthropic/managed-agents/deleteVault) | 删除凭据库 | ● 支持 | | GET | [`/v1/vaults/{vault_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveVault) | 读取凭据库 | ● 支持 | | POST | [`/v1/vaults/{vault_id}`](/docs/api/compatible/anthropic/managed-agents/updateVault) | 更新凭据库 | ● 支持 | | POST | [`/v1/vaults/{vault_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveVault) | 归档凭据库 | ● 支持 | | GET | [`/v1/vaults/{vault_id}/credentials`](/docs/api/compatible/anthropic/managed-agents/listVaultCredentials) | 列出凭据 | ◐ 部分支持 | | POST | [`/v1/vaults/{vault_id}/credentials`](/docs/api/compatible/anthropic/managed-agents/createVaultCredential) | 创建凭据 | ◐ 部分支持 | | DELETE | [`/v1/vaults/{vault_id}/credentials/{credential_id}`](/docs/api/compatible/anthropic/managed-agents/deleteVaultCredential) | 删除凭据 | ◐ 部分支持 | | GET | [`/v1/vaults/{vault_id}/credentials/{credential_id}`](/docs/api/compatible/anthropic/managed-agents/retrieveVaultCredential) | 读取凭据 | ◐ 部分支持 | | POST | [`/v1/vaults/{vault_id}/credentials/{credential_id}`](/docs/api/compatible/anthropic/managed-agents/updateVaultCredential) | 更新凭据 | ◐ 部分支持 | | POST | [`/v1/vaults/{vault_id}/credentials/{credential_id}/archive`](/docs/api/compatible/anthropic/managed-agents/archiveVaultCredential) | 归档凭据 | ◐ 部分支持 | | POST | [`/v1/vaults/{vault_id}/credentials/{credential_id}/mcp_oauth_validate`](/docs/api/compatible/anthropic/managed-agents/validateVaultCredentialMcpOAuth) | 校验凭据 MCP OAuth | ◐ 部分支持 | ## 与官方的差异 [#与官方的差异] * 创建智能体：支持文本提示词、模型、元数据与内置工具。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/\，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。 * 列出会话：支持 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 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/\，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。 * 删除会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/\，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。 * 读取会话资源：支持 file 类型资源的持久化、查询和解除关联，单会话最多 500 条。文件须属于当前租户且有效。默认路径为 /mnt/session/uploads/\，自定义路径归一到该目录，拒绝父目录遍历。不修改文件内容；本批尚不将资源同步到沙箱。 * 列出线程：按 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 官方文档](https://platform.claude.com/docs/en/managed-agents/overview)为准。错误按 Claude Managed Agents 格式返回，参见[错误](/docs/api/errors)；额度与响应头参见[限流](/docs/api/rate-limits)。