获取线程事件历史
本接口用于分页查询指定线程的历史事件，只返回该线程的事件。
返回结果按游标分页：data 为当前页的事件列表，事件类型与获取会话事件历史接口相同；next_page 为下一页游标，没有下一页时为 null。
权限说明
使用 API Key 鉴权调用 API 流程，具体调用流程，请查看认证鉴权。
请求参数
会话标识。
会话不存在时返回 404；会话不属于当前账号时返回 403。
线程标识。
主线程的标识与会话标识相同。
线程不存在时返回 404。
每页条数，默认 100，最大 1000。
超出范围时返回 400。
翻页游标，取上一页响应的 next_page；第一页不传。
GET /api/dma/v1/sessions/{session_id}/threads/{thread_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_gffe5e36678cd3ffe2PBFiopsq4cl0P/threads/ses_gffe5e36678cd3ffe2PBFiopsq4cl0P/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。
线程标识，仅 session.thread_status_* 返回。
智能体名称，仅 session.thread_status_* 返回。
MCP 服务名称，仅 agent.mcp_tool_use 返回。
对应的 agent.mcp_tool_use 事件标识，仅 agent.mcp_tool_result 返回。
下一页游标；没有下一页时为 null。
{
"data": [
{
"id": "sevt_msg_g001a1c998d5be002dZ41fkOgyyjQuQ",
"type": "user.message",
"processed_at": "2026-11-11T07:53:19.174Z",
"content": [
{
"type": "text",
"text": "用一句话介绍你自己"
}
]
},
{
"id": "sevt_95341bc4f2fe84d3bb1e004ba1d0438fd8b7aacc0a1b6409a41079c58972176f",
"type": "session.thread_status_running",
"processed_at": "2026-11-11T07:53:19.174Z",
"session_thread_id": "ses_gffe5e36678cd3ffe2PBFiopsq4cl0P",
"agent_name": "self"
},
{
"id": "sevt_03cc54de96569ba99e71930ef67d971b902d53968560f541b39ebb30e241edf2_start",
"type": "span.model_request_start",
"processed_at": "2026-11-11T07:53:24.355Z"
}
],
"next_page": "mep1.eyJ2IjoxLCJiIjoiMjU2NGJlY2FjNzU5ZmVhMDc4MjVmYzU5ZmQ5YmFiYjZhNjQyOTQxMmJiYzUwYTBlOTIxMWEwNTkwYjFhYTcwZSIsInMiOiI0IiwiaSI6InNldnRfMDNjYzU0ZGU5NjU2OWJhOTllNzE5MzBlZjY3ZDk3MWI5MDJkNTM5Njg1NjBmNTQxYjM5ZWJiMzBlMjQxZWRmMl9zdGFydCJ9.X1LX_PCBE6wwXPczqi0uO0yFCLHcHB9OECG6KHGI-xk"
}评价此篇文章