LangGraph SDK 0.4.11 发布,修复流式重连与游标状态问题
摘要
LangGraph 发布 Python SDK 0.4.11 补丁版,重点修复流式连接重连、SSE 数据与游标状态保持,并补充重连恢复测试。
核心要点
- 版本发布:langgraph-sdk 0.4.11 于 10 月 30 日发布,提交由 GitHub 验证签名(GPG key B5690EEEBB952194)。
- 重试机制:runs.wait、join 与 cancel(wait=True) 的重连改为带退避的重试(#9481)。
- 流式修复:在分块之间保留 SSE data 和游标状态(#9477),每次遇到空 id 重置重连游标(#9440)。
- 告警与恢复:流在未携带 Last-Event-ID 时重连会发出警告(#9482),失败的流重连也会用退避重试(#9462)。
- 测试覆盖:新增测试确认重连循环能在最新事件之后继续恢复(#9483),同时修正 Auth.on 重载以匹配可选 resources(#9450)。
原文佐证
- fix(sdk-py): retry runs.wait, join and cancel(wait=True) reconnects with backoff ( #9481 )
- fix(sdk-py): preserve SSE data and cursor state across chunks ( #9477 )
- test(sdk-py): check that a reconnect loop resumes after the newest event ( #9483 )
AI 洞察
这类补丁表明,AI Agent 框架的竞争已进入工程可靠性阶段:流式传输、断线重连、事件游标等细节直接决定生产环境是否可用。对使用 LangGraph 构建长时任务的团队,升级可降低连接抖动导致的状态不一致风险;但 SDK 仍处于 0.x 版本,API 与行为稳定性仍需持续观察。