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

# LangGraph v1 新功能

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

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

它设计为与 [LangChain v1](https://langchain-docs-zh.mintlify.site/langchain/oss/python/releases/langchain-v1.md)（其 `createAgent` 基于 LangGraph）协同工作，让您可以从高级别开始，在需要时进行粒度控制。

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

> [card] Reliability, by default
>
> 具有检查点、持久化、流式输出和人工介入的持久执行继续是首选功能。

> [card] Seamless with LangChain v1
>
> LangChain 的 `createAgent` 运行在 LangGraph 上。使用 LangChain 快速开始；使用 LangGraph 进行自定义编排。

要升级，

```bash npm theme={null}
npm install @langchain/langgraph @langchain/core
```

```bash pnpm theme={null}
pnpm add @langchain/langgraph @langchain/core
```

```bash yarn theme={null}
yarn add @langchain/langgraph @langchain/core
```

```bash bun theme={null}
bun add @langchain/langgraph @langchain/core
```

有关完整变更列表，请参阅 [迁移指南](https://langchain-docs-zh.mintlify.site/langchain/oss/python/migrate/langgraph-v1.md)。

## `createReactAgent` 的弃用

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

* 有关新的 `createAgent` API 的信息，请参阅 [LangChain v1 发布说明](https://langchain-docs-zh.mintlify.site/langchain/oss/python/releases/langchain-v1.md#create_agent)。
* 有关从 `createReactAgent` 迁移到 `createAgent` 的信息，请参阅 [LangChain v1 迁移指南](https://langchain-docs-zh.mintlify.site/langchain/oss/python/migrate/langchain-v1.md#迁移到-create_agent)。

## 带有类型中断

@\[`StateGraph`] 现在在构造函数中接受中断类型的映射，以更紧密地限制图中可以使用的中断类型。

```typescript expandable theme={null}
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[] }>, // [!code highlight]
    // Define a complex interrupt with the same signature
    complex: interrupt<{ reason: string }, { messages: string[] }>, // [!code highlight]
  }
}

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);
}
```

有关中断的更多信息，请参阅 [中断](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/interrupts.md) 文档。

## 前端 SDK 增强

与前端交互时，LangGraph v1 提供了一些增强功能。

### 事件流编码

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

有关更多信息，请参阅 [迁移指南](https://langchain-docs-zh.mintlify.site/langchain/oss/javascript/migrate/langgraph-v1.md#事件流编码)。

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

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

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

学习如何集成和自定义钩子：[将 LangGraph 集成到您的 React 应用程序中](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/ui.md)。

## 报告问题

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

## 其他资源

> [card] [LangGraph 1.0](https://blog.langchain.com/langchain-langchain-1-0-alpha-releases/)
>
> 阅读公告

> [card] [Overview](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/overview.md)
>
> LangGraph 是什么以及何时使用它

> [card] [Graph API](https://langchain-docs-zh.mintlify.site/langchain/oss/langgraph/graph-api.md)
>
> 使用状态、节点和边构建图

> [card] [LangChain Agents](https://langchain-docs-zh.mintlify.site/langchain/oss/langchain/agents.md)
>
> 基于 LangGraph 的高级智能体

> [card] [Migration guide](https://langchain-docs-zh.mintlify.site/langchain/oss/python/migrate/langgraph-v1.md)
>
> 如何迁移到 LangGraph v1

> [card] [GitHub](https://github.com/langchain-ai/langgraphjs)
>
> 报告问题或贡献

## 参考文档

* [版本控制](https://langchain-docs-zh.mintlify.site/langchain/oss/versioning.md) – 理解版本号
* [发布策略](https://langchain-docs-zh.mintlify.site/langchain/oss/release-policy.md) – 详细发布策略

***

> 官方原文：[src/oss/javascript/releases/langgraph-v1.mdx](https://github.com/langchain-ai/docs/blob/main/src/oss/javascript/releases/langgraph-v1.mdx) · 非官方翻译，译文由 AI 生成，以英文原文为准。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.