Skip to main content
GET
列出会话

查询参数

order
enum<string>

列表排序。默认为 updated_at_desc。 列出会话时使用的排序:updated_at_desc(默认)、updated_atcreated_at_desccreated_at

可用选项:
created_at,
created_at_desc,
updated_at,
updated_at_desc
agent_id
string

将列表限定为运行该智能体的会话。

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

将列表限定为固定到该智能体版本的会话(按资源递增的数字版本号,例如 "2")。通常与 agent_id 组合使用。

statuses
enum<string>[]

将列表限定为这些生命周期状态。省略表示不过滤状态。

会话或线程的当前生命周期状态。

  • idle:未在执行。接受新输入。
  • running:正在执行一个轮次。
  • terminated:归档后的最终状态。
可用选项:
idle,
running,
terminated
include_archived
boolean

包含已归档的会话。省略时不包含。

page_size
integer<int32>
默认值:50

返回的条目数,1 到 1000(默认 50)。

必填范围: 1 <= x <= 1000
page_token
string

来自上一次响应 next_page_token 的不透明分页令牌。

响应

一页会话,按请求的排序返回。列表项省略 resources

一页会话。列表项省略 resources 绑定。

items
object[]
必填

本页的会话。

next_page_token
string

下一页的分页令牌。列表耗尽时缺省。