GET /runs/{runID}/events
SSE 事件重放。用于 SSE 断开后重连续播。
GET /cells/{cellID}/runs/{runID}/events?from_seq=N
查询参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
from_seq | integer | 否 | 从第 N 个事件开始重放(0-based);不传则从头重放 |
curl 示例
# 从第 42 个事件开始续播
curl -N http://localhost:9091/cells/my-cell/runs/run-abc123/events?from_seq=42 \
-H "Authorization: Bearer $TOKEN"
响应
Content-Type: text/event-stream
与 POST /run 产出的事件流格式完全相同。事件按 seq 顺序重放。
data: {"type":"stream_delta","content":"续播内容...","seq":42}
data: {"type":"done","reason":"end_turn","run_id":"run-abc123","seq":43}
使用场景
- SSE 断线重连:客户端记录最后收到的
seq,断线后用from_seq续播 - 审计回放:重放某次 Run 的完整事件流
- 调试:检查某次 Run 的工具调用和模型输出
注意事项
- Run 的事件由
RunEventBuffer保存在内存中,Run 完成后持久化 - 如果 Run 仍在执行,此端点会实时推送新事件
- 不存在的
runID返回 404