更新会话
修改会话的标题或智能体覆盖配置。仅 title 与 agent_overrides 可修改,请求体中未出现的字段保持原值。
agent_overrides 在下一个轮次生效。已终止(已归档)的会话拒绝更新,返回 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。
此会话运行的智能体。
托管此会话的环境。
当前生命周期状态。
可用选项:
idle, running, terminated 创建时间戳。
最后更新时间戳。
人类可读的标题。
用户自定义元数据(最多 16 条)。
会话级智能体配置覆盖。未存储任何覆盖时不存在。
归档时间戳。活跃期间不存在。
绑定到此会话的资源。在 GET /v1/sessions 的列表项中省略。
作为资源绑定到会话的文件。
- 文件
- 凭据库
- 记忆库
协调者线程使用的智能体版本快照。