Skip to main content

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

  1. User navigates to the desired Agent from catalog or opens an Agent to chat
  2. Clicks “Schedule Agent”
  3. 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
  4. User clicks “Save”
  5. 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

  1. User clicks a schedule from the list
  2. Dialog opens in view-only mode
  3. User clicks “Edit” to enable editing
  4. User modifies fields (same validations apply)
  5. User clicks “Save” - the existing job is cancelled and a new one is published

Deleting a Schedule

  1. User clicks “Delete” in the schedule details dialog
  2. Confirmation dialog appears
  3. On confirm, the scheduled job is cancelled and the record is deleted

Schedule Types

TypeDescription
OneTimeRuns once at a specific date/time
DailyRuns every day at the specified time
WeeklyRuns on selected days of the week at the specified time
MonthlyRuns 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

  1. Navigate to the Agents page (/agents/all)
  2. A “Scheduled” column appears in the agents table showing a calendar badge for any agent that has user schedules
  3. Admins can also use the header filter on the Scheduled column to quickly filter down to only agents with active schedules

Managing User Schedules

  1. Click the calendar badge on an agent row — this opens the Agent Settings dialog directly to the Interfaces tab with the schedule management view
  2. 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
  3. Use the search bar to filter schedules by username, email, or prompt content

Pausing a Schedule

  1. 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
  2. A confirmation dialog appears — click Pause to confirm
  3. The schedule is paused and the owner receives a notification

Resuming a Schedule

  1. Click the actions menu on a paused schedule row and select Resume
  2. The schedule resumes immediately — no confirmation required

Deleting a Schedule

  1. Click the actions menu on a schedule row and select Delete, or select multiple schedules and click the Delete bulk action button
  2. A confirmation dialog appears — click Delete to confirm
  3. The schedule is removed and the owner receives a notification

Notifications

Owners of a schedule will be alerted when administrators make changes.
EventRecipient
Admin pauses a scheduleSchedule owner
Admin deletes a scheduleSchedule owner
User access revoked from deploymentSchedule 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.
  1. Navigate to Settings > Account (/settings/account)
  2. Find the Permissions section, which displays a grid of permission cards
  3. Click the End User Scheduling card (shown with a calendar icon)
  4. 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
  5. Click Save to apply the changes
Read-Only Admins can view the current permission settings but cannot make changes.

Audit Logs

The following scheduling events produce audit log entries:
EventTriggered By
User creates a scheduleEnd user
User updates a scheduleEnd user
User deletes a scheduleEnd user
Admin pauses a scheduleAdmin / Project Admin
Admin resumes a scheduleAdmin / Project Admin
Admin deletes a scheduleAdmin / Project Admin