可恢复流

定义

可恢复流（Resumable Stream）是生产级 Agent 流式输出的关键能力：客户端断线后能从断点继续接收事件。它建立在"流式输出不是 token 打字机，而是任务事件流"这一认知之上——把状态变化、消息增量、工具进展、Artifact 增量和错误统一编码成事件流。

要点

• 与部署形态强相关：进程内 Agent（Library）用 AsyncGenerator 即可，不会断连；一旦跨网络部署（Server），SSE + 可恢复流成为刚需。
• 实现三要素：事件持久化（如 Redis Stream XADD）、Last-Event-ID 标识断点、先 Catch-up 回放历史事件再切 Live Tail 实时事件。
• 服务端配置：stream_resumable: true + on_disconnect: "continue"——客户端断线、服务端继续执行、之后补收事件是生产系统常态。
• SSE 被作者判定为会持久的流式标准：HTTP 原生、浏览器原生、自带重连机制。
• LangGraph Platform 的可恢复流是当前唯一完整实现。

示例

前端订阅一次长任务的 SSE 流，网络中断后携带 Last-Event-ID 重连，服务端先回放断点后的历史事件，再无缝切换到实时事件，客户端不丢进展、不重复。

相关概念

• Agent Runtime Protocol
• Artifact
• 中断即状态

参考资料

• 主笔记：Agent Runtime Protocol 稳定对象〔待补〕