Skip to main content
HITL은 위험한 동작 직전에 사람 결정을 넣는 운영 패턴입니다. 핵심은 “어디서 멈출지”와 “어떻게 재개할지”를 미리 정의하는 것입니다.

적용 우선순위

아래 순서대로 적용합니다.
  1. 외부 발송(이메일, 메시지)
  2. 데이터 변경(DB update/delete)
  3. 비용 발생(결제, 주문)
  4. 권한 변경(계정/역할)

의사결정 타입

decision의미추천 사용
approve원본 인자로 실행위험이 낮거나 검토 완료
reject실행 중단정책 위반 또는 근거 부족
edit인자 수정 후 실행오탈자, 범위 수정 필요

승인 요청에 포함할 정보

  • 도구 이름
  • 입력 인자 원문
  • 예상 영향 범위
  • 취소/롤백 방법

운영 팁

  • 승인 지연 시간을 측정하고 SLA를 둡니다.
  • 승인/거부 사유를 trace에 남깁니다.
  • 승인 UI가 없다면 최소한 로그 기반 승인 채널을 준비합니다.
승인 분기와 재개 흐름이 복잡해지면 LangGraph interrupt/resume 기반으로 확장합니다.

LangGraph Human-in-the-Loop

인터럽트 기반 승인 워크플로우를 이어서 학습합니다.

실무 적용 체크리스트

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

자주 나는 실수

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

다음 문서

다음: LangChain 에이전트 구성 요소

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