> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# LangGraph v1 新特性

**LangGraph v1 是一个专注于稳定性的代理运行时版本。** 它保持核心图 API 和执行模型不变，同时改进了类型安全性、文档和开发者体验。

它旨在与 [LangChain v1](/oss/javascript/releases/langchain-v1)（其 `createAgent` 基于 LangGraph 构建）协同工作，因此您可以从高级功能开始，并在需要时深入到细粒度控制。

<CardGroup cols={1}>
  <Card title="稳定的核心 API" icon="sitemap">
    图原语（状态、节点、边）和执行/运行时模型保持不变，使升级变得简单直接。
  </Card>

  <Card title="默认可靠性" icon="database">
    具有检查点、持久化、流式处理和Human in the Loop的持久执行仍然是首要特性。
  </Card>

  <Card title="与 LangChain v1 无缝集成" icon="link">
    LangChain 的 `createAgent` 运行在 LangGraph 上。使用 LangChain
    快速启动；使用 LangGraph 进行自定义编排。
  </Card>
</CardGroup>

要升级，

<CodeGroup>
  `bash npm npm install @langchain/langgraph @langchain/core ` `bash pnpm
      pnpm add @langchain/langgraph @langchain/core ` `bash yarn yarn add
      @langchain/langgraph @langchain/core ` `bash bun bun add
      @langchain/langgraph @langchain/core `
</CodeGroup>

有关完整的更改列表，请参阅[迁移指南](/oss/javascript/migrate/langgraph-v1)。

## `createReactAgent` 已弃用

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

* 有关新的 `createAgent` API 的信息，请参阅 [LangChain v1 发布说明](/oss/javascript/releases/langchain-v1#createagent)。
* 有关从 `createReactAgent` 迁移到 `createAgent` 的信息，请参阅 [LangChain v1 迁移指南](/oss/javascript/migrate/langchain-v1#createagent)。

## 类型化中断

[`StateGraph`](https://reference.langchain.com/javascript/langchain-langgraph/index/StateGraph) 现在在构造函数中接受一个中断类型映射，以更严格地约束可在图中使用的中断类型。

```typescript expandable theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { StateGraph, MemorySaver, interrupt } from "@langchain/langgraph";
import * as z from "zod";

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

const graphConfig = {
  interrupts: {
    // 定义一个简单的中断，接受一个原因并返回消息
    simple: interrupt<{ reason: string }, { messages: string[] }>, // [!code highlight]
    // 定义一个具有相同签名的复杂中断
    complex: interrupt<{ reason: string }, { messages: string[] }>, // [!code highlight]
  },
};

const checkpointer = new MemorySaver();

const graph = new StateGraph(stateSchema, graphConfig)
  .addNode("node", async (state, runtime) => {
    // 使用原因触发简单中断
    const response = runtime.interrupt.simple({ reason: "test" });
    // 将中断响应作为新状态返回
    return { foo: response };
  })
  // 使用检查点编译图
  .compile({ checkpointer });

// 使用初始状态调用图
const result = await graph.invoke({ foo: "test" });

// 访问中断数据
if (graph.isInterrupted(result)) {
  console.log(result.__interrupt__.messages);
}
```

有关中断的更多信息，请参阅[中断](/oss/javascript/langgraph/interrupts)文档。

## 前端 SDK 增强

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

### 事件流编码

底层的 `toLangGraphEventStream` 辅助函数已被移除。流式响应现在由 SDK 原生处理，您可以通过向 `graph.stream` 传递 `encoding` 格式来选择线路格式。这使得在 SSE 和普通 JSON 响应之间切换变得简单直接，无需更改 UI 逻辑。

有关更多信息，请参阅[迁移指南](/oss/javascript/migrate/langgraph-v1#event-stream-encoding)。

### `useStream` 中的自定义传输

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

```typescript theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
const stream = useStream({
  transport: new FetchStreamTransport({
    apiUrl: "http://localhost:2024",
  }),
});
```

了解如何集成和自定义钩子：[将 LangGraph 集成到您的 React 应用程序中](/oss/javascript/langgraph/ui)。

## 报告问题

请在 [GitHub](https://github.com/langchain-ai/langgraphjs/issues) 上使用 [`'v1'` 标签](https://github.com/langchain-ai/langgraphjs/issues?q=state%3Aopen%20label%3Av1) 报告在 1.0 中发现的任何问题。

## 附加资源

<CardGroup cols={3}>
  <Card title="LangGraph 1.0" icon="rocket" href="https://blog.langchain.com/langchain-langchain-1-0-alpha-releases/">
    阅读公告
  </Card>

  <Card title="概述" icon="book" href="/oss/javascript/langgraph/overview" arrow>
    LangGraph 是什么以及何时使用它
  </Card>

  <Card title="图 API" icon="sitemap" href="/oss/javascript/langgraph/graph-api" arrow>
    使用状态、节点和边构建图
  </Card>

  <Card title="LangChain 代理" icon="robot" href="/oss/javascript/langchain/agents" arrow>
    基于 LangGraph 构建的高级代理
  </Card>

  <Card title="迁移指南" icon="arrows-exchange" href="/oss/javascript/migrate/langgraph-v1" arrow>
    如何迁移到 LangGraph v1
  </Card>

  <Card title="GitHub" icon="brand-github" href="https://github.com/langchain-ai/langgraphjs">
    报告问题或贡献
  </Card>
</CardGroup>

## 另请参阅

* [版本控制](/oss/javascript/versioning) – 理解版本号
* [发布策略](/oss/javascript/release-policy) – 详细的发布策略

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode
    等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub
    上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/javascript/releases/langgraph-v1.mdx)
    或 [提交问题](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>