Voxli Voxli

Scheduled Runs

Automate your testing by scheduling scenarios to run on a recurring basis.

Scheduling Runs and Alerts

What scheduled runs are

A scheduled run executes a scenario against an agent automatically on a schedule you define. Instead of clicking Run manually, Voxli runs your tests at the times you set - every morning, every weekday, or whatever cadence makes sense for your workflow.

Use scheduled runs to catch regressions without manual testing. If something breaks, you find out on the next scheduled run - not the next time a customer runs into it.

Setting up a scheduled run

  1. Go to the Scheduled Runs page in the left sidebar.
  2. Click Schedule new.
  3. Fill in the form:
    • Name - a label for this schedule (e.g., “Monday morning”).
    • Scenario - which scenario to run.
    • Agent - which agent to test with.
    • Personality - optionally select a personality. Defaults to Neutral.
    • Schedule - describe when to run in natural language (e.g., “Every Monday morning at 8 AM” or “Every weekday at 9am”). Voxli interprets this and sets up the schedule.
    • Timezone - select the appropriate timezone.
  4. Click Create Schedule.
The Schedule Scenario dialog with name, scenario, agent, schedule, and timezone fields

Managing schedules

Each scheduled run shows as a card on the Scheduled Runs page. The card displays the schedule name, linked scenario and agent, the schedule description, and when the next run will execute.

A scheduled run card showing the schedule name, scenario, agent, and next run time

You can:

  • Enable or disable a schedule without deleting it. Disabled schedules keep their configuration but don’t execute.
  • Edit a schedule to change its settings.
  • Archive a schedule to remove it.

Notifications

To get email alerts when a scheduled run fails, configure notifications on the Notifications page. You can set a failure threshold to control which severity level triggers an alert - blocker failures only, medium and above, or any failure.

What’s next

Running Tests

Comparing Agents