Scheduled Agents

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.