本指南概述了 LangGraph v1 的变化以及如何从先前版本迁移。如需了解变化的高层次概述,请参阅 新增功能 page.
升级方法:
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 state) |
AgentStateWithStructuredResponse | langchain.agents.AgentState |
AgentStateWithStructuredResponsePydantic | langchain.agents.AgentState (不再使用 pydantic state) |
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 | StateGraph 配合 messages 键使用,如 create_agent 所提供 |
create_react_agent → create_agent
LangGraph v1 弃用了 create_react_agent 预构建版本。请使用 LangChain 的 create_agent,它运行在 LangGraph 上并添加了灵活的中间件系统。
详情请参阅 LangChain v1 文档:
from langchain.agents import create_agent
agent = create_agent( # [!code highlight]
model,
tools,
system_prompt="You are a helpful assistant.",
)
from langgraph.prebuilt import create_react_agent
agent = create_react_agent( # [!code highlight]
model,
tools,
prompt="You are a helpful assistant.", # [!code highlight]
)
破坏性变更
放弃对 Python 3.9 的支持
所有 LangChain 包现在要求 **Python 3.10 或更高版本**。Python 3.9 已于 2025 年 10 月停止支持 。