← Back to learning path

This chapter has not been reviewed in English; the original Simplified Chinese is shown.

Case · Published

实战:AI 应用流式中断与恢复提示 (original language)

在本地事件流中模拟断网、取消和重试,确保 UI 不把半截结果当作完成。

Source: knowledge/p27/ai-application-development/cases/ai-app-streaming-recovery.mdAI application development
Chapter progress 0%Learning path progress 0% · 0/10 chapters completedContinue learning path →

问题与边界

用户在长回答过程中离开页面,旧客户端把已显示的半截文字保存成成功结果。案例用固定事件流验证序号、断档和取消状态。

方案

事件包含 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'

复现步骤

  1. 用固定 delta、done 和 error 事件建立客户端测试夹具。
  2. 模拟断档和超时,确认渲染层停止追加文本并保留 request id。
  3. 点击重试生成新请求,禁止把旧事件与新事件拼接。
  4. 统计完成、取消、超时和重试,区分自然用户行为与测试事件。

验证清单

验证事件序号、取消、断档、重试和最终完成事件的状态转换。

常见问题

断线后一定能续传吗? 只有服务端支持恢复;否则必须开启新请求并明确提示。

半截结果能直接展示吗? 可以作为草稿,但不能标记为已完成或进入知识库。

延伸阅读

官方参考

OpenAI Structured Outputs;OpenTelemetry traces。

最后核对日期:2026-11-17。涉及版本、接口、模型行为和价格的结论以链接中的官方资料为准;本文不把一次本地运行结果表述为通用性能结论。

Prerequisite tutorials

KnowledgeAI 应用流式输出与部分失败:让用户看见真实状态 (original language)
Product Hub Demo · V0.3