The Scheduler lets you set up recurring tasks that agents execute automatically. Create daily reports, weekly analyses, periodic checks, and any automated workflow.
How Scheduling Works
Scheduled tasks use CRON expressions powered by BullMQ. When a schedule triggers:
- The system creates a new conversation thread
- The assigned agent receives the task prompt
- The agent executes using its configured tools and knowledge
- Results are saved and optionally sent to connected services
Creating a Schedule
You can create schedules directly in conversation:
“Schedule a weekly market analysis report every Monday at 9am”
Or through the Scheduler interface:
Open Scheduler
Navigate to the Scheduler section in the sidebar.
Create new schedule
Click New Schedule and configure:The task instruction the agent will execute each time.
CRON expression (e.g., 0 9 * * 1 for every Monday at 9am).
Which agent should execute this task.
Review and activate
Review the schedule preview and click Activate.
Common CRON Patterns
| Pattern | Schedule |
|---|
0 9 * * * | Every day at 9:00 AM |
0 9 * * 1 | Every Monday at 9:00 AM |
0 */6 * * * | Every 6 hours |
0 9 1 * * | First day of every month at 9:00 AM |
0 9 * * 1-5 | Weekdays at 9:00 AM |
Managing Schedules
- Pause a schedule without deleting it
- Edit the prompt, timing, or assigned agent
- View history of past executions and results
- Delete schedules you no longer need
Execution History
Each execution is logged with:
- Timestamp and duration
- Agent response and artifacts
- Status (success, error, timeout)
Start with simple schedules and iterate. You can modify the prompt and timing at any time.
