本指南概述了 LangGraph v1 中的变更以及如何从先前版本进行迁移。有关新功能的总体概述,请参阅发行说明。 要升级,

变更总结


弃用:createReactAgent → createAgent

LangGraph v1 弃用了 createReactAgent 预构建。请改用 LangChain 的 createAgent,它在 LangGraph 上运行并添加了灵活的中间件系统。 详情请参阅 LangChain v1 文档:

类型化中断

现在,您可以在图构建时定义中断类型,以严格类型化传递给中断和从中断接收的值。
了解更多关于中断的信息。

事件流编码

底层的 toLangGraphEventStream 辅助函数已被移除。流式响应由 SDK 处理;当使用底层客户端时,请通过传递给 graph.stream 的 encoding 选项选择线路格式。

破坏性变更

放弃 Node 18 支持

所有 LangGraph 包现在都要求 Node.js 22 或更高版本。Node.js 18 已于 2025 年 3 月生命周期终止。

新的构建输出

所有 langgraph 包的构建现在使用基于打包器的方式,而不是使用原始的 TypeScript 输出。如果您之前从 dist/ 目录导入文件(不推荐这样做),则需要更新您的导入以使用新的模块系统。