New Hot

LangGraph 1.2.22 发布:修复子图流式问题,同步更新 checkpoint 与 prebuilt

LangGraphAgent 编排版本更新性能优化

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

搜索文章

输入关键词,快速查找标题和正文内容。