列出会话
返回调用方的会话,最近更新的排在最前,除非 order 另有指定。列表项省略 resources 绑定。请使用 GET /v1/sessions/{id} 获取。
agent_id 将列表限定为一个智能体,agent_version 限定为其某个固定版本,statuses 限定为给定的生命周期状态。除非 include_archived 为 true,否则不包含已归档的会话。
请求头
本次请求使用的 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 查询参数
列表排序。默认为 updated_at_desc。
列出会话时使用的排序:updated_at_desc(默认)、updated_at、created_at_desc 或 created_at。
created_at, created_at_desc, updated_at, updated_at_desc 将列表限定为运行该智能体的会话。
将列表限定为固定到该智能体版本的会话(按资源递增的数字版本号,例如 "2")。通常与 agent_id 组合使用。
将列表限定为这些生命周期状态。省略表示不过滤状态。
会话或线程的当前生命周期状态。
idle:未在执行。接受新输入。running:正在执行一个轮次。terminated:归档后的最终状态。
idle, running, terminated 包含已归档的会话。省略时不包含。
返回的条目数,1 到 1000(默认 50)。
1 <= x <= 1000来自上一次响应 next_page_token 的不透明分页令牌。