LangGraph v1 迁移指南 - AI 开发中文文档

将代码库迁移至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`[create_agent]
`AgentState`	@`langchain.agents.AgentState`[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.",
)

from langgraph.prebuilt import create_react_agent

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

所有LangChain包现要求Python 3.10或更高版本。Python 3.9已于生命周期结束（2025年10月）终止支持。

官方原文：src/oss/python/migrate/langgraph-v1.mdx · 非官方翻译，译文由 AI 生成，以英文原文为准。