cURL
鉴权
string
header
必填
DashScope API Key
请求体
application/jsonstring
必填
智能体名称,用于在控制台与列表中辨识
object
必填
模型配置,id 必填,可选 enable_thinking、temperature、max_tokens、thinking_budget
string
智能体用途说明
string
系统提示词,定义角色与行为约束
object[]
工具包列表,按类型分组。每项含 type(builtin_toolkit | mcp_toolkit)、default_config、configs,MCP 类还需 mcp_server_name。builtin_toolkit 至多一项,mcp_toolkit 可多项
object[]
MCP Server 引用列表,每项含 type(official | customer)与 name
object[]
挂载的技能列表,每项含 type(official | customer)、skill_id 与 version(必须锁定到具体版本号)
object
多智能体协作配置。不传或为空表示单智能体;配置后该智能体作为 coordinator 编排编队成员
object
业务自定义键值,不影响模型行为
响应
200-application/json
string
智能体 ID,格式 agent_<ULID>
string
固定为 agent
integer
当前版本号,每次更新自动递增;会话创建时锁定该值
string
智能体名称
string
智能体用途说明
object
模型配置
string
系统提示词
object[]
工具包列表
object[]
MCP Server 引用列表
object[]
挂载技能列表
object
多智能体协作配置。不传或为空表示单智能体
object
业务自定义键值,不影响模型行为
string | null
归档时间,未归档时为 null
string
创建时间,ISO 8601
string
最近更新时间,ISO 8601
string
所属业务空间 ID
string
本次请求的唯一标识,排查问题时附带