BIbigmodel
Managed Agents - Agent

创建 Agent

Changed on

创建 Agent 及其首个不可变版本，配置模型、系统提示词、工具、Skills 与 MCP。

<Accordion title="使用说明">

创建 Agent 及其首个不可变版本。可配置模型、系统提示词、内置或自定义工具、Skill 和 MCP Server；配置 MCP Server 时必须同时提供引用同名服务器的 mcp_toolset，不使用 MCP 时请省略这两个字段。

</Accordion>
post/agent/managed/v1/agents

Request

  • Base URL
    https://agent-api.bigmodel.cn/api
  • Auth
    HTTP bearer

Headers

zai-version'2026-05-26' required
Example:2026-05-26

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

zai-betastring required
Example:managed-agents-2026-09-22

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

Request body

namestring required

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

systemstring nullable

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

descriptionstring nullable

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

metadataManagedMetadata

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

Example request

{
  "name": "support-agent",
  "model": "glm-5.3",
  "system": "你是一个专业的客户支持助手。",
  "tools": [
    {
      "type": "agent_toolset_20260601"
    }
  ]
}

Response

新 beta header 的创建成功响应

idstring required

Agent ID。

type'agent' required
namestring required
descriptionstring nullable required

用途说明。

systemstring nullable required

系统提示词。

metadataManagedMetadata required

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

versioninteger required
created_atstring date-time required

创建时间。

updated_atstring date-time required

更新时间。

archived_atstring nullable required

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

Example response

{
  "id": "agent_01911111-1111-7111-8111-111111111111",
  "type": "agent",
  "name": "support-agent",
  "description": null,
  "model": {
    "id": "glm-5.3",
    "effort": {
      "type": "max"
    },
    "speed": "standard"
  },
  "system": null,
  "tools": [
    {
      "type": "agent_toolset_20260601",
      "default_config": {
        "enabled": true,
        "permission_policy": {
          "type": "always_allow"
        }
      },
      "configs": []
    }
  ],
  "skills": [],
  "mcp_servers": [],
  "metadata": {},
  "multiagent": null,
  "version": 1,
  "created_at": "2026-08-31T08:00:00.000Z",
  "updated_at": "2026-08-31T08:00:00.000Z",
  "archived_at": null
}

Changes