Creating a Schedule

This guide walks you through creating a new schedule for automated agent runs.

Before you start

You need at least one agent before you can create a schedule. If you have not created an agent yet, see Creating an Agent.

Step-by-step guide

1. Navigate to Schedules

Click Scheduled Agents in the sidebar, then click New Schedule.

2. Configure the schedule

Fill in the schedule configuration:

• Name — A descriptive name for the schedule (e.g., "Daily Morning Summary" or "Weekly Sales Report").
• Agent — Select which agent to run. The dropdown shows all your available agents.
• Prompt Template — Write the message that will be sent to the agent on each run. You can use template variables for dynamic date/time values.

Screenshot: The schedule creation form with fields for name, agent selection, prompt template, frequency, and approval settings.

Using template variables

Template variables are replaced with actual values when the schedule runs:

• {today} — The current date (e.g., "January 15, 2026")
• {yesterday} — Yesterday's date
• {week_start} — The Monday of the current week
• {current_time} — The current time with timezone

Example prompt template:

Summarize all Slack activity from {yesterday}. Focus on key decisions,
action items, and anything that requires follow-up. Format as a
concise bullet-point report.

3. Set the timing

Choose how often and when the schedule should run:

Frequency:

• Every Minute — For testing only. Runs the agent every minute.
• Hourly — Specify which minute of the hour (e.g., :15 means 1:15, 2:15, 3:15, etc.).
• Daily — Specify the time of day.
• Weekly — Specify the day of the week and time of day.
• Monthly — Specify the day of the month and time of day.

Time of day — For daily, weekly, and monthly schedules, set the time when the schedule should run. Times are in Central European Time (Europe/Berlin) by default.

4. Configure approval

Toggle the Require Approval switch:

• Enabled (recommended) — The agent runs the prompt, but any actions with side effects (like sending emails or posting messages) are held for your review. You approve or reject them from the Schedules page.
• Disabled (Autopilot) — All actions execute automatically. You will see a confirmation dialog warning that actions will run without review.

5. Create the schedule

Click Create Schedule. The schedule starts immediately and will fire at the next configured time.

Editing a schedule

To modify an existing schedule:

1. Navigate to Scheduled Agents in the sidebar.
2. Click on the schedule you want to edit.
3. Click Edit to modify settings.
4. Save your changes.

Changes take effect starting from the next scheduled run.

Pausing and resuming

You can temporarily stop a schedule without deleting it:

• Pause — Click the menu on any schedule and select Pause. The schedule stops firing but retains its configuration.
• Resume — Click Resume on a paused schedule. VectorChat recalculates the next run time and the schedule resumes.

Running manually

To trigger a schedule immediately outside its normal timing, click the menu and select Run Now. This creates an execution that runs right away while keeping the normal schedule intact.