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

# Automations

> Run an agent on a schedule

An automation gives an agent a prompt and a schedule. It runs on its own and drops the result into the agent's conversation.

<Frame>
  <video autoPlay muted loop playsInline src="https://cdn.helloleo.dev/tutorials/docs-automations.mp4" poster="https://cdn.helloleo.dev/tutorials/docs-automations-poster.png" />
</Frame>

<Note>
  Available on **Leo Business** and above. Automation runs consume [AI tokens](/getting-started/credits-system).
</Note>

## Create one

The quickest way is to just ask the agent, in its chat:

```
Set up an automated daily check of my inbox to catch new orders like these.
```

It proposes the schedule and what each run will do, and creates it once you confirm.

Otherwise, open the agent and go to **Automations → New automation**.

| Field | Example |
| - | - |
| **Name** | `Morning email recap` |
| **Prompt** | `Check my emails from the last 24h and summarize what needs my attention.` |
| **Frequency** | Every hour, every day, every week, or a custom cron expression |
| **Time** | `08:00`, in the timezone you pick |

Write the prompt as a standing instruction, not a one-off question. It runs unchanged every time.

## What you can see

Every automation shows its last outcome, so a silent failure is impossible to miss:

| Status | Meaning |
| - | - |
| **Succeeded** | Ran and produced a result |
| **Failed** | Errored. The message is on the run |
| **Timed out** | Took too long and was cut off |
| **Running** | In progress right now |

**Run now** executes it immediately through the same path as the schedule, which is the fastest way to check a new automation before leaving it to run.

An automation that keeps failing is disabled automatically, so a broken integration does not burn your AI tokens every hour.

## Where results land

The output is a normal assistant message in the agent's conversation. Open the agent's chat to read it, or have the prompt push the result somewhere itself, for example *"...and send the summary to me on Slack"*, if the agent has that integration.

## Good candidates

* A morning recap of what changed in the ERP overnight
* A weekly stock alert on items below their minimum
* A daily check that yesterday's orders were all invoiced
* An hourly sync check between two systems

## Managing them

The **Automations** tab on the Agents page lists every automation across all your agents, with its schedule and last run. Disable one without deleting it to keep its history.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.