跳转到主要内容
千问AI平台 home page
文档
Session & Event

列出 Event

列出会话的所有事件

GET
/api/v1/agentstudio/sessions/{session_id}/events
cURL
curl --request GET \
  --url 'https://dashscope.aliyuncs.com/api/v1/agentstudio/sessions/{session_id}/events' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'
{
  "data": [
    {
      "object": "message",
      "id": "msg_001",
      "created_at": "2025-10-24T08:15:30.500Z",
      "status": "completed",
      "role": "assistant",
      "type": "message",
      "content": [
        {
          "type": "text",
          "text": "开始分析"
        }
      ],
      "metadata": {}
    }
  ],
  "next_page": null,
  "request_id": "req_xxx"
}

types 过滤

types 按事件类型过滤，可重复传入（如 ?types=message&types=tool_approval_request），省略则返回全部。常用场景：
  • 断线/刷新后恢复审批卡片：用 types=tool_approval_request 补拉当前批次的审批请求，再按 (batch_id, call_id) 关联
  • 补拉运行期错误（如 pending_tool_approval_unresolved、invalid_tool_approval）：用 types=error，错误详情位于 Message 顶层的 error 对象（error.code / error.message），不在 content[].data 中

鉴权

​
string
header
必填

DashScope API Key

路径参数

​
string
必填

查询参数

​
enum<string>[]

按事件类型过滤，可重复传入。断线/刷新后可用 types=tool_approval_request 补拉审批、types=error 补拉运行期错误（错误详情在 Message 顶层 error 对象，不在 content[].data 中）

​
enum<string>
默认值"asc"

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

可选值：asc,desc
​
string

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

​
string

按时间窗口过滤（大于等于），ISO 8601

​
string

按时间窗口过滤（小于），ISO 8601

​
string

按时间窗口过滤（小于等于），ISO 8601

​
integer
默认值20

每页数量，最大 100

​
string

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

响应

200-application/json
​
(普通事件 · object | error 事件 · object)[]

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

message / tool_call / tool_call_output / tool_approval_request / tool_approval_response / function_call / function_call_output / mcp_call / mcp_call_output / session_status 事件

  • 普通事件
  • error 事件
​
string | null

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

​
string

本次请求的唯一标识