跳到主要内容
本指南概述了 LangGraph v1 中的更改以及如何从以前的版本迁移。有关新功能的概要,请参阅发布说明 要升级,
npm install @langchain/langgraph@latest @langchain/core@latest

更改摘要

区域发生了什么变化
React 预构建createReactAgent 已弃用;请使用 LangChain createAgent
中断通过 interrupts 配置支持类型化中断
toLangGraphEventStream 已移除使用 graph.stream 和所需的 encoding 格式
useStream支持自定义传输

弃用:createReactAgentcreateAgent

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.streamencoding 选项选择线格式。
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/ 目录导入文件(不推荐),您将需要更新您的导入以使用新的模块系统。
以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。
© . This site is unofficial and not affiliated with LangChain, Inc.