Scheduling
Automate agent runs on a recurring basis with configurable schedules and approval workflows.
Scheduling lets you run agents automatically at set times. Useful for recurring tasks like daily reports, weekly summaries, or regular data checks.
Screenshot: The scheduled agents page showing active schedules with their frequency, next run time, and status.
How scheduling works
A schedule connects an agent to a recurring timer with a specific prompt. When the schedule fires:
- VectorChat renders the prompt template with current date/time variables.
- The agent runs the prompt as if a user had sent it in a conversation.
- The agent can use all its connected tools, skills, and knowledge bases.
- The execution result is recorded in the schedule's history.
If approval mode is enabled, the agent's proposed actions are paused for your review before executing.
Key concepts
Prompt templates
Each schedule includes a prompt template with time-based variables:
| Variable | Description | Example output |
|---|---|---|
{today} | Current date | January 15, 2026 |
{yesterday} | Previous day's date | January 14, 2026 |
{week_start} | Monday of the current week | January 13, 2026 |
{current_time} | Current time with timezone | 9:00 AM CET |
Frequencies
- Every Minute — For testing only.
- Hourly — Runs once per hour at a specified minute.
- Daily — Runs once per day at a specified time.
- Weekly — Runs once per week on a specified day and time.
- Monthly — Runs once per month on a specified day and time.
Approval workflows
When approval is enabled, side-effect actions (sending emails, posting messages) are held for review. When disabled ("Autopilot Mode"), all actions execute automatically.