Skip to main content
POST
创建 Agent

Authorizations

Authorization
string
header
required

标准的 HTTP Bearer 认证方式,在 API Keys 页面获取密钥。

Headers

zai-version
enum<string>
default:2026-05-26
required

Managed Agents API 入口要求的基础协议标识,当前只接受 2026-05-26;响应兼容形态由 zai-beta 选择。两个头均需携带。

Available options:
2026-05-26
Example:

"2026-05-26"

zai-beta
string
default:managed-agents-2026-09-22
required

声明 Managed Agents Beta 协议并选择响应字段与兼容行为。新接入使用 managed-agents-2026-09-22;旧客户端仍可使用 managed-agents-2026-05-26。必须同时携带 zai-version: 2026-05-26。字段差异见 /cn/managed-agents/protocol-versions。

Example:

"managed-agents-2026-09-22"

Body

application/json
name
string
required

Agent 名称,长度 1–256 个字符。

Required string length: 1 - 256
model
default:glm-5.3
required

模型 ID,或包含推理强度与速度的模型配置。当前支持 glm-5.3、glm-5.3-flash 与 glm-5.3-flashx。使用字符串简写时,服务端按模型补齐默认 effort,并将 speed 补为 standard。

Available options:
glm-5.3,
glm-5.3-flash,
glm-5.3-flashx
Example:

"glm-5.3"

system
string | null

系统提示词;省略或传 null 时不设置。

Maximum string length: 100000
description
string | null

Agent 用途说明;省略或传 null 时不设置。

Maximum string length: 2048
tools
(agent_toolset_20260601 · object | mcp_toolset · object | custom · object)[]

工具集列表;省略时为空。MCP Server 必须与 mcp_toolset 按名称一一对应;配置 Skill 时必须包含 agent_toolset_20260601。

Maximum array length: 128
skills
object[]

Skill 引用;省略时为空。version 省略或传 null 时跟随 latest,传具体版本号时固定版本;同一 skill_id 与生效 version 组合不得重复。配置 Skill 时必须同时配置 agent_toolset_20260601。

Maximum array length: 20
mcp_servers
object[]

MCP Server 列表;省略时为空。名称必须唯一,并且每个 Server 必须恰好对应一个同名 mcp_toolset。

Maximum array length: 20
metadata
object

客户端自定义元数据;省略时默认为空对象。最多 16 个键,键名长度不超过 64 字符,值必须是长度不超过 512 字符的字符串。

multiagent
object | null

可选,Multi Agent 主配置。null 清空,创建/更新时固定成员版本;Session override 不支持改 Agent 列表。

Response

新 beta header 的创建成功响应

id
string
required

Agent ID。

Example:

"agent_01911111-1111-7111-8111-111111111111"

type
enum<string>
required
Available options:
agent
name
string
required
description
string | null
required

用途说明。

model
object
required
system
string | null
required

系统提示词。

tools
(agent_toolset_20260601 · object | mcp_toolset · object | custom · object)[]
required
skills
object[]
required
mcp_servers
object[]
required
metadata
object
required

客户端自定义元数据;省略时默认为空对象。最多 16 个键,键名长度不超过 64 字符,值必须是长度不超过 512 字符的字符串。

version
integer
required
Required range: x >= 0
created_at
string<date-time>
required

创建时间。

updated_at
string<date-time>
required

更新时间。

archived_at
string | null
required

归档时间;未归档时为 null。

multiagent
object | null

可选,Multi Agent 主配置。null 清空,创建/更新时固定成员版本;Session override 不支持改 Agent 列表。