AI 助理
文档备案控制台
官方文档
首页

列出 Event

更新时间：
复制 MD 格式
产品详情
我的收藏

分页查询会话历史事件，返回结构同 SSE 帧的 data。支持时间窗口过滤与排序。

前提

已创建会话，详见创建 Session。{session_id} 形如 sesn_xxx...。

接口

GET /sessions/{session_id}/events

返回结构同 SSE 帧的 data。事件信封字段含义详见订阅 Event SSE 事件流中的事件信封一节。

Query 参数

参数

类型

默认

说明

order

string

asc

排序方向：asc（升序）| desc（降序）

created_at[gt] / [gte] / [lt] / [lte]

string

—

按时间窗口过滤，ISO 8601；四个比较运算符可组合

limit

int

20

每页数量，最大 100

page

string

—

首次不传，后续传上一次响应的 next_page

请求示例

curl "$AGENTSTUDIO_URL/sessions/sesn_xxx/events?order=asc&limit=100" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
for event in client.sessions.events.list(
    "sesn_xxx",
    limit=100,
    order="asc",
):
    print(event.type, event.created_at)
CursorPage<SessionEvent> events = client.sessions().events().list("sesn_xxx",
    SessionEventListParam.builder()
        .limit(100)
        .order("asc")
        .build());
for (SessionEvent ev : events.getData()) {
    System.out.println("[" + ev.getType() + "] " + ev.getCreatedAt());
}

响应说明

返回 data（事件 Message 对象数组，结构同 SSE 帧的 data 字段，详见订阅 Event SSE 事件流）、next_page（下一页游标，无更多数据时不返回或为 null）与 request_id。Message 对象字段如下：

响应字段

字段

类型

说明

data

array<object>

事件 Message 对象数组，按 order 排序

data[].object

string

恒为 message

data[].id

string

事件 ID，前缀 msg_ 或 out_

data[].created_at

string

事件时间戳，ISO 8601

data[].role

string

user | assistant | tool

data[].type

string

事件类型，取值同 SSE 服务端推送事件，详见订阅 Event SSE 事件流

data[].content

array<object>

ContentBlock 数组，结构同发送侧

data[].metadata

object

事件附加信息（如 thread_id、call_id 等）

next_page

string | null

下一页游标；无更多数据时不返回或为 null

request_id

string

本次请求的唯一标识
上一篇：发送 Event下一篇：订阅 Event SSE 事件流