以编程方式使用文档

本指南概述了 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_agentlangchain.agents.create_agent
AgentStatelangchain.agents.AgentState
AgentStatePydanticlangchain.agents.AgentState (不再使用 pydantic state)
AgentStateWithStructuredResponselangchain.agents.AgentState
AgentStateWithStructuredResponsePydanticlangchain.agents.AgentState (不再使用 pydantic state)
HumanInterruptConfiglangchain.agents.middleware.human_in_the_loop.InterruptOnConfig
ActionRequestlangchain.agents.middleware.human_in_the_loop.InterruptOnConfig
HumanInterruptlangchain.agents.middleware.human_in_the_loop.HITLRequest
ValidationNode工具自动使用 @[ 验证输入create_agent]
MessageGraphStateGraph 配合 messages 键使用,如 create_agent 所提供

create_react_agentcreate_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 月停止支持