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`	带有 `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="You are a helpful assistant.",
)

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

以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。