LangGraph 1.2.22 发布:修复子图流式问题,同步更新 checkpoint 与 prebuilt
LangGraph 发布 1.2.22,修复子图流式场景并带来五项性能优化,同时更新 checkpoint、checkpoint-postgres 与 prebuilt 三个配套包。面向使用 Python 构建 Agent 编排的开发者,新版本已在官方发布页给出变更清单。
LangGraph 1.2.22 修复子图流式并做五项优化
LangGraph 1.2.22 修复了子图流式问题,并带来五项性能优化。 同批还发布了 checkpoint-postgres 3.2.1、prebuilt 1.1.2 与 checkpoint 4.3.2。(来源:LangGraph 官方发布)
子图流式修复
官方把修复描述为把子图放在自己的线程上,流式传给正在流式读取子图的调用方。官方原文称:“fix(langgraph): stream a child graph on its own thread to a caller streaming subgraphs”。
五项性能优化
优化覆盖消息转换跳过、待处理写入按任务过滤、宽状态下的更新键集合匹配、runner 停止条件只看失败的 future,以及未跟踪与增量通道每轮只查找一次。
配套包版本
本次同时发布 checkpoint-postgres 3.2.1、prebuilt 1.1.2 与 checkpoint 4.3.2。官方未在发布说明中列出更多行为变化。
子图流式更可控,宽状态图开销下降
使用子图流式的 Agent 应用会直接受益,性能优化对宽状态与长流程更明显。 具体收益幅度官方未披露。
子图流式更可控
把子图放到独立线程后,调用方在流式读取子图输出时的边界更清晰。从官方描述看,这类修复主要影响流式调试与事件消费。
宽状态与长流程开销下降
更新键匹配改为集合查找、未跟踪与增量通道每轮只计算一次,都会减少宽状态图的重复开销。停止条件只检查失败 future 后,也少了一层无效判断。
配套包需要对齐
checkpoint 系列与 prebuilt 有独立版本号,升级时需要一起对齐,避免依赖解析到旧版本。相邻方向的更新可以对照 OpenAI Agents SDK 0.25.0。
升级 1.2.22 需对齐 checkpoint 三个配套包
使用 1.2.x 的项目建议升级到 1.2.22,重点验证子图流式与 checkpoint 组合。 官方把它作为常规补丁版本发布。
谁适合现在升级
依赖子图流式、宽状态或长流程的 Agent 应用收益最直接。只用基础图执行的项目可以按自身节奏跟进。
怎么升级
按 Python 包管理方式把 langgraph 升到 1.2.22,并按需对齐 langgraph-checkpoint 4.3.2、langgraph-checkpoint-postgres 3.2.1 与 langgraph-prebuilt 1.1.2。
回退与兼容
官方未披露回退步骤。从官方描述看,本次以修复与性能优化为主,发布说明中没有列出破坏性变更。MCP 相关的规范变化可参考 MCP 规范 2025-11-25。
常见问题
- LangGraph 1.2.22 修复了什么问题?
- 修复了把子图放到独立线程流式传给调用方的问题,涉及子图流式场景。
- LangGraph 这次更新有几个配套包?
- 同批发布 checkpoint-postgres 3.2.1、prebuilt 1.1.2 与 checkpoint 4.3.2。
- LangGraph 1.2.22 做了哪些性能优化?
- 优化覆盖消息转换、待处理写入过滤、更新键匹配、runner 停止条件与通道查找。
- LangGraph 1.2.22 现在可以升级了吗?
- 可以。官方发布页已给出 1.2.22 的变更清单,按 Python 包管理方式升级即可。
相关术语
- LangGraph
- LangGraph 是 LangChain 推出的图结构 Agent 编排框架,用于构建有状态的多步流程。
- 子图
- 子图是被父图调用的嵌套图,可把复杂流程拆成可复用的独立单元。
- checkpoint
- checkpoint 是 LangGraph 保存流程状态的机制,配套包负责不同存储后端。
这篇文章的来源是什么?
文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。
- LangGraph 1.2.22 · LangChain · 2026-11-17
「LangGraph 1.2.22」 —— LangChain
文章目录