创建智能体

请求体

• namestring必填

  智能体名称，1–255 个字符，工作区内可读。

• modelstring | object必填

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

  ▸ 展开子字段（4）

  • idstring必填

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

  • effortstring | object可选

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

  • inference_geostring可选

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

  • speedstring可选

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

• systemstring可选

  智能体的系统提示词。

• descriptionstring可选

  智能体的用途说明。

• mcp_serversarray可选○ 未支持

  智能体连接的 MCP 服务器列表，最多 20 个，名称必须唯一；每个服务器都要被 tools 里的 mcp_toolset 引用，否则整笔请求被拒。

  ▸ 展开子字段（3）

  • namestring必填

    MCP 服务器在本列表内的唯一名称，1–255 个字符，供 mcp_toolset 配置引用。

  • typestring必填

    服务器类型，目前只支持 url。

    取值 url
  • urlstring必填

    MCP 服务器的端点地址。

• metadataobject可选

  自定义元数据键值对，最多 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 列表。

• toolsarray可选

  智能体可用的工具配置，所有工具合计最多 128 个。

返回

200

支持文本提示词、模型、元数据与内置工具。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 返回。

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