本指南概述了 LangGraph v1 中的变化以及如何从旧版本迁移。有关新特性的概要介绍，请参阅发布说明。 升级方式如下： 
npm install @langchain/langgraph@latest @langchain/core@latest

​
变更摘要

方面变更内容
React 预构建createReactAgent 已弃用；请使用 LangChain 的 createAgent
中断通过 interrupts 配置支持类型化中断
toLangGraphEventStream 已移除使用带有所需 encoding 格式的 graph.stream
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/ 目录导入文件（不推荐），则需要更新导入方式以使用新的模块系统。
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.
Edit this page on GitHub or file an issue.