LangGraph v1 迁移指南

本指南概述了LangGraph v1的变更以及如何从旧版本迁移。要了解变更的高级概述，请参阅新增功能页面。升级：

pip install -U 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`	`StateGraph` 使用一个 `messages` 键，例如 `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="You are a helpful assistant.",
)

所有 LangChain 包现在都需要 Python 3.10 或更高版本。Python 3.9 于 2025 年 10 月达到生命周期的结束。