问题与边界
用户在长回答过程中离开页面,旧客户端把已显示的半截文字保存成成功结果。案例用固定事件流验证序号、断档和取消状态。
方案
事件包含 request_id、sequence、type 和文本增量。客户端只在收到 done 后标记完成,断档或 error 进入可重试状态,并显示原始请求 id。
最小实现
events = [
{'sequence': 1, 'type': 'delta', 'text': 'A'},
{'sequence': 2, 'type': 'error', 'code': 'timeout'},
]
status = 'streaming'
for event in events:
if event['type'] == 'error':
status = 'retryable_error'
assert status == 'retryable_error'
复现步骤
- 用固定 delta、done 和 error 事件建立客户端测试夹具。
- 模拟断档和超时,确认渲染层停止追加文本并保留 request id。
- 点击重试生成新请求,禁止把旧事件与新事件拼接。
- 统计完成、取消、超时和重试,区分自然用户行为与测试事件。
验证清单
验证事件序号、取消、断档、重试和最终完成事件的状态转换。
常见问题
断线后一定能续传吗? 只有服务端支持恢复;否则必须开启新请求并明确提示。
半截结果能直接展示吗? 可以作为草稿,但不能标记为已完成或进入知识库。
延伸阅读
官方参考
OpenAI Structured Outputs;OpenTelemetry traces。
最后核对日期:2026-11-17。涉及版本、接口、模型行为和价格的结论以链接中的官方资料为准;本文不把一次本地运行结果表述为通用性能结论。
