Skip to content

Scheduling

Agents can schedule recurring tasks using cron expressions. Scheduled tasks run automatically at the specified times without manual intervention.

  1. An agent uses the schedule tool with a cron expression and task description
  2. The platform creates a cron task and calculates the next run time
  3. The scheduler checks for due tasks every 60 seconds (configurable via FRONA_SCHEDULER_POLL_SECS)
  4. When a task is due, the platform assigns it to the specified agent
  5. The agent executes the task in a new or existing chat session
  6. After completion, the next run time is calculated

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)
ExpressionSchedule
0 9 * * 1-59 AM, Monday through Friday
*/30 * * * *Every 30 minutes
0 0 * * 0Midnight every Sunday
0 8,17 * * *8 AM and 5 PM daily

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"
)

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
VariableDefaultDescription
FRONA_SCHEDULER_POLL_SECS60How often the scheduler checks for due tasks
FRONA_SCHEDULER_SPACE_COMPACTION_SECS3600Interval for space compaction (background maintenance)
FRONA_SCHEDULER_INSIGHT_COMPACTION_SECS7200Interval for memory insight compaction