Scheduling Agents from Catalog
Overview
By exposing the ability to schedule an Agent from the Catalog, users can schedule deployed agents to run automatically at specified times and frequencies. Users can create one-time or recurring schedules with custom prompts, and admins can manage (pause, resume, delete) any user’s schedules.User Flow
Creating a Schedule
- User navigates to the desired Agent from catalog or opens an Agent to chat
- Clicks “Schedule Agent”
- The Schedule Agent modal opens with the following fields:
- Schedule Name (optional, 3+ chars if provided) - used to distinguish multiple schedules
- Start Date (required for one-time) - date picker, past dates disabled
- Start Time (required) - 15-minute intervals, 24-hour format
- Recurrence - None (one-time), Daily, Weekly, or Monthly
- User Input (required, 3+ chars, max 4000) - the prompt sent to the agent on each run
- User clicks “Save”
- Schedule is created immediately
Viewing Schedules
Users can view their schedules for a deployment by clicking the schedule dropdown on the deployment card. Each entry shows the schedule name and pause status. Users can also navigate to the Catalog and use the “Scheduled” quick filter to find all agents with a schedule.Editing a Schedule
- User clicks a schedule from the list
- Dialog opens in view-only mode
- User clicks “Edit” to enable editing
- User modifies fields (same validations apply)
- User clicks “Save” - the existing job is cancelled and a new one is published
Deleting a Schedule
- User clicks “Delete” in the schedule details dialog
- Confirmation dialog appears
- On confirm, the scheduled job is cancelled and the record is deleted
Schedule Types
| Type | Description |
|---|---|
OneTime | Runs once at a specific date/time |
Daily | Runs every day at the specified time |
Weekly | Runs on selected days of the week at the specified time |
Monthly | Runs monthly at the specified time |
Admin Capabilities
Admins and project admins have additional controls beyond what end users can do. While users can only manage their own schedules, admins have full visibility and control over all user-created schedules.Finding Agents with Schedules
- Navigate to the Agents page (
/agents/all) - A “Scheduled” column appears in the agents table showing a calendar badge for any agent that has user schedules
- Admins can also use the header filter on the Scheduled column to quickly filter down to only agents with active schedules
Managing User Schedules
- Click the calendar badge on an agent row — this opens the Agent Settings dialog directly to the Interfaces tab with the schedule management view
- The schedule management view displays a table of all user schedules for that agent, showing:
- Owner name — the user who created the schedule
- Agent action — the prompt/instructions the user configured
- Status — Active or Paused
- Use the search bar to filter schedules by username, email, or prompt content
Pausing a Schedule
- Click the actions menu (three dots) on a schedule row and select Pause, or select multiple schedules using the checkboxes and click the Pause bulk action button
- A confirmation dialog appears — click Pause to confirm
- The schedule is paused and the owner receives a notification
Resuming a Schedule
- Click the actions menu on a paused schedule row and select Resume
- The schedule resumes immediately — no confirmation required
Deleting a Schedule
- Click the actions menu on a schedule row and select Delete, or select multiple schedules and click the Delete bulk action button
- A confirmation dialog appears — click Delete to confirm
- The schedule is removed and the owner receives a notification
Notifications
Owners of a schedule will be alerted when administrators make changes.| Event | Recipient |
|---|---|
| Admin pauses a schedule | Schedule owner |
| Admin deletes a schedule | Schedule owner |
| User access revoked from deployment | Schedule owner (for each affected schedule) |
Enabling or Disabling Scheduling
Platform Admins and Security Admins can control whether users have the ability to schedule agents from the Catalog.- Navigate to Settings > Account (
/settings/account) - Find the Permissions section, which displays a grid of permission cards
- Click the End User Scheduling card (shown with a calendar icon)
- A modal opens with the following options:
- Allow all users — toggle this on to enable scheduling for everyone
- Specific users or groups — toggle off “Allow all users” and then select individual users or groups who should have access
- To completely disable scheduling, toggle off “Allow all users” and leave the user/group selection empty
- Click Save to apply the changes
Audit Logs
The following scheduling events produce audit log entries:| Event | Triggered By |
|---|---|
| User creates a schedule | End user |
| User updates a schedule | End user |
| User deletes a schedule | End user |
| Admin pauses a schedule | Admin / Project Admin |
| Admin resumes a schedule | Admin / Project Admin |
| Admin deletes a schedule | Admin / Project Admin |
