Scheduled tasks
Scheduled tasks run recurring work on your behalf. Open Run → Scheduled tasks when the feature is enabled (depends on sessions / agents capability in the deployment).
Create a task
- Name the task and write instructions (what the agent should do each firing).
- Choose project, provider/model, and mode (
Plan,Ask,Agent, …). - Pick a target:
- Session (default) — each firing creates a fresh interactive-style session
- AgentRun — queues a headless run against an existing agent definition
- Set recurrence: either interval minutes (from
startAtUtc) or a cron expression + time zone. - Optionally allow-list knowledge bases and MCP servers, attach a GitHub repo, and set budgets / overlap policy.
Control
| Action | Effect |
|---|---|
| Pause / Resume | Stop or continue future firings |
| Run now | Trigger an occurrence immediately |
| Occurrences | Inspect history, reports, cancel a live run |
Every occurrence ends with a markdown report (including failed/cancelled runs). Prefer overlapPolicy: Skip unless you intentionally allow concurrent work.
Tips
- Start in Plan mode for exploratory sweeps.
- Auto-pause after consecutive failures protects spend — fix the cause before resuming.
- Empty KB/MCP allow-lists usually mean “no extra restriction”; set explicit IDs to lock scope.