BIbigmodel
Managed Agents - Deployment

创建 Deployment

Changed on

创建定时或手动触发的 Deployment，固定 Agent 版本、环境与任务输入。

<Accordion title="使用说明">

创建一个绑定到指定 Agent 版本和 Environment 的 Deployment。initial_events 必须包含 1 至 50 个 user.message 事件，且仅支持文本和图片内容块（base64、url 或 file 来源）；图片要求生效模型支持图片输入。省略 schedule 或传 null 时创建仅支持手动触发的 Deployment；配置 cron 时目前仅支持 Asia/Shanghai 时区，并受平台最小触发间隔限制。可同时绑定 Vault、Memory Store 和 File 资源。

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

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

Deployment 名称；trim 后不能为空。

environment_idstring required

必填的 Environment ID。Environment 必须存在、未归档，并归属于 Agent 所有者。

descriptionstring nullable

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

metadataManagedMetadata

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

vault_idsstring[]

挂载到每次运行 Session 的 Vault ID；省略时为空，最多 20 个且不得重复。

Example request

{
  "agent": {
    "model": "glm-5.3",
    "skills": [
      {
        "version": "latest"
      }
    ],
    "mcp_servers": [
      {
        "type": "url",
        "name": "knowledge-base",
        "url": "https://mcp.example.com/mcp"
      }
    ]
  },
  "environment_id": "env_019e8f00-1ac2-7a6b-8000-3f2d5c8b9a01",
  "schedule": {
    "expression": "0 9 * * 1-5"
  }
}

Response

新 beta header 的创建成功响应

idstring required
type'deployment' required
namestring required
environment_idstring required

Deployment 绑定的 Environment ID。旧数据缺失该字段时可能返回内部兼容值 env_default。

descriptionstring nullable required

用途说明。

metadataManagedMetadata required

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

status'active' | 'paused' required
vault_idsstring[] required
archived_atstring nullable required

归档时间。

created_atstring date-time required

创建时间。

updated_atstring date-time required

更新时间。

Changes