列出会话事件
分页返回会话的事件历史,最旧的在前——即协调者线程的事件。仅供流式传输的 agent.delta 事件从不出现在历史中。
使用最后一页的 stream_cursor,可从历史结束的位置恢复实时流。order 取 *_desc 时最新在前,此时 page_token 继续向更早的事件翻页。
请求头
本次请求使用的 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。
查询参数
列表排序方式;缺省为 asc(最旧在前)。取 desc 时最新在前,page_token 继续向更早的事件翻页。
事件列表的排序方式:asc(默认,最旧在前)或 desc(最新在前)。processed_at_asc 与 processed_at_desc 是同一两个方向的完整写法。事件只追加,因此只有处理顺序。
asc, desc, processed_at_asc, processed_at_desc 返回的条目数,1 到 1000(默认 50)。
1 <= x <= 1000来自上一次响应 next_page_token 的不透明分页令牌。
响应
一页事件历史,最旧在前,携带用于恢复实时流的 stream_cursor。
一页会话事件历史,最旧的在前。
本页的事件,最旧的排在最前。
用户消息已投递给智能体。data 携带按序排列的内容块;当消息来自输入队列时,事件复用该输入的 event_id 作为自己的 id。
- 用户消息
- Agent 消息
- Agent 推理
- Agent 工具调用
- Agent 工具调用结果
- 收到线程消息
- 发送线程消息
- 线程上下文压缩
- Agent 增量
- 会话状态
- 会话错误
- 线程创建
- 线程状态
- 会话标题更新
下一页的分页令牌。列表耗尽时缺省。
用于从本页末尾恢复实时事件流的游标。恢复点随服务端的每个追加批次推进,因此恢复时可能会重复投递本页已返回的少量事件。客户端必须按事件 id 去重。