BIbigmodel
Managed Agents - Environment

创建 Environment

Changed on

创建供 Managed Session 和 Deployment 使用的云端 Environment。可配置预装软件包和网络策略；省略配置时使用平台默认设置。

post/agent/managed/v1/environments

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

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

descriptionstring nullable

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

metadataManagedMetadata

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

scope'organization' nullable

公开 API 仅支持 organization；省略或传 null 时也使用 organization。

Response

请求成功。

idstring required

Environment ID。

type'environment' required
namestring required
descriptionstring nullable required

用途说明。

metadataManagedMetadata required

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

scope'organization' required
state'active' | 'archived' required
archived_atstring nullable required

归档时间。

created_atstring date-time required

创建时间。

updated_atstring date-time required

更新时间。

Example response

{
  "id": "env_019e8f00-1ac2-7a6b-8000-3f2d5c8b9a01"
}

Changes