获取会话事件历史
本接口用于分页查询会话（Session）的历史事件，包括用户事件、智能体事件、会话状态事件和 span 事件。
返回结果按游标分页：data 为当前页的事件列表，事件对象与订阅会话事件流中完整事件帧的 data 相同；next_page 为下一页游标，没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
每页条数，默认 100，最大 1000；超出范围时返回 400。
翻页游标，取上一页响应的 next_page；第一页不传。
排序方式。
可选值：asc（按时间正序，默认）、desc（按时间倒序）。
按事件类型过滤，可传多个，例如 types[]=agent.message。也支持 types=agent.message 写法。
显示子属性
隐藏子属性
返回创建时间晚于或等于该时刻的事件，RFC 3339 格式。也支持 created_at[gte] 写法。
返回创建时间早于或等于该时刻的事件，RFC 3339 格式。也支持 created_at[lte] 写法。
GET /api/dma/v1/sessions/{session_id}/events?limit=3 HTTP/1.1
Host: api.dumate.cn
Authorization: Bearer <YOUR_API_KEY>示例代码
curl --location --request GET "https://api.dumate.cn/api/dma/v1/sessions/ses_gffe5e3caaadc6ffe126cMcNQZsyuhP/events?limit=3" \
--header 'Authorization: Bearer <YOUR_API_KEY>'返回响应
事件列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
事件标识，sevt_ 前缀。
事件类型。
用户事件：user.message、user.interrupt、user.tool_confirmation、user.custom_tool_result。
智能体事件：agent.message（回复消息）、agent.thinking（开始思考）、agent.tool_use / agent.tool_result（调用内置工具及其结果）、agent.mcp_tool_use / agent.mcp_tool_result（调用 MCP 工具及其结果）、agent.custom_tool_use（调用自定义工具，等待调用方回填）、agent.thread_message_sent / agent.thread_message_received（多 agent 场景下线程间消息）、agent.thread_context_compacted（上下文被压缩）。
会话事件：session.status_running、session.status_idle、session.status_rescheduled、session.status_terminated、session.updated（通过更新会话接口修改会话的 agent 配置时触发；修改 title、metadata、budget 不触发）、session.deleted、session.usage（累计用量快照）、session.error（运行出错）、session.thread_created、session.thread_status_running / _idle / _rescheduled / _terminated。
span 事件：span.model_request_start / span.model_request_end（一次模型请求开始、结束）。
处理时间，RFC 3339 格式，UTC。
内容块列表。
user.message、agent.message、agent.tool_result 等事件返回。
显示子属性
隐藏子属性
内容块，例如 {"type": "text", "text": "..."}。
显示子属性
隐藏子属性
会话进入空闲的原因。
仅 session.status_idle 返回。
显示子属性
隐藏子属性
停止原因。
可选值：end_turn（本轮正常结束，可以发送下一条消息）、requires_action（等待工具确认或工具结果）、retries_exhausted（重试耗尽或达到费用上限，查看 session.error；达到费用上限时错误类型为 billing_error）、refusal（模型拒答）。
等待确认或回填的事件标识，仅 stop_reason.type 为 requires_action 时返回。
显示子属性
隐藏子属性
停止详情；没有时为 null。
仅 session.status_idle 返回。
显示子属性
隐藏子属性
累计用量。
仅 session.usage 返回。
显示子属性
隐藏子属性
输入 token 数。
输出 token 数。
命中缓存的输入 token 数。
写入缓存的 token 数。
显示子属性
隐藏子属性
写入 1 小时缓存的输入 token 数。
写入 5 分钟缓存的输入 token 数。
服务端工具调用次数。
显示子属性
隐藏子属性
web_fetch 调用次数。
web_search 调用次数。
实际运行秒数。
费用。
显示子属性
隐藏子属性
金额，字符串格式。
货币，固定为 POINT（DuMate 积分）。
工具名称，例如 read。
仅 agent.tool_use、agent.mcp_tool_use、agent.custom_tool_use 返回。
工具输入参数。
仅 agent.tool_use、agent.mcp_tool_use、agent.custom_tool_use 返回。
显示子属性
隐藏子属性
权限判定结果，例如 allow。
仅 agent.tool_use、agent.mcp_tool_use 返回。
权限判定依据。
仅 agent.tool_use、agent.mcp_tool_use 返回。
显示子属性
隐藏子属性
生效的权限策略，例如 always_allow。
对应的 agent.tool_use 事件标识。
仅 agent.tool_result 返回。
是否执行失败。
agent.tool_result、span.model_request_end 返回。
对应的 span.model_request_start 事件标识。
仅 span.model_request_end 返回。
本次模型请求的用量。
仅 span.model_request_end 返回。
显示子属性
隐藏子属性
输入 token 数。
输出 token 数。
命中缓存的输入 token 数。
写入缓存的输入 token 数。
错误信息。
仅 session.error 返回。
显示子属性
隐藏子属性
错误类型。
可选值：unknown_error（未知错误）、model_overloaded_error（模型过载）、model_rate_limited_error（模型请求被限流）、model_request_failed_error（模型请求失败）、mcp_connection_failed_error（连接 MCP 服务失败）、mcp_authentication_failed_error（MCP 服务鉴权失败）、billing_error（额度不足）、credential_host_unreachable_error（凭证的目标域名被网络策略拦截）。
显示子属性
隐藏子属性
重试状态，仅 session.error 返回。可选值：retrying、exhausted、terminal。
MCP 服务名称，仅 agent.mcp_tool_use 返回。
对应的 agent.mcp_tool_use 事件标识，仅 agent.mcp_tool_result 返回。
线程标识，仅 session.thread_status_* 返回。
智能体名称，仅 session.thread_status_* 返回。
下一页游标；没有下一页时为 null。
{
"data": [
{
"id": "sevt_msg_g001a1c356cb9c001egSwADPkMC6ZRu",
"type": "user.message",
"processed_at": "2026-11-10T02:43:27.898Z",
"content": [
{
"type": "text",
"text": "读一下这个文件，回复文件第一行"
}
]
},
{
"id": "sevt_ee8e5fb34abe1b677c87cc6abcc1fff7e5cb569824c29ca278f34cb28715afb3",
"type": "session.status_running",
"processed_at": "2026-11-10T02:43:27.898Z"
},
{
"id": "sevt_ebfd2a08ae3a0316a1363195259f8a8f02076034b36517d34b4653c69d9c3c89_start",
"type": "span.model_request_start",
"processed_at": "2026-11-10T02:43:32.745Z"
}
],
"next_page": "mep1.eyJ2IjoxLCJiIjoiYzViOWE1NjgyZmM1MmUxNjcwNTlkNTJjMjE2N2MwMGZkOGZmMDY2ODk2MzU1MDVlNjZkOTk2MTAyZDEzYmRlMSIsInMiOiI0IiwiaSI6InNldnRfZWJmZDJhMDhhZTNhMDMxNmExMzYzMTk1MjU5ZjhhOGYwMjA3NjAzNGIzNjUxN2QzNGI0NjUzYzY5ZDljM2M4OV9zdGFydCJ9.D-jzk4p2x2A_oAyxg69A59EA7NLx_m1x3GWJcvT-Qjk"
}评价此篇文章