Skip to main content
PATCH
更新会话

路径参数

id
string
必填

会话 ID。

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

请求体

application/json

更新会话的部分更新请求体。目前仅 titleagent_overrides 可修改。

title
string

新的人类可读标题。

Maximum string length: 256
agent_overrides
object

替换会话级的智能体覆盖配置:每个出现的集合都会整体替换该集合的覆盖值(空数组会清空它并回退到冻结的智能体值)。未出现的集合保持当前覆盖值不变。

响应

应用了修改的会话。

带版本智能体配置的一个运行实例。

id
string
必填

会话 ID。

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

此会话运行的智能体。

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

托管此会话的环境。

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

当前生命周期状态。

可用选项:
idle,
running,
terminated
created_at
string<date-time>
必填

创建时间戳。

updated_at
string<date-time>
必填

最后更新时间戳。

title
string

人类可读的标题。

metadata
object

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

agent_overrides
object

会话级智能体配置覆盖。未存储任何覆盖时不存在。

archived_at
string<date-time>

归档时间戳。活跃期间不存在。

resources
(文件 · object | 凭据库 · object | 记忆库 · object)[]

绑定到此会话的资源。在 GET /v1/sessions 的列表项中省略。

作为资源绑定到会话的文件。

agent
object

协调者线程使用的智能体版本快照。