Skip to main content
HITL(Human-in-the-Loop)은 위험한 액션을 사람 승인으로 감싸는 패턴입니다.

어떤 순간에 멈출까

  • 외부 발송: 이메일/메시지
  • 데이터 변경: DB update/delete
  • 금전/권한: 결제, 계정 변경

의사결정 타입

타입의미
approve그대로 실행
reject실행 중단
edit인자 수정 후 실행

공통 설계 규칙

  1. 승인 요청에 실행 컨텍스트를 충분히 포함
  2. 승인 결정 로그를 trace에 남김
  3. 재개(resume) 경로를 테스트로 보장

LangGraph HITL 구현

interrupt/resume 기반 구현은 이 문서에서 자세히 다룹니다.

학습 완료 기준

  • 이 문서의 핵심 개념을 3분 내로 설명할 수 있습니다.
  • 현재 프로젝트 기준으로 적용할 범위와 제외 범위를 구분할 수 있습니다.
  • 다음 학습 단계에서 필요한 입력(코드/정책/데이터)을 준비할 수 있습니다.

실무 적용 체크리스트

  • 승인 요청 페이로드(도구/인자/영향도)를 고정했습니다.
  • approve/reject/edit 기준을 팀 문서로 정의했습니다.
  • interrupt/resume 회귀 테스트를 준비했습니다.
  • 결정 로그를 트레이스에 저장합니다.

자주 나는 실수

  1. 승인 요청에 실행 맥락이 부족해 판단이 늦어집니다.
  2. approve/reject 기준이 없어서 운영 편차가 커집니다.
  3. resume 경로를 테스트하지 않아 재개 실패가 발생합니다.

다음 문서

다음: LangChain create_agent

학습 흐름을 이어서 진행합니다.