BIbigmodel
Managed Agents - Deployment

更新 Deployment

Changed on

更新 Deployment 的配置、任务输入与调度，或重新固定同一 Agent 的版本。

<Accordion title="使用说明">

更新指定 Deployment 的可变配置。支持 name、description、metadata、initial_events、environment_id、vault_ids、resources、schedule 和 agent；agent 只能重新固定同一个 Agent 的版本或覆盖配置，不能切换 Agent ID。schedule: null 会改为仅手动触发，resources: null 和 metadata: null 会清空对应配置，environment_id: null 会保留原值。已归档 Deployment 不可更新。

</Accordion>
post/agent/managed/v1/deployments/{deploymentId}

Request

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

Path parameters

deploymentIdstring required

deploymentId 资源标识。

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

替换名称；trim 后不能为空，省略时保持不变。

environment_idstring nullable

重新绑定 Environment。字符串值必须指向 Agent 所有者名下未归档的 Environment；传 null 会保留原值。

descriptionstring nullable

替换用途说明；非字符串值（包括 null）会清空，省略时保持不变。

metadataobject nullable

整体替换 metadata；null 表示清空，省略时保持不变。键名不超过 64 字符，值为不超过 512 字符的字符串。

vault_idsstring[]

整体替换 Vault ID；省略时保持不变。

Example request

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

Response

请求成功。

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