更新智能体

请求参数

• agent_idstring必填

  path: 按智能体 ID 过滤结果。

• namestring可选

  智能体名称；省略保持不变，不能传空串清除。

• modelstring | object可选

  智能体使用的模型：直接写模型名字符串（如 claude-opus-5），或传对象做附加配置（见子字段）。

  ▸ 展开子字段（4）

  • idstring必填

    模型名字符串，如 claude-opus-5。

  • effortstring | object可选

    每次推理的思考力度：可传级别字符串（如 high）或 {type: high} 对象。创建时省略取该模型的默认值；更新时省略保持不变。

  • inference_geostring可选

    模型推理的地理区域；不传沿用工作区默认。model 是整体替换字段，更新时省略子字段即清除该项。

  • speedstring可选

    推理速度模式：fast 出字显著更快但按溢价计费；并非所有模型都支持，不支持的组合在创建时被拒。

• systemstring可选

  系统提示词；省略保持不变，传空串或 null 清除。

• descriptionstring可选

  用途说明；省略保持不变，传空串或 null 清除。

• mcp_serversarray可选○ 未支持

  整体替换的 MCP 服务器列表；省略保持不变，传空数组或 null 清除。

• metadataobject可选

  元数据补丁：键设为字符串即写入，设为 null 即删除；省略该字段保持不变。存储上限 16 个键、每个值 512 字符。

• multiagentobject可选

  多智能体协作拓扑：会话主线程作为协调者，从 agents 名单派生会话线程执行工作。

  ▸ 展开子字段（2）

  • agentsarray必填

    协调者可以派生为会话线程的智能体名单，1–20 项；支持 ID 字符串、{type: agent, id, version?} 和最多一个 {type: self}。创建/更新时固定版本。成员须唯一、存在且未归档，不能自身带 multiagent。每个 coordinator 最多一个 advisor，模型须可用且不同于智能体模型；仅主会话可咨询，每次咨询为独立 advisor 线程，建议以 agent.thread_message_received 返回。

  • typestring必填

    拓扑类型，目前只有 coordinator。

    取值 coordinator
• skillsarray可选○ 未支持

  整体替换的 Skill 列表；省略保持不变，传空数组或 null 清除。

• toolsarray可选

  整体替换的工具配置；省略保持不变，传空数组或 null 清除。

• ▸ 更多参数（1）

  • versionnumber可选

    智能体当前版本号，用于并发保护：必须与最近一次创建/读取返回的版本一致，否则返回冲突。

返回

200

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 返回。

错误按 Claude Managed Agents 格式返回，参见 错误码