Skip to main content
Version: v2.0

Schedule an automation

A schedule runs an agent at set times without anyone in the chat. First, prepare the agent for automation.

Commit before you schedule

A schedule runs one pinned variant and revision. Commit the agent first, so the schedule can pin the version you want it to run. In the Configuration header, click Commit, keep New version, and confirm.

Open the schedule dialog

You can open the New schedule dialog from two places.

From the agent. Sidebar > Agents > <agent name>, set Playground mode to Build, scroll the Configuration column to the Triggers heading, and click Add schedule on the Schedules section.

From project settings. Sidebar > Settings > Triggers, then + Schedule on the Scheduled runs section.

Fill in the dialog

1. Name

Enter a Schedule name. This name appears in the Scheduled runs table.

2. When should it run?

Pick a cadence, then the days and times.

CadenceUse it for
HourlyEvery hour
DailyOnce or several times a day
WeeklyChosen days of the week
MonthlyA day each month
CustomA cadence the other four do not cover

Set On these days with the Mon to Sun buttons, then At these times (UTC). To run more than once a day, click Add time and add another time.

note

Times are UTC. A daily 09:00 schedule fires at 09:00 UTC, not in your local time zone.

A green line under the fields restates the schedule it parsed and the next time it will fire, for example Mon at 09:00 (UTC) · next 2026-08-03 09:00 UTC. Read it before you move on.

If the schedule should only run between two dates, expand Active window and set the start and end.

3. Which version runs?

Choose Pinned, then select the variant and revision. Future changes to the agent do not affect this schedule until you update its pinned version.

4. What should the agent do?

Write the message the agent receives on each run. Name the task and where to send the result. For example: Summarize support tickets from the previous day and post the digest to #ops.

Test it, then switch it on

Click Run in playground to test the message. Then turn on Active and click Create.

To create a schedule without starting it, leave Active off.