스케줄 트리거

Cron 표현식으로 워크플로우를 주기적으로 자동 실행합니다.

---

설정

항목	설명	예시
Cron 표현식	실행 주기 정의 (5자리)	0 9 * * *

Cron 표현식 형식

┌───────── 분 (0-59)
│ ┌─────── 시 (0-23)
│ │ ┌───── 일 (1-31)
│ │ │ ┌─── 월 (1-12)
│ │ │ │ ┌─ 요일 (0-7, 0과 7은 일요일)
│ │ │ │ │
* * * * *

자주 사용하는 Cron 표현식

표현식	의미
*/5 * * * *	5분마다
0 * * * *	매시간 정각
0 9 * * *	매일 오전 9시
0 9 * * 1-5	평일(월~금) 오전 9시
0 9 * * 1	매주 월요일 오전 9시
0 9,18 * * *	매일 오전 9시, 오후 6시
0 0 1 * *	매월 1일 자정
0 0 * * 0	매주 일요일 자정

---

출력

스케줄 트리거는 입력 데이터 없이 실행되며, data_content에 실행 시간 정보가 포함됩니다:

{
  "text_content": "",
  "data_content": {
    "scheduled_time": "2026-03-05T09:00:00Z"
  }
}

---

활용 예시

일일 매출 보고서

매일 오전 9시에 전일 매출 데이터를 조회하고, AI가 보고서를 작성하여 팀에 이메일로 공유합니다.

주간 모니터링

매주 월요일 오전 9시에 외부 API를 호출하여 상태를 확인하고, 이상이 있으면 Telegram으로 알립니다.

---

주의 사항

타임존

Cron 표현식의 시간은 서버의 타임존(KST, UTC+9)을 기준으로 합니다.

활성화 필수

스케줄 트리거는 워크플로우가 활성화 상태일 때만 자동 실행됩니다.