Skip to main content
POST
创建环境

请求头

Idempotency-Key
string

可选的幂等键。相同的键与请求体会在 24 小时内重放首个响应;以不同的请求体复用,或在首个请求仍在处理时复用,返回 409。

请求体

application/json

创建环境的请求体。

name
string
必填

人类可读的环境名称。不要求唯一。

Required string length: 1 - 256
config
云环境 · object
必填

执行配置。

description
string

可选的人类可读描述。

Maximum string length: 2048
metadata
object

用户自定义元数据(最多 16 条)。

响应

已创建的环境。其首个版本正在构建(构建管道开启时 build_statusbuilding)。

持久化的执行环境,用于托管智能体会话。

id
string
必填

环境 ID。

Pattern: ^env_[0-9a-hjkmnp-tv-z]{26}$
name
string
必填

人类可读的环境名称。

config
云环境 · object
必填

执行配置。

created_at
string<date-time>
必填

创建时间戳。

updated_at
string<date-time>
必填

上次更新时间戳。

scope
enum<string>
必填

可见性范围。

可用选项:
official,
org,
project,
user
description
string

可选的人类可读描述。

metadata
object

用户自定义元数据(最多 16 条)。

build_status
enum<string>

最新版本快照构建的生命周期状态。

可用选项:
building,
ready,
failed
archived_at
string<date-time>

归档时间戳。活跃期间缺省。已归档的环境为只读:不可新建会话,已有会话不受影响,且不可取消归档。