일정 트리거

일정 트리거 노드는 일정에 따라 워크플로를 자동으로 실행합니다. 예를 들어 20분마다, 매일 9:00, 평일 18:30에 실행할 수 있습니다. 일정은 내가 고른 시간대에서 해석되는 규칙의 목록이며, 어떤 규칙이든 일치할 때마다 워크플로가 실행됩니다. 트리거는 무료이며, 스위치가 켜져 있는 동안에만 실행됩니다.

사용 시기

• 매일의 이미지, 뉴스 요약, 명언 동영상처럼 생성한 콘텐츠를 매일 게시합니다.
• 웹 스크래핑이나 Telegram 채널 피드로 소스를 정기적으로 확인합니다.
• 편집기를 열지 않고 주간 또는 월간 보고서를 준비합니다.
• Webhook 트리거와 함께 써서 같은 워크플로를 일정에 따라, 그리고 필요할 때 실행합니다.

빠른 시작

일정 켜기

일정은 스위치가 켜져 있는 동안에만 실행됩니다. 노드를 배치하고 워크플로를 저장하면 일정이 등록되지만 시작되지는 않습니다. 켜기 전까지 노드에는 일시 중지됨이 표시됩니다.

• 설정 패널에서는 상단의 스위치를 사용하세요. 스위치에는 일정이 켜져 있습니다 또는 일정이 일시 중지되었습니다가 표시됩니다.
• 편집기 상단 바에서는 워크플로에 일정 트리거가 있을 때 일정 버튼이 나타납니다. 버튼에는 일정 켜짐, 일정 꺼짐, 또는 예를 들어 일정 1/2개 켜짐이 표시됩니다. 클릭하면 워크플로의 모든 일정을 켜고, 모두 켜져 있으면 끄며, 워크플로를 저장합니다.

스위치를 끄면 같은 방식으로 일정이 일시 중지됩니다. 가져온 워크플로나 템플릿은 항상 일정이 일시 중지된 상태로 시작합니다. API, SDK, MCP로 작성한 일정은 노드의 active 필드가 true일 때만 켜집니다.

일정을 켜지 않고 분기를 지금 시험해 보려면 설정 패널 하단의 여기서부터 실행을 클릭하세요. 아무것에도 연결되지 않은 트리거에는 실행을 시작할 분기가 없으므로 대신 워크플로 전체를 실행하세요.

설정

규칙

각 규칙에는 트리거 간격과 그에 맞는 필드가 있습니다.

• 고정된 기준점. “N일, N주, N개월마다”는 달력의 고정된 시점부터 셉니다. 워크플로를 다시 저장해도 실행되는 날이 밀리지 않습니다.
• Cron 형식. 필드는 분, 시, 일, 월, 요일 순입니다. 일과 요일의 조합을 포함해 모든 필드가 일치해야 합니다. 일부 cron 도구는 일과 요일 중 하나만 일치해도 실행합니다. 0과 7은 모두 일요일을 뜻합니다.

실행 시점

저장하기 전에 설정 패널의 실행 시점이 규칙의 의미를 보여 줍니다.

• 일정을 말로 풀어 쓴 설명과 하루 실행 횟수.
• 24시간 막대에 표시된 오늘의 실행.
• 다음 실행 세 번과 각각까지 남은 시간.

노드에는 같은 요약, 다음 실행, 일정이 활성인지 일시 중지됨인지가 표시됩니다. 미리 보기는 서버와 같은 계산을 사용하므로 실제로 일어날 일을 보여 줍니다.

예약 실행이 동작하는 방식

• 1분에 한 번. Nodaro는 1분마다 일정을 확인하고, 규칙이 그 분과 일치하면 실행을 시작합니다. 다시 시작한 뒤나 시계가 뒤로 돌아갈 때도 같은 분은 두 번 실행되지 않습니다. 시계가 앞으로 건너뛰는 분은 그날 건너뜁니다.
• 한 번에 하나의 실행. 워크플로의 이전 실행이 아직 진행 중이면 그 분은 건너뜁니다.
• 최대 실행 횟수. 그 횟수만큼 실행한 뒤에는 일정이 멈춥니다. 일정은 등록된 채로 남으므로, 계속하려면 제한을 늘리거나 지우세요.
• 출력. 출력인 페이로드가 실행 시각을 전달합니다.

예약 실행이 실행하는 범위

다른 노드에 연결된 트리거는 자기 분기만 실행합니다. 트리거 다음의 노드와, 그 노드들이 입력으로 필요로 하는 모든 노드입니다. 분기 밖의 노드는 그대로 둡니다. 아무것에도 연결되지 않은 트리거는 워크플로 전체를 실행합니다. 덕분에 워크플로 하나에 트리거를 여러 개 두고, 각 트리거가 자기 분기를 시작하게 할 수 있습니다.

노드는 직접 그린 연결이 있을 때, 트리거가 입력을 보내는 그룹 안에 있을 때, 또는 필드 매핑으로 이어져 있을 때 연결된 것으로 간주됩니다. 설정 패널은 어느 경우에 해당하는지 “연결됨: 실행하면 이 트리거 뒤에 이어진 분기만 실행됩니다.” 또는 “연결된 항목 없음: 실행하면 워크플로 전체가 실행됩니다.”로 알려 줍니다. 트리거는 자신이 시작한 실행만 제한합니다. 편집기에서의 수동 실행, API에서의 실행, 게시된 앱의 실행은 트리거의 분기로 제한되지 않습니다.

문제 해결

• 노드에 일시 중지됨이 표시됩니다. 스위치가 꺼져 있습니다. 설정 패널이나 상단 바의 일정 버튼으로 켜세요.
• 노드에 실행 불가가 표시됩니다. 실행할 수 없는 규칙이 있습니다. 예를 들어 식이 없는 cron 규칙이나 요일이 없는 주간 규칙입니다. 또는 서버가 알지 못하는 시간대가 설정되어 있습니다. 고친 다음 다시 저장하세요.
• 엉뚱한 시각에 실행됩니다. 시간대를 확인하세요. 비어 있으면 규칙은 UTC를 사용합니다.
• 실행이 건너뛰어졌습니다. 그 분에 워크플로의 이전 실행이 아직 진행 중이었습니다.
• 예전 일정이 실행되지 않습니다. 규칙 방식이 생기기 전에 저장된 일정은 일정이 규칙으로 바뀐 상태로 열리며, 일시 중지된 상태로 시작합니다. 켜세요. 이제 실행은 시계의 구간에 맞춰 이루어지므로 “5분마다”는 :00, :05, :10 등을 뜻합니다.

API에서 사용

GET /v1/workflows/<id>/triggers는 워크플로의 트리거 목록을 반환합니다. 일정의 구성은 노드와 같은 규칙을 사용하며, kind, every, hour, minute, weekdays(0은 일요일, 6은 토요일), dayOfMonth, cron에 더해 선택 항목인 timezone과 maxExecutions가 있습니다. 일정을 일시 중지하려면 노드의 스위치를 사용하세요. PATCH /v1/workflow-triggers/<id>로 보낸 일시 중지는 다음에 워크플로를 저장할 때까지만 유지됩니다. API로 직접 만든 일정은 어떤 노드에도 속하지 않으며, 워크플로에 일정 트리거가 두 개 있으면 그런 일정은 워크플로 전체를 실행합니다. Webhook을 참고하세요.