LangGraph v1 迁移指南

本指南概述了 LangGraph v1 中的变更，以及如何从旧版本迁移。若要了解变更的高层概览，请参阅新增内容页面。升级方式：

pip install -U langgraph langchain-core

uv add langgraph langchain-core

变更摘要

LangGraph v1 在很大程度上向后兼容旧版本。主要变更是弃用 create_react_agent，改为使用 LangChain 新的 create_agent 函数。

下表列出了 LangGraph v1 中弃用的所有项目：

弃用项	替代方案
`create_react_agent`	`langchain.agents.create_agent`
`AgentState`	`langchain.agents.AgentState`
`AgentStatePydantic`	`langchain.agents.AgentState`（不再有 pydantic 状态）
`AgentStateWithStructuredResponse`	`langchain.agents.AgentState`
`AgentStateWithStructuredResponsePydantic`	`langchain.agents.AgentState`（不再有 pydantic 状态）
`HumanInterruptConfig`	`langchain.agents.middleware.human_in_the_loop.InterruptOnConfig`
`ActionRequest`	`langchain.agents.middleware.human_in_the_loop.InterruptOnConfig`
`HumanInterrupt`	`langchain.agents.middleware.human_in_the_loop.HITLRequest`
`ValidationNode`	工具会通过 `create_agent` 自动验证输入
`MessageGraph`	带有 `messages` 键的 `StateGraph`，就像 `create_agent` 提供的那样

LangGraph v1 弃用了预构建的 create_react_agent。请使用 LangChain 的 create_agent，它运行在 LangGraph 之上，并添加了灵活的中间件系统。详情请参阅 LangChain v1 文档：

from langchain.agents import create_agent

agent = create_agent(
    model,
    tools,
    system_prompt="你是一个乐于助人的助手。",
)

from langgraph.prebuilt import create_react_agent

agent = create_react_agent(
    model,
    tools,
    prompt="你是一个乐于助人的助手。",
)

所有 LangChain 包现在都要求使用 Python 3.10 或更高版本。Python 3.9 已于 2025 年 10 月达到生命周期终止。

Connect these docs to Claude, VSCode, and more via MCP for real-time answers.