← 返回學習路線

此章節尚未完成繁體中文或英文審核,目前顯示簡體中文原文。

案例 · 已發布

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

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

來源: knowledge/p27/ai-application-development/cases/ai-app-streaming-recovery.mdAI 應用開發
本章閱讀進度 0%學習路線進度 0% · 0/10 已完成章節繼續學習路線 →

问题与边界

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

方案

事件包含 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。涉及版本、接口、模型行为和价格的结论以链接中的官方资料为准;本文不把一次本地运行结果表述为通用性能结论。

前置知識與教學

知識AI 应用流式输出与部分失败:让用户看见真实状态 (原文)

延伸閱讀

知識AI Agent:從基礎概念到實際應用
產品中心 Demo · V0.3