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

​
변경 사항 요약

LangGraph v1은 이전 버전과 대부분 호환됩니다. 주요 변경 사항은 create_react_agent가 deprecated되고 LangChain의 새로운 create_agent 함수를 사용하도록 변경된 것입니다.

​
Deprecated 항목

다음 표는 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를 사용하면 도구가 자동으로 입력 유효성 검사 수행
MessageGraphcreate_agent가 제공하는 것처럼 messages 키를 가진 StateGraph

​
create_react_agent → create_agent

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

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

​
호환성을 깨는 변경 사항

​
Python 3.9 지원 중단

모든 LangChain 패키지는 이제 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