Human-in-the-Loop (HITL) Node
설명
HITL 노드는 지정된 지점에서 워크플로우의 실행을 일시정지하고, 사람 검토자의 승인을 요청합니다. 게이트처럼 동작하여 실행이 멈추고 알림이 발송되며, 검토자가 응답할 때만 워크플로우의 실행이 재개됩니다.
사용 시점
사람의 판단 없이 진행해서는 안 되는 결정 지점에 사용합니다. AI가 생성한 콘텐츠를 게시하거나 발송하기 전 검토, 고가치·비가역적 작업 승인, 자동화 프로세스에 컴플라이언스 또는 품질 보증 체크포인트 추가 같은 케이스에서 활용합니다.
설정
Condition Configuration
| 필드 | 필수 | 설명 |
|---|---|---|
| Name | Yes | 워크플로우 내에서 노드를 고유하게 식별하는 이름입니다. |
| Description | Yes | 노드의 역할을 간략하게 설명하는 텍스트입니다. |
| Approver | Yes | Dropdown 요청을 승인하거나 반려할 수 있는 담당자를 지정합니다. |
| Enable Timeout | No | Toggle 활성화 시, 지정된 시간 내에 응답이 없으면 자동으로 요청이 반려됩니다. |
| Duration | 타임아웃 활성화 시 | 자동 반려까지 대기할 시간을 지정하는 숫자 값입니다. |
| Unit | 타임아웃 활성화 시 | Dropdown 타임아웃 시간의 단위입니다. |
Notification Configuration
| 필드 | 필수 | 설명 |
|---|---|---|
| In-app Notification | Always sent | 인앱 알림은 승인자에게 자동으로 발송되며 비활성화할 수 없습니다. |
| Notification Title | Yes | 인앱 알림에 표시되는 제목입니다. 동적 콘텐츠를 위한 {variable} 문법을 지원합니다(예: Approval Request - {workflowName}). |
| Message | No | 인앱 알림의 본문 텍스트입니다. {variable} 문법을 지원합니다. |
| No | Toggle 활성화 시, 인앱 알림 외에 이메일 알림도 발송됩니다. | |
| Recipient(s) | 이메일 활성화 시 | 알림 수신자의 이메일 주소를 쉼표로 구분하여 입력합니다. |
| Subject | 이메일 활성화 시 | 이메일 제목입니다. {variable} 문법을 지원합니다. |
| Message (Email) | 이메일 활성화 시 | 이메일 본문 내용입니다. Plain Text 및 HTML 콘텐츠 유형을 지원합니다. COS 링크가 기본으로 첨부됩니다. |
사용 팁
- HITL 노드의 알림 메시지에는 승인자가 전체 워크플로우를 열어보지 않아도 판단할 수 있을 만큼 충분한 컨텍스트를 포함하세요.
- 적절한 타임아웃을 설정하세요 — 너무 짧으면 조기 자동 반려의 위험이 있고, 너무 길면 워크플로우가 장시간 중단됩니다.
- 승인자가 COS 인터페이스를 항상 모니터링하지 않을 수 있는 중요한 승인 건에는 이메일 알림을 활성화하세요.
✅ Examples:
콘텐츠 검토 게이트:
Agent가 리포트 생성
→
HITL (매니저 검토)→ 승인: 클라이언트에게 이메일 발송
→ 반려: 수정 Agent 노드로 리포트 재처리
자주 발생하는 오류
- 가장 흔한 문제는 Enable Timeout이 꺼진 상태에서 승인자가 응답하지 않아 Workflow가 무기한 중단되는 경우입니다. 워크플로우의 경우 영구적인 중단을 방지하기 위해 타임아웃 기간을 적절하게 설정하는 것을 권장합니다.
- Notification Title이나 이메일 Subject에서 존재하지 않는 변수명을 사용하면 변수 문자열이 그대로 렌더링됩니다(예:
{nonExistentVar}). 변수 참조가 실제 Workflow 또는 시스템 변수와 일치하는지 확인하세요.
Last updated on