Schedule an agent to run on its own
Have an agent run on a recurring schedule and report back automatically.
Advanced · ~10 min · Prerequisites: a published agent
Building and editing agents is admin-only. Members can run and observe agents, but only admins can create or change them.
What you'll do
Configure a recurring schedule for a published agent so it runs automatically — no manual prompt needed — and routes its output somewhere useful.
Set a schedule
Open the agent at /admin/agents/<slug>/edit and go to the Scheduling section. Choose a cadence (hourly, daily, weekly, or a custom cron expression) and a time. Opisense stores the schedule in UTC — pick a time that lines up with when the results should arrive for your team. For the full list of cadence options and cron syntax, see Scheduling.
Schedules only fire while the agent is published and enabled. Drafts are never run on a schedule.
Define what it does each run
The agent runs the same instructions it uses in chat, but without a human composing the opening message. Add a scheduled prompt in the Scheduling section — this is the message the agent receives at each trigger time. Write it the way you'd write a standing brief:
- State what the agent should do: "Summarize the top five open support tickets by priority."
- Include any context it needs to act without follow-up: audience, format, and where to look.
- Keep it specific — a vague scheduled prompt produces vague output every single run.
The agent's tools, knowledge, and memory work exactly as they do in a normal conversation. If the agent has a web-search tool, it can pull live data; if it has a task-creation tool, it can create tasks as part the run.
Where results land
By default, scheduled run results are delivered to the inbox of the admin who created the schedule as a notification. You can change the destination in the Scheduling section:
- Inbox notification — delivered to one or more workspace members.
- Channel post — the agent posts its output to a connected chat channel (requires a connected app; see Connecting apps).
- Document — the agent appends or overwrites a specific doc in your content.
Pick the destination that fits how your team consumes the output. A daily digest works well as an inbox notification; a status board works better as a document.
Manage the schedule
To pause a schedule without deleting it, toggle the Active switch in the Scheduling section and save. The agent keeps its published version and all settings — only the automatic trigger is suspended.
To edit the cadence, time, prompt, or destination, open the Scheduling section, make changes, and save. The new settings take effect on the next scheduled run; runs already in flight are not affected.
To delete the schedule entirely, click Remove schedule in the Scheduling section. The agent remains published and fully functional in manual chat — it just stops running on its own.