이 가이드는 LangGraph v1의 변경 사항과 이전 버전에서 마이그레이션하는 방법을 설명합니다. 변경 사항에 대한 개괄적인 개요는 새로운 기능 페이지를 참조하세요. 업그레이드하려면: 
pip install -U langgraph langchain-core

​
변경 사항 요약

LangGraph v1은 이전 버전과 대부분 하위 호환됩니다. 주요 변경 사항은 create_react_agent가 deprecated되고 LangChain의 새로운 create_agent function으로 대체된 것입니다.

​
Deprecations

다음 표는 LangGraph v1에서 deprecated된 모든 항목을 나열합니다:
Deprecated 항목대안
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
ValidationNodecreate_agent를 사용하면 Tools가 자동으로 input을 검증합니다
MessageGraphcreate_agent가 제공하는 것처럼 messages key를 가진 StateGraph

​
create_react_agent → create_agent

LangGraph v1은 create_react_agent prebuilt를 deprecated합니다. LangGraph에서 실행되고 유연한 middleware 시스템을 추가하는 LangChain의 create_agent를 사용하세요. 자세한 내용은 LangChain v1 문서를 참조하세요: 
from langchain.agents import create_agent

agent = create_agent(  
    model,
    tools,
    system_prompt="You are a helpful assistant.",
)

​
Breaking changes

​
Python 3.9 지원 중단

모든 LangChain package는 이제 Python 3.10 이상이 필요합니다. Python 3.9는 2025년 10월에 수명 종료에 도달했습니다.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I