Schedule and automate agents
Once you’ve created agents to analyze your data, you’ll often want them to update automatically to reflect the latest information. This guide explains how to schedule and automate your agents to keep their outputs fresh.
Enabling automatic updates
To keep your agent’s outputs fresh with the latest data, you can enable automation.
By default, agents are scheduled to run daily at 8AM in the US/Eastern timezone. You can customize this schedule using the set-schedule endpoint.
Example: Enable automation for a stock analysis agent
Customizing the schedule
You can customize when your agent runs using natural language schedules.
The schedule is interpreted by our backend and converted to the appropriate cron expression. You can use natural language to describe when you want your agent to run.
Example schedule descriptions
Here are some examples of schedule descriptions you can use:
- “Daily at 9:30am”: Every day at 9:30 AM
- “Weekly on Monday at 7am”: Every Monday at 7:00 AM
- “Every weekday at 4pm”: Monday through Friday at 4:00 PM
- “Monthly on the 1st at 12pm”: First day of each month at 12:00 PM
Example: Schedule an earnings report agent to run weekly
Disabling automation
If you no longer want an agent to run automatically, you can disable its automation.
When you disable automation, the agent will retain its schedule configuration but won’t run automatically. You can re-enable it later with the same schedule.
Manually triggering updates
If you need updated results immediately, you can manually trigger a rerun.
After triggering a rerun, you’ll need to check the agent’s status again and retrieve the new outputs once it completes.
