DOCS/journey/plans/251218_langgraph_1.0_upgrade_plan.md

LangGraph 1.0 업그레이드 계획

날짜: 2025-12-18 작성자: admin 관련 파일: rb8001/app/services/workflows/coldmail_workflow.py, rb8001/requirements.txt

---

현재 상황

• 현재 버전: langgraph==0.6.10
• 사용 위치: 콜드메일 워크플로우 (coldmail_workflow.py)
• 체크포인터: AsyncSqliteSaver 사용 (수동 설정)

LangGraph 1.0 주요 변경사항

1. 지속적인 상태 관리 (Durable State): 서버 재시작/중단 시 자동 재개
2. 내장된 지속성: 워크플로우 저장/재개 기능 강화
3. 휴먼 인 더 루프 (HITL) 패턴: 실행 일시 중지 후 인간 승인 API 제공
4. 그래프 기반 실행 모델 개선: 결정론적/에이전트 컴포넌트 혼합 제어 강화

Phase 1: 콜드메일 워크플로우 HITL 패턴 적용

파일: rb8001/app/services/workflows/coldmail_workflow.py

• process_node에서 HITL 패턴으로 일시 중지 → 사용자 승인 대기 → 재개
• "이 기업을 분석해 드릴까요?" 버튼을 워크플로우 내부에서 처리

Phase 2: 프론트엔드 IR 평가 워크플로우화

파일: rb8001/app/router/ir_deck.py

• 프론트엔드 요청을 LangGraph 워크플로우로 처리
• 신규 워크플로우 생성 (HITL 없음)
• 공통 함수: extract_ir_metrics(), evaluate_ir_deck(), save_evaluation()

Phase 3: 자동 상태 복구

파일: rb8001/app/services/workflows/coldmail_workflow.py

• LangGraph 1.0 자동 상태 관리 활용
• 체크포인터 수동 설정 제거

필요 작업

1. requirements.txt: langgraph==0.6.10 → langgraph>=1.0.0
2. coldmail_workflow.py API 호환성 테스트
3. HITL 패턴 적용 (콜드메일 "분석할까요?" 버튼)
4. 프론트엔드 IR 평가 워크플로우화
5. 체크포인트 데이터 마이그레이션 스크립트 작성

참고

• LangGraph 공식 문서: https://github.com/langchain-ai/langgraph
• 현재 구현: rb8001/app/services/workflows/coldmail_workflow.py
• 관련 문서: troubleshooting/251015_claude_coldmail_workflow_langgraph_test.md