> ## Documentation Index
> Fetch the complete documentation index at: https://langchain-zh.cn/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">
    具备检查点、持久化、流式处理和人工介入的持久化执行继续作为一等公民功能。
  </Card>

  <Card title="与 LangChain v1 无缝集成" icon="link">
    LangChain 的 `createAgent` 运行在 LangGraph 之上。使用 LangChain 快速入门；需要自定义编排时再切换到 LangGraph。
  </Card>
</CardGroup>

要升级，请执行以下命令：

<CodeGroup>
  ```bash npm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  npm install @langchain/langgraph @langchain/core
  ```

  ```bash pnpm theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  pnpm add @langchain/langgraph @langchain/core
  ```

  ```bash yarn theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  yarn add @langchain/langgraph @langchain/core
  ```

  ```bash bun theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
  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 在与前端交互时提供了一些增强功能。

### 事件流编码

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

更多信息请参阅 [迁移指南](/oss/javascript/migrate/langgraph-v1#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="edit">
    [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/i18n\zh-CN\oss\javascript\releases\langgraph-v1.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).
  </Callout>

  <Callout icon="terminal-2">
    [Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
  </Callout>
</div>