Skip to main content
POST
创建 Deployment

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。

Available options:
2026-05-26
Example:

"2026-05-26"

zai-beta
string
default:managed-agents-2026-05-26
required

必须包含 managed-agents-2026-05-26;可与其他 beta 标识用逗号分隔。

Example:

"managed-agents-2026-05-26"

Body

application/json
name
string
required

Deployment 名称;trim 后不能为空。

Minimum string length: 1
agent
required

要固定的 Agent 版本或带覆盖的 Agent 引用;创建后每次运行都使用该固定配置。

Minimum string length: 1
environment_id
string
required

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

Maximum string length: 64
Pattern: ^env_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Example:

"env_019e8f00-1ac2-7a6b-8000-3f2d5c8b9a01"

initial_events
object[]
required

每次运行时注入的 1–50 条 user.message;内容仅允许文本或 base64 图片。

Required array length: 1 - 50 elements
schedule
object | null

Cron 调度;省略或传 null 时为仅手动运行。

description
string | null

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

metadata
object

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

vault_ids
string[]

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

Maximum array length: 20
Minimum string length: 1
resources
(memory_store · object | file · object)[] | null

挂载到每次运行 Session 的资源;省略或传 null 时为空。默认平台上限为 500 个 file 与 8 个 memory_store,实际上限可调整;文件 mount_path 不得重叠。

Response

请求成功。

id
string
required
type
enum<string>
required
Available options:
deployment
name
string
required
agent
object
required
environment_id
string
required

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

description
string | null
required

用途说明。

metadata
object
required

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

resources
(memory_store · object | file · object)[]
required
schedule
object | null
required
initial_events
object[]
required
status
enum<string>
required
Available options:
active,
paused
paused_reason
manual · object
required

暂停原因。手动暂停返回 manual;因资源失效自动暂停时返回对应错误类型。

vault_ids
string[]
required
archived_at
string | null
required

归档时间。

created_at
string<date-time>
required

创建时间。

updated_at
string<date-time>
required

更新时间。