`GET https://ark.cn-beijing.volces.com/api/v3/sessions/{session_id}/events` 分页查询会话主线程中已经产生的事件，支持按事件处理时间和事件类型筛选。实时接收事件请使用 [流式获取会话事件](https://ark.volcengine.com/region:cn-beijing/docs/ark/stream-events-api)，查询子线程事件请使用 [获取线程事件列表](https://ark.volcengine.com/region:cn-beijing/docs/ark/list-thread-events-api)。返回字段随事件类型变化，详情请参见 [会话事件结构参考](https://ark.volcengine.com/region:cn-beijing/docs/ark/sessions-events-reference-v2)。

说明

默认按事件产生时间正序返回（从旧到新）。

## 鉴权本接口支持鉴权方式如下，详情请参见 [Base URL 及鉴权](https://ark.volcengine.com/region:cn-beijing/docs/ark/base-url-and-authentication)。 * API Key 鉴权，请在 [API Key 管理](https://ark.volcengine.com/region:cn-beijing/apiKey) 页面，获取长效 API Key。 --- ## 请求参数 ### Path 参数 **session_id** `string` `必选` | 会话 ID 填写要查询事件的会话 ID，形如 `sesn-...` ### Query 参数 > 在 URL Query String 中传入。 **created_at[gt]** `string` | 起始时间（不含）事件处理时间的起始边界（不含），采用 RFC 3339 格式。同时传入多个时间边界时，仅返回满足全部边界条件的事件 **created_at[gte]** `string` | 起始时间（含）事件处理时间的起始边界（含），采用 RFC 3339 格式。同时传入多个时间边界时，仅返回满足全部边界条件的事件 **created_at[lt]** `string` | 结束时间（不含）事件处理时间的结束边界（不含），采用 RFC 3339 格式。同时传入多个时间边界时，仅返回满足全部边界条件的事件 **created_at[lte]** `string` | 结束时间（含）事件处理时间的结束边界（含），采用 RFC 3339 格式。同时传入多个时间边界时，仅返回满足全部边界条件的事件 **limit** `integer` `默认值 50` | 每页事件数每页返回的事件数量。

说明

当 limit 大于 200 时，服务端会按 200 处理，不会返回参数错误。

**取值范围**：`[1, 200]` **order** `string` `默认值 asc` | 排序方向排序方向，`asc` 按事件产生时间正序（从旧到新），`desc` 倒序。 **page** `string` | 下一页标识下一页标识。请将上一页返回的 `next_page` 原样传入；不传则从第一页开始 **types** `string[]` | 事件类型筛选按事件类型筛选，可重复传入，例如 `types=user.message&types=agent.message`。支持的取值请参见 [会话事件结构参考](https://ark.volcengine.com/region:cn-beijing/docs/ark/sessions-events-reference-v2) ## 响应参数 **data** `object[]` | 事件列表本接口返回会话主线程中的历史事件，包括用户输入、智能体输出、会话状态，以及模型调用与结果评估事件。每个事件对象包含 `id`、`type`、`processed_at` 和随 `type` 变化的业务字段。只有对应事件结构明确包含时，才会返回 `session_thread_id`；主线程中的常规消息通常不含该字段。子智能体线程内部的消息和工具调用，需通过对应线程的事件列表接口查询。完整事件类型和字段结构见 [会话事件结构参考](https://ark.volcengine.com/region:cn-beijing/docs/ark/sessions-events-reference-v2)。 **id** `string` | 事件 ID `data.id` 事件唯一标识符，形如 `sevt-...` **processed_at** `string` | 处理时间 `data.processed_at` 事件处理时间，采用 RFC 3339 格式 **type** `string` | 事件类型 `data.type` 事件类型（如 `user.message`、`agent.message`、`session.status_idle` 等） **next_page** `string` | 下一页标识下一页标识，请原样传入下一次请求的 `page` 参数；无更多数据时不返回该字段

火山方舟