> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agenhq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Scheduled Agents

> Create recurring automation agents that launch sessions on a schedule.

Scheduled Agents let you save a prompt and run it automatically on a recurring cadence. They are useful for repeatable work like repository audits, dependency checks, code review sweeps, or any prompt you want Agen to execute without manually creating a new session each time.

You can find Scheduled Agents in the left navigation of your workspace.

## Create a Scheduled Agent

To create one:

1. Open **Scheduled Agents** in your workspace.
2. Click **New Scheduled Agent**.
3. Fill in the configuration:
   * **Name**: A clear label for the automation.
   * **Description**: Optional context for teammates.
   * **Model**: Choose the LLM the agent should use.
   * **Enabled**: Turn the automation on or off.
   * **Schedule interval**: Run every `N` hours, days, or weeks.
   * **Running days**: Choose which weekdays the automation is allowed to run on.
   * **Time of day**: Pick the execution time in 15-minute increments.
   * **Prompt**: The instructions Agen will use when creating each run.
   * **Budget limits**: Optionally set max budget per run, day, week, and month in USD.
4. Click **Create scheduled agent**.

After creation, Agen takes you to the agent detail page where you can review its configuration and run history.

## How scheduling works

Each scheduled agent stores both a recurrence interval and a set of allowed weekdays.

Examples:

* Run every **1 day** at **09:00** on weekdays only.
* Run every **1 week** at **14:30**.
* Run every **4 hours** while still restricting execution to selected days.

The detail page shows the agent's **next run** time and the **last run** time so you can confirm the current schedule.

## Enable or disable an agent

Scheduled agents can stay configured without actively running.

* **Enabled** agents continue to launch runs according to their schedule.
* **Disabled** agents remain saved, but do not execute until re-enabled.

You can choose the enabled state when creating the agent and update it later from the edit screen.

## Edit an existing agent

Open any scheduled agent and click **Edit** to change its:

* prompt
* model
* enabled status
* interval
* running days
* time of day
* budget limits
* name or description

This is useful when you want to refine the automation without creating a brand new agent.

## Run an agent manually

Each scheduled agent detail page includes a **Run now** action.

This starts a run immediately using the saved configuration, even if the next scheduled time is later. It is helpful for testing a prompt, validating a model choice, or triggering the workflow on demand.

## Review runs and sessions

Every scheduled agent has a **Runs** tab that shows its execution history.

For each run, you can review:

* run status
* when it started and finished
* how it was triggered
* total token usage
* total cost in USD
* a link to the session created by that run
* any error reason, if the run failed

This makes it easy to trace a scheduled automation back to the exact session that performed the work.

## Filter scheduled agents

On the main Scheduled Agents page, you can filter by:

* **Created by**
* **Enabled status**

These filters help teams quickly find automations created by a specific workspace member or narrow the list to active versus paused agents.

## Delete a scheduled agent

You can delete a scheduled agent from its detail page.

Deleting removes the saved scheduled configuration. Existing run history is retained, so past executions are still preserved for reference.

## Best practices

* Use descriptive names so teammates understand what the automation does.
* Keep prompts focused and repeatable.
* Start with budget limits if you expect an agent to run frequently.
* Use **Run now** before relying on a new recurring schedule.
* Review run history regularly to confirm the automation is still producing useful sessions.