| name | cron |
| description | Schedule reminders, recurring tasks, and one-time notifications using the cron tool. Use when the user asks to set a reminder, schedule a recurring task, create a timer, or wants periodic execution. Also use for listing or removing existing schedules. Do NOT use for immediate one-off actions that need no scheduling. |
| metadata | {"model":"local","tools":["cron"],"triggers":["알림","리마인더","예약","스케줄","반복","매일","매주","오전","오후","시에","아침","저녁","자정","정오","뒤에","후에","분 후","시간 후","remind","schedule","at","every","timer"],"aliases":["스케줄러","scheduler"]} |
Cron
Quick Reference
| Task | Tool Call |
|---|
| Add task (실행) | cron(action="add", message="Hikari를 재생해줘", at="<ISO>") |
| Add reminder (알림) | cron(action="add", message="회의 시간입니다", at="<ISO>", deliver=true) |
| Recurring task | cron(action="add", message="...", cron_expr="0 9 * * 1-5", tz="...") |
| List all | cron(action="list") |
| Remove | cron(action="remove", job_id="abc123") |
deliver Parameter (중요)
| deliver | 동작 | 사용 시점 |
|---|
true | 메시지만 채널에 전달 (알림/리마인더) | "알려줘", "리마인드", "알림" |
false (기본값) | 에이전트가 메시지를 작업으로 실행 | "재생해줘", "실행해줘", "검색해줘", "보내줘" |
행동이 필요한 요청은 반드시 deliver: false (또는 생략). deliver: true는 단순 텍스트 알림에만 사용.
Time Expression Mapping
| User says | Parameters |
|---|
| every 20 minutes | every_seconds: 1200 |
| every hour | every_seconds: 3600 |
| every day at 8am | cron_expr: "0 8 * * *" |
| weekdays at 5pm | cron_expr: "0 17 * * 1-5" |
| 9am Vancouver time | cron_expr: "0 9 * * *", tz: "America/Vancouver" |
| at a specific time | at: "<ISO datetime>" (compute from current time) |
Timezone
Use tz with cron_expr for IANA timezone scheduling. Without tz, server local timezone is used.
References
