LangGraph v1 마이그레이션 가이드
LangGraph v1 마이그레이션 가이드
이 가이드는 LangGraph v1의 변경 사항과 이전 버전에서 마이그레이션하는 방법을 정리해요. 변경 사항의 높은 수준의 개요는 what's new 페이지에서 볼 수 있어요. v1은 이전 버전과 대부분 호환되지만, 핵심 변화인 create_react_agent의 폐지와 create_agent로의 전환을 꼭 알아두어야 해요.
출처: 공식문서
변경 사항 요약 (Summary of changes)
LangGraph v1은 이전 버전과 대부분 역호환돼요. 주요 변경은 create_react_agent가 폐지되고 LangChain의 새 create_agent 함수로 대체된 것이에요.
폐지 항목 (Deprecations)
아래 표는 LangGraph v1에서 폐지된 모든 항목을 정리한 거예요.
| Deprecated item | Alternative |
|---|---|
create_react_agent |
langchain.agents.create_agent |
AgentState |
langchain.agents.AgentState |
AgentStatePydantic |
langchain.agents.AgentState (더 이상 pydantic state 없음) |
AgentStateWithStructuredResponse |
langchain.agents.AgentState |
AgentStateWithStructuredResponsePydantic |
langchain.agents.AgentState (더 이상 pydantic state 없음) |
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 |
Tools automatically validate input with create_agent |
MessageGraph |
StateGraph with a messages key, like create_agent provides |
create_react_agent → create_agent
LangGraph v1은 사전 빌드된 create_react_agent를 폐지해요. LangGraph 위에서 실행되고 유연한 미들웨어 시스템을 추가하는 LangChain의 create_agent를 사용하세요. 자세한 내용은 LangChain v1 문서를 참고해요.
Breaking changes
Python 3.9 지원 중단
모든 LangChain 패키지는 이제 Python 3.10 이상을 요구해요. Python 3.9는 2025년 10월에 수명 종료(end of life)에 도달했어요.