创建智能体
创建智能体及其首个不可变版本("1")。
- 省略
version(或使用"latest")的技能引用会固定到确切版本。插件版本始终固定为当前采纳的版本,必须省略。 multiagent名册在写入时解析为固定的智能体版本。
请求头
本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。
平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。
2026-09-01-beta 可选的幂等键。相同的键与请求体会在 24 小时内重放首个响应;以不同的请求体复用,或在首个请求仍在处理时复用,返回 409。
请求体
创建智能体的请求体。同时创建第一个不可变版本。
人类可读的智能体名称。
1 - 256所选模型。
可选的人类可读描述。
2048系统提示词。
100000智能体可用的工具。
128内置智能体工具集声明。
- Agent 工具集
- MCP 工具集
智能体可用的 MCP 服务器连接。名称必须唯一。
20智能体可用的技能。
智能体可用的插件。
用户自定义元数据(最多 16 条)。
允许智能体创建子线程的配置。
响应
已创建的智能体,处于首个不可变版本。
持久化的、带版本管理的智能体配置。
智能体 ID。
人类可读的智能体名称。
所选模型。
智能体当前的不可变版本。
创建时间戳。
最后更新时间戳。
可见性范围。
official, org, project, user 可选的人类可读描述。
系统提示词。
智能体可用的工具。
内置智能体工具集声明。
- Agent 工具集
- MCP 工具集
智能体可用的 MCP 服务器连接。
智能体可用的技能版本,在写入时冻结。
智能体可用的插件,在写入时冻结。
用户自定义元数据(最多 16 条)。
归档时间戳。处于活跃状态时不存在。
解析后的子智能体配置。单智能体时不存在。