LangGraph v1 是智能体运行时的稳定性专注版本。 它保持核心图 API 和执行模型不变，同时完善类型安全、文档和开发人员体验。 它旨在与 LangChain v1（其 createAgent 建立在 LangGraph 上）协同工作，因此您可以从高层次开始，并在需要时深入到细粒度控制。

稳定的核心 API

图原语（状态、节点、边）和执行/运行时模型保持不变，使升级变得简单。

默认情况下的可靠性

具有检查点、持久化、流式传输和人在回路的持久化执行继续是一等公民。

与 LangChain v1 无缝集成

LangChain 的 createAgent 在 LangGraph 上运行。使用 LangChain 快速开始；需要自定义编排时深入到 LangGraph。
要升级， 
npm install @langchain/langgraph @langchain/core
有关完整的更改列表，请参阅迁移指南。

​
弃用 createReactAgent

LangGraph createReactAgent 预构建已被弃用，改用 LangChain 的 createAgent。它提供了更简单的接口，并通过引入中间件提供了更大的自定义潜力。

​
类型化中断

StateGraph 现在在构造函数中接受中断类型映射，以更严格地限制可在图中使用的中断类型。 
import { StateGraph, MemorySaver, interrupt } from "@langchain/langgraph";
import * as z from "zod";

const stateSchema = z.object({
  foo: z.string(),
})

const graphConfig = {
  interrupts: {
    // Define a simple interrupt that accepts a reason and returns messages
    simple: interrupt<{ reason: string }, { messages: string[] }>, 
    // Define a complex interrupt with the same signature
    complex: interrupt<{ reason: string }, { messages: string[] }>, 
  }
}

const checkpointer = new MemorySaver();

const graph = new StateGraph(stateSchema, graphConfig)
  .addNode("node", async (state, runtime) => {
    // Trigger the simple interrupt with a reason
    const response = runtime.interrupt.simple({ reason: "test" });
    // Return the interrupt response as the new state
    return { foo: response };
  })
  // Compile the graph with the checkpointer
  .compile({ checkpointer });

// Invoke the graph with initial state
const result = await graph.invoke({ foo: "test" });

// Access the interrupt data
if (graph.isInterrupted(result)) {
  console.log(result.__interrupt__.messages);
}
有关中断的更多信息，请参阅中断文档。

​
前端 SDK 增强

LangGraph v1 在从前端与 LangGraph 应用程序交互时提供了一些增强功能。

​
事件流编码

低级 toLangGraphEventStream 助手已被删除。流式传输响应现在由 SDK 本地处理，您可以通过向 graph.stream 传入 encoding 格式来选择线格式。这使得在不更改 UI 逻辑的情况下在 SSE 和普通 JSON 响应之间切换变得简单。 有关更多信息，请参阅迁移指南。

​
useStream 中的自定义传输

React useStream hook 现在支持可插拔传输，因此您可以在不更改 UI 代码的情况下对网络层有更多控制。 
const stream = useStream({
  transport: new FetchStreamTransport({
    apiUrl: "http://localhost:2024",
  }),
});
了解如何集成和自定义 hook：将 LangGraph 集成到 React 应用程序中。

​
报告问题

请使用 'v1' 标签在 GitHub 上报告 1.0 发现的任何问题。

​
其他资源

LangGraph 1.0

阅读公告

概述

LangGraph 是什么以及何时使用它

图 API

使用状态、节点和边构建图

LangChain 智能体

建立在 LangGraph 上的高级智能体

迁移指南

如何迁移到 LangGraph v1

GitHub

报告问题或贡献

​
另请参阅

Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.