Scheduling
Agents can schedule recurring tasks using cron expressions. Scheduled tasks run automatically at the specified times without manual intervention.
How scheduling works
Section titled “How scheduling works”- An agent uses the
scheduletool with a cron expression and task description - The platform creates a cron task and calculates the next run time
- The scheduler checks for due tasks every 60 seconds (configurable via
FRONA_SCHEDULER_POLL_SECS) - When a task is due, the platform assigns it to the specified agent
- The agent executes the task in a new or existing chat session
- After completion, the next run time is calculated
Cron expressions
Section titled “Cron expressions”Standard 5-field cron syntax is supported:
minute (0-59)hour (0-23)day of month (1-31)month (1-12)day of week (0-6, 0 = Sunday)Examples
Section titled “Examples”| Expression | Schedule |
|---|---|
0 9 * * 1-5 | 9 AM, Monday through Friday |
*/30 * * * * | Every 30 minutes |
0 0 * * 0 | Midnight every Sunday |
0 8,17 * * * | 8 AM and 5 PM daily |
Creating scheduled tasks
Section titled “Creating scheduled tasks”Agents create scheduled tasks through the schedule tool:
schedule( cron_expression: "0 9 * * 1-5", title: "Morning briefing", description: "Summarize overnight news and pending items")Managing scheduled tasks
Section titled “Managing scheduled tasks”Scheduled tasks appear in the task list like any other task. You can:
- View upcoming runs and past results
- Cancel a scheduled task to stop future runs
- Modify the schedule or description
Scheduler configuration
Section titled “Scheduler configuration”| Variable | Default | Description |
|---|---|---|
FRONA_SCHEDULER_POLL_SECS | 60 | How often the scheduler checks for due tasks |
FRONA_SCHEDULER_SPACE_COMPACTION_SECS | 3600 | Interval for space compaction (background maintenance) |
FRONA_SCHEDULER_INSIGHT_COMPACTION_SECS | 7200 | Interval for memory insight compaction |