LangGraph v1 迁移指南

将此代码库迁移到 LangGraph v1（需要 langgraph>=1.0.0、langchain-core>=0.3.0）。

主要变更：

1. 升级包：运行 pip install -U langgraph langchain-core（或 uv add langgraph langchain-core）。
2. create_react_agent → create_agent：将所有 from langgraph.prebuilt import create_react_agent 替换为 from langchain.agents import create_agent。更新调用点：使用 create_agent(model, tools, system_prompt=...) 而不是 create_react_agent(model, tools, prompt=...)。
3. 移除已弃用的状态类型：将 AgentState、AgentStatePydantic、AgentStateWithStructuredResponse 和 AgentStateWithStructuredResponsePydantic（均来自 langgraph.prebuilt）替换为 langchain.agents.AgentState。
4. 人在回路：将 HumanInterruptConfig、ActionRequest 和 HumanInterrupt（来自 langgraph.types 或 langgraph.prebuilt）替换为 langchain.agents.middleware.human_in_the_loop.InterruptOnConfig 和 HITLRequest。
5. ValidationNode：移除它。create_agent 会自动校验工具输入。
6. MessageGraph：替换为使用 messages 键的 StateGraph，或直接使用 create_agent。
7. LangGraph v1 在其他方面向后兼容：基于自定义 StateGraph 的图、检查点器、interrupt()、Command、Send 和 MemorySaver 均可继续不变地工作。

在代码库中搜索所有从 langgraph.prebuilt 导入的内容（create_react_agent、AgentState、AgentStatePydantic、AgentStateWithStructuredResponse、HumanInterruptConfig、ActionRequest、HumanInterrupt、ValidationNode、MessageGraph），并应用必要的更改。标记任何无法自动迁移的内容。

本指南概述了 LangGraph v1 中的变更以及如何从先前版本迁移。变更的高层概览请参阅 新特性 页面。

升级方法：

pip

pip install -U langgraph langchain-core

uv

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 所提供的那样

create_react_agent → create_agent

LangGraph v1 弃用了 create_react_agent 预构建。请使用 LangChain 的 create_agent，它运行在 LangGraph 之上，并添加了灵活的 middleware 系统。

详情请参阅 LangChain v1 文档：

• 发行说明
• 迁移指南

v1（新）

from langchain.agents import create_agent

agent = create_agent(  
    model,
    tools,
    system_prompt="You are a helpful assistant.",
)

v0（旧）

from langgraph.prebuilt import create_react_agent

agent = create_react_agent(  
    model,
    tools,
    prompt="You are a helpful assistant.",  
)

破坏性变更

移除对 Python 3.9 的支持

所有 LangChain 包现在都要求 Python 3.10 或更高版本。Python 3.9 已于 2025 年 10 月停止支持。

---