Scheduling Your Agent

Now let's set up your research agent to run automatically on a schedule. VM0 provides a built-in scheduling system that lets you run agents at specific times without any external infrastructure.

Prerequisites

You should have completed the previous sections of this tutorial and have a working research agent with Firecrawl and Tavily skills configured.

Step 1: Compose Your Agent

First, make sure your agent is composed and ready:

vm0 compose vm0.yaml

This ensures your latest agent configuration is uploaded to VM0.

Step 2: Set Up a Schedule

Use the vm0 schedule setup command to create a schedule for your agent:

vm0 schedule setup my-researcher

This interactive command will guide you through the setup process:

Creating new schedule for agent my-researcher

? Schedule frequency › Daily
? Time (HH:MM) › 09:00
? Timezone › America/Los_Angeles
? Prompt to run › research the latest AI news and developments

After completing the prompts, you'll be asked if you want to enable the schedule:

Deploying schedule for agent my-researcher...
✓ Created schedule for agent my-researcher
  Timezone: America/Los_Angeles
  Cron: 0 9 * * *

? Enable this schedule? (Y/n) › Yes
✓ Enabled schedule for agent my-researcher

Your agent is now scheduled to run daily at 9:00 AM!

If you decline to enable the schedule, you can enable it later with vm0 schedule enable my-researcher.

What Just Happened?

You configured VM0's built-in scheduler to run your agent automatically. The scheduler:

Stores your schedule configuration on VM0's servers
Asks if you want to enable it immediately (defaults to yes)
Triggers agent runs at the specified times
Uses your configured secrets and variables
Saves output to the artifact directory

No external infrastructure like GitHub Actions or cron servers is needed - VM0 handles everything.

Managing Your Schedule

You can view and control your schedules with these commands:

# View all your schedules
vm0 schedule list

# Check status of a specific schedule
vm0 schedule status my-researcher

# Pause a schedule temporarily
vm0 schedule disable my-researcher

# Resume a paused schedule
vm0 schedule enable my-researcher

# Remove a schedule completely
vm0 schedule delete my-researcher

For more schedule options (weekly, monthly, one-time), see the CLI Reference.

Next Steps

Congratulations! You've completed the tutorial series. Your research agent can now:

Gather information from multiple sources using Tavily
Extract clean content using Firecrawl
Create comprehensive research reports
Run automatically on a schedule

From here, you can:

Visit Model Selection to explore cost-effective model alternatives
Check out more Skills to add new capabilities
Experiment with your AGENTS.md to customize the output format