Scheduled Agents

Scheduled agents let you run recurring tasks automatically. Define a cron schedule, an agent type, and a prompt — the system handles the rest using Google Cloud Scheduler to trigger agent runs on time.

This is useful for daily reports, weekly code reviews, periodic data analysis, knowledge graph health checks, and any other repeating task you want to automate.

Creating a Schedule

Use the CLI to create a schedule interactively or with flags:

ai agent schedule create

ai agent schedule create \
  --name "Daily health check" \
  --cron "0 8 * * MON-FRI" \
  --prompt "Run a health check on the knowledge graph and summarize any issues" \
  --type researcher \
  --timezone "Europe/Oslo"

Options

Cron Expression Examples

Managing Schedules

List all schedules

ai agent schedule list
ai agent schedule list --enabled
ai agent schedule list --disabled

View schedule details

ai agent schedule get <schedule-id>

Update a schedule

# Change the cron expression
ai agent schedule update <id> --cron "0 9 * * MON"

# Change the prompt
ai agent schedule update <id> --prompt "New task description"

# Change multiple fields
ai agent schedule update <id> --name "Weekly review" --model opus

Pause and resume

# Pause a schedule (stops future runs)
ai agent schedule pause <id>

# Resume a paused schedule
ai agent schedule resume <id>

Delete a schedule

ai agent schedule delete <id>

Deleting a schedule also removes the corresponding Cloud Scheduler job.

Authentication

Schedules work with both authentication modes:

• SSO/OAuth users: A dedicated API key is automatically generated when you create a schedule. This key is used by Cloud Scheduler to trigger runs on your behalf.
• API key users: The API key you authenticate with is stored (encrypted) and used by Cloud Scheduler.

In both cases, agent runs triggered by a schedule use the organization's agent configuration (Claude API key, E2B key, model, timeout, prompt template).

API Reference

All schedule endpoints are available via the REST API. Authenticate with either an API key or an OAuth token.

Create schedule (API example)

curl -X POST https://api.intelligence.apart.tech/api/agent/schedules \
  -H "Authorization: Bearer apart_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Daily health check",
    "cronExpression": "0 8 * * MON-FRI",
    "prompt": "Run a health check and summarize issues",
    "agentType": "researcher",
    "timezone": "Europe/Oslo"
  }'

How It Works

1. You create a schedule with a cron expression and agent configuration.
2. A Google Cloud Scheduler job is created that fires at the specified times.
3. When the scheduler fires, it calls the Apart Intelligence trigger endpoint.
4. The trigger endpoint creates a standard agent run using the schedule's configuration.
5. The agent runs in an isolated sandbox, same as a manually triggered run.

Each scheduled run is linked back to its schedule via scheduleId, so you can track which runs were triggered by which schedule.

CLI Reference