更新环境
仅修改请求体中出现的字段。null 值视为未提供,传入空对象或空数组可清空对应集合。
每次更新——包括仅修改元数据——都会冻结一个新的不可变版本并开始构建。只有之后创建的会话会使用新版本。配置类型不能更改。已归档的环境拒绝更新(400 failed_precondition_error)。
PATCH
更新环境
请求头
本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。
平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。
可用选项:
2026-09-01-beta 路径参数
环境 ID。
请求体
application/json
响应
更新后的环境,携带新的不可变版本。
持久化的执行环境,用于托管智能体会话。
环境 ID。
人类可读的环境名称。
执行配置。
创建时间戳。
上次更新时间戳。
可见性范围。
可用选项:
official, org, project, user 可选的人类可读描述。
用户自定义元数据(最多 16 条)。
最新版本快照构建的生命周期状态。
可用选项:
building, ready, failed 归档时间戳。活跃期间缺省。已归档的环境为只读:不可新建会话,已有会话不受影响,且不可取消归档。