LangGraph v1 新功能

LangGraph v1 是一个以稳定性为重点发布的智能体运行时。 它保持了核心图 API 和执行模型不变，同时改进了类型安全、文档和开发者易用性。

LangGraph v1 是一个以稳定性为重点发布的智能体运行时。 它保持了核心图 API 和执行模型不变，同时改进了类型安全、文档和开发者易用性。

它设计为与 LangChain v1（其 createAgent 基于 LangGraph）协同工作，让您可以从高级别开始，在需要时进行粒度控制。

Stable core APIs

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

Reliability, by default

具有检查点、持久化、流式输出和人工介入的持久执行继续是首选功能。

Seamless with LangChain v1

LangChain 的 createAgent 运行在 LangGraph 上。使用 LangChain 快速开始；使用 LangGraph 进行自定义编排。

要升级，

npm

npm install @langchain/langgraph @langchain/core

有关完整变更列表，请参阅 迁移指南。

createReactAgent 的弃用

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

• 有关新的 createAgent API 的信息，请参阅 LangChain v1 发布说明。
• 有关从 createReactAgent 迁移到 createAgent 的信息，请参阅 LangChain v1 迁移指南。

带有类型中断

@[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 提供了一些增强功能。

事件流编码

低级 toLangGraphEventStream 辅助工具已被移除。流式响应现在由 SDK 本地处理，您可以通过将 encoding 格式传递给 graph.stream 选择线格式。这使得在 SSE 和普通 JSON 响应之间切换变得简单，而无需更改 UI 逻辑。

有关更多信息，请参阅 迁移指南。

useStream 中的自定义传输

React 的 useStream 钩子现在支持可插拔的传输，因此您可以在不更改 UI 代码的情况下对网络层拥有更多控制权。

const stream = useStream({
  transport: new FetchStreamTransport({
    apiUrl: "http://localhost:2024",
  }),
});

学习如何集成和自定义钩子：将 LangGraph 集成到您的 React 应用程序中。

报告问题

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

其他资源

LangGraph 1.0

阅读公告

Overview

LangGraph 是什么以及何时使用它

Graph API

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

LangChain Agents

基于 LangGraph 的高级智能体

Migration guide

如何迁移到 LangGraph v1

GitHub

报告问题或贡献

参考文档

• 版本控制 – 理解版本号
• 发布策略 – 详细发布策略

---

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