Skip to main content
本指南概述了 LangGraph v1 中的变更以及如何从先前版本迁移。有关新功能的概览，请参阅发布说明。 要升级，请运行： 
npm install @langchain/langgraph@latest @langchain/core@latest

​
变更摘要

领域变更内容
React 预构建createReactAgent 已弃用；使用 LangChain createAgent
中断通过 interrupts 配置支持类型化中断
toLangGraphEventStream 已移除使用 graph.stream 并指定所需的 encoding 格式
useStream支持自定义传输

​
弃用：createReactAgent → createAgent

LangGraph v1 弃用了 createReactAgent 预构建。使用 LangChain 的 createAgent，它在 LangGraph 上运行并添加了灵活的中间件系统。 有关详细信息，请参阅 LangChain v1 文档： 
import { createAgent } from "langchain";

const agent = createAgent({
  model,
  tools,
  systemPrompt: "You are a helpful assistant.",
});

​
类型化中断

您现在可以在图构建时定义中断类型，以严格类型化传递给中断和从中断接收的值。 
import { StateGraph, interrupt } from "@langchain/langgraph";
import * as z from "zod";

const State = z.object({ foo: z.string() });

const graphConfig = {
  interrupts: {
    approve: interrupt<{ reason: string }, { messages: string[] }>(),
  },
}

const graph = new StateGraph(State, graphConfig)
  .addNode("node", async (state, runtime) => {
    const value = runtime.interrupt.approve({ reason: "review" });
    return { foo: value };
  })
  .compile();
请参阅中断以了解更多信息。

​
事件流编码

底层的 toLangGraphEventStream 辅助函数已移除。流式响应由 SDK 处理；当使用底层客户端时，通过传递给 graph.stream 的 encoding 选项选择有线格式。 
const stream = await graph.stream(input, {
  encoding: "text/event-stream",
  streamMode: ["values", "messages"],
});

return new Response(stream, {
  headers: { "Content-Type": "text/event-stream" },
});

​
破坏性变更

​
不再支持 Node 18

所有 LangGraph 包现在需要 Node.js 20 或更高版本。Node.js 18 已于 2025 年 3 月结束生命周期。

​
新的构建输出

所有 langgraph 包的构建现在使用基于捆绑器的方法，而不是使用原始 TypeScript 输出。如果您曾从 dist/ 目录导入文件（不推荐这样做），则需要更新导入以使用新的模块系统。
在 GitHub 上编辑此页面 或提交问题。
通过 MCP 将这些文档连接到 Claude、VSCode 等 以获取实时答案。