Wait Node

설명

Wait 노드는 다음 단계로 넘어가기 전에 지정된 시간 동안 워크플로우의 실행을 일시정지합니다.

사용 시점

워크플로우에 의도적인 지연이 필요한 경우에 사용합니다. 일반적인 용도로는 외부 서비스 한도 초과 방지를 위한 Agent 또는 Code 노드 간의 API 호출 속도 제한, 외부 시스템이 업데이트를 완료할 때까지 대기하기 위한 데이터 수집과 처리 사이의 완충, 스팸 필터 트리거 방지를 위한 이메일 발송 간격 조절 등이 있습니다.

설정

필드	필수	설명
Name	Yes	워크플로우 내에서 노드를 고유하게 식별하는 이름입니다.
Description	No	노드의 역할을 간략하게 설명하는 텍스트입니다.
Duration	Yes	대기 시간을 지정하는 숫자 값입니다.
Unit	Yes	`Dropdown` 대기 시간의 단위입니다.

사용 팁

처음에는 넉넉한 대기 시간으로 시작하고, 워크플로우가 안정적으로 동작하면 점차 줄여나가는 것을 권장합니다.
API 속도 제한을 위해 Wait 노드를 사용할 때는 해당 서비스의 속도 제한을 확인하고 그에 맞게 시간을 설정하세요.
대기 중에는 실행이 완전히 중단되며 리소스가 소비되지 않습니다.

✅ Examples:

API 속도 제한:

Agent → Wait Node - 30 seconds → Agent (second call)

알림 발송 간격 조절:

Email → Wait Node - 10 min → Email

자주 발생하는 오류

Wait 노드는 매우 단순한 노드 유형으로 자체적으로 오류를 일으키는 경우는 드뭅니다. 다만, 과도하게 긴 대기 시간(특히 시간 단위)을 설정하면 워크플로가 멈춘 것처럼 보일 수 있습니다. 워크플로우가 응답하지 않는다면 Wait 노드에서 일시정지 중인지 먼저 확인하세요.
Duration을 0으로 설정하는 것은 기술적으로 유효하지만 실질적인 의미가 없으며 실행 로그 검토 시 혼란을 야기할 수 있습니다.