LangGraph v1 迁移指南

description=“将代码库迁移至 LangGraph v1。” icon=“arrow-right” actions= 将此代码库迁移至 LangGraph v1（需要 @langchain/langgraph 和 @langchain/core 在 v1 版本中，从 createReactAgent 迁移时需要 langchai…

将代码库迁移至 LangGraph v1。

CopiedCopy prompt

本指南概述了 LangGraph v1 的变更以及如何从旧版本迁移。有关新功能的概览，请参阅 发布说明。

要升级，

npm

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 文档：

• 发布说明
• 迁移指南

v1 (new)

import { createAgent } from "langchain";

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

---

类型化中断

你现在可以在图构建时定义中断类型，以严格类型化传递给中断和从中接收的值。

v1 (new)

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 选项选择线缆格式。

v1 (new)

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 22 或更高版本。Node.js 18 于 2025 年 3 月达到 生命周期结束。

新构建输出

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

---

官方原文：src/oss/javascript/migrate/langgraph-v1.mdx · 非官方翻译，译文由 AI 生成，以英文原文为准。