Scheduling Overview
Scheduling lets your agents perform tasks automatically on a recurring basis. Using cron expressions, you can define when and how often an agent should execute a specific action — without manual intervention.
What Is Scheduling?
Section titled “What Is Scheduling?”A scheduled task is a combination of:
- A name — A descriptive label for the task.
- An agent — Which agent executes the task.
- A message — The prompt sent to the agent when the schedule triggers.
- A schedule — A cron expression defining when the task runs.
When the scheduled time arrives, the platform automatically sends the message to the agent, the agent processes it using its model and tools, and the task execution is logged with status, duration, and run count.
Use Cases
Section titled “Use Cases”| Schedule | Agent Message |
|---|---|
| Every weekday at 8:00 AM | ”Summarize the top 5 news stories in AI today” |
| Every hour | ”Check status.example.com and alert if anything is down” |
| Every day at midnight | ”Clean up temp files and generate usage report” |
| Weekdays at 9:00 AM | ”Post the morning briefing” |
Creating a Scheduled Task
Section titled “Creating a Scheduled Task”Via the Console
Section titled “Via the Console”- Open Automation from the sidebar.
- In the New Scheduled Task form, fill in the fields:
| Field | Description |
|---|---|
| Task Name | Descriptive name (e.g., “Daily Summary”), up to 60 characters |
| Agent | Select which agent executes the task from the dropdown (shows enabled agents only) |
| Agent Message | The prompt sent to the agent when the task triggers (up to 2000 characters) |
| Schedule | Use the visual schedule builder (see below) to set when the task runs |
- Click Add Task.
Visual Schedule Builder
Section titled “Visual Schedule Builder”The Automation page provides three dropdown selectors for building cron schedules:
| Dropdown | Options |
|---|---|
| Minute | :00, :15, :30, :45, or Every minute |
| Hour | A specific hour (0:00 through 23:00) or Every hour |
| Day of Week | Every day, Weekdays, Weekends, or Monday |
Below the dropdowns, a live schedule preview shows:
- A human-readable description (e.g., “9:00 AM, every day”)
- The corresponding cron expression in monospace (e.g.,
0 9 * * *)
The generated cron expression uses the format {minute} {hour} * * {dayOfWeek}, with day of month and month always set to *.
Via Chat
Section titled “Via Chat”Agents can create and manage scheduled tasks directly through conversation on any channel (web chat, Telegram, Discord, Slack). Simply tell the agent what you want to schedule:
- “Schedule a daily news summary at 8am”
- “Remind me every Monday at 9am to check the sales dashboard”
- “List my scheduled tasks”
- “Disable the weekly report job”
The agent uses the cron_add, cron_list, cron_update, cron_remove, and cron_run tools to manage schedules on your behalf.
Managing Scheduled Tasks
Section titled “Managing Scheduled Tasks”Viewing Tasks
Section titled “Viewing Tasks”The Scheduled Tasks section on the Automation page shows all configured tasks. Each task card displays:
- Enable/disable toggle — Switch the task on or off without deleting it
- Task name
- Agent badge — Which agent runs the task
- Status badge — Last execution status (e.g., “ok” or “error”)
- Run count badge — Total number of times the task has executed
- Cron expression — The schedule in cron format
- Next run — When the task will next execute (relative time)
- Last run — When the task last executed (relative time)
- Duration — How long the last execution took
- Error message — If the last run failed, the error is shown
Editing a Task
Section titled “Editing a Task”Click the pencil icon on a task card. The form above populates with the task’s current configuration. Make changes and click Save Changes, or click Cancel to discard.
Running Manually
Section titled “Running Manually”Click the play icon on a task card to execute it immediately, regardless of its schedule. The button shows a spinner during execution, then a green check when triggered. A toast notification confirms the task is running in the background.
The page auto-refreshes the task list after a manual run to show updated status and run count.
Deleting a Task
Section titled “Deleting a Task”Click the trash icon on a task card. The task is deleted and an undo toast appears, allowing you to restore it.
Expanding the Message
Section titled “Expanding the Message”Click the chevron icon on a task card to expand and view the full agent message that is sent when the task triggers.
Task Execution
Section titled “Task Execution”Background Execution
Section titled “Background Execution”Scheduled tasks run in the background, even when the console is closed. The platform sends the message to the assigned agent, which processes it using its configured model and tools.
Failure Handling
Section titled “Failure Handling”When a task fails (timeout, agent error, tool failure):
- The failure status and error message are shown on the task card.
- The task remains enabled and attempts to run at the next scheduled time.
- Run count and last status are updated.
Webhooks
Section titled “Webhooks”Webhooks are managed on a separate page. Open Webhooks from the sidebar to configure outbound HTTP requests to external services.
See Webhooks for the full guide.