BIbigmodel
Managed Agents - Deployment

手动运行 Deployment

Changed on

立即触发一次 Deployment Run，返回 202 Accepted。可查询运行记录和关联会话。

<Accordion title="使用说明">

立即为指定 Deployment 创建一次手动触发的 Deployment Run，并返回 202 Accepted。手动运行不会推进 cron 的下一次执行时间，可在 Deployment 暂停时执行，但不能对已归档 Deployment 执行。

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

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。

Response

请求成功。

idstring required
type'deployment_run' required
deployment_idstring required
session_idstring nullable required

该次运行创建的会话 ID。刚返回时可能为 null，通常数秒后填上。

created_atstring date-time required

创建时间。

Changes