Skip to main content
PATCH
更新环境

路径参数

id
string
必填

环境 ID。

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

请求体

application/json

更新环境的部分更新请求体。展示字段就地更新。替换 config 会生成一个新的不可变版本,仅由之后创建的会话固定使用。config 类型不可变更。

name
string

人类可读的环境名称。空值会被拒绝:名称不能清空。

Maximum string length: 256
description
string

可选的人类可读描述。空值会清空描述。

Maximum string length: 2048
config
云环境 · object

替换执行配置。

metadata
object

替换元数据。空值会清空整个映射。

响应

更新后的环境,携带新的不可变版本。

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

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>

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