Skip to main content
GET
列出线程事件

路径参数

id
string
必填

会话 ID。

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

线程 ID。

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

查询参数

order
enum<string>

列表排序方式;缺省为 asc(最旧在前)。取 desc 时最新在前,page_token 继续向更早的事件翻页。 事件列表的排序方式:asc(默认,最旧在前)或 desc(最新在前)。processed_at_ascprocessed_at_desc 是同一两个方向的完整写法。事件只追加,因此只有处理顺序。

可用选项:
asc,
desc,
processed_at_asc,
processed_at_desc
page_size
integer<int32>
默认值:50

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

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

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

响应

一页线程的事件历史,最旧在前。

一页会话事件历史,最旧的在前。

items
(用户消息 · object | Agent 消息 · object | Agent 推理 · object | Agent 工具调用 · object | Agent 工具调用结果 · object | 收到线程消息 · object | 发送线程消息 · object | 线程上下文压缩 · object | Agent 增量 · object | 会话状态 · object | 会话错误 · object | 线程创建 · object | 线程状态 · object | 会话标题更新 · object)[]
必填

本页的事件,最旧的排在最前。

用户消息已投递给智能体。data 携带按序排列的内容块;当消息来自输入队列时,事件复用该输入的 event_id 作为自己的 id

next_page_token
string

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

stream_cursor
string

用于从本页末尾恢复实时事件流的游标。恢复点随服务端的每个追加批次推进,因此恢复时可能会重复投递本页已返回的少量事件。客户端必须按事件 id 去重。