Scheduling and Triggers

A Run doesn’t have to be started by hand. The CLI lets you set up three ways for an Agent to start work on its own: on a recurring schedule, when an external event fires, or when a new Case lands on a Queue.

Schedules

A schedule fires against an Agent’s live Setup on a recurring cadence — daily, on workdays, weekly, monthly, or a custom cron expression.

duvo agents schedules list <agent-id>                       # list schedules for an Agent

Create a schedule

duvo agents schedules create <agent-id> \
  --frequency daily \
  --timezone America/New_York \
  --time 09:00                                              # every day at 9am New York time

duvo agents schedules create <agent-id> \
  --frequency weekly \
  --timezone Europe/London \
  --day monday \
  --time 08:30                                              # every Monday at 8:30am London time

duvo agents schedules create <agent-id> \
  --frequency monthly \
  --timezone UTC \
  --day-of-month 1 \
  --time 06:00                                              # the 1st of every month at 6am UTC

duvo agents schedules create <agent-id> \
  --frequency custom \
  --timezone UTC \
  --cron "0 */4 * * *"                                      # custom cron: every 4 hours

Flag	Description
`--frequency`	Required. One of `daily`, `workday`, `weekly`, `monthly`, or `custom`
`--timezone`	Required. IANA timezone (e.g. `America/New_York`)
`--time <HH:MM>`	Time of day, 24-hour. Required for daily, workday, weekly, monthly
`--day <day>`	Day of week for weekly schedules
`--day-of-month <n>`	Day of month (1–31) for monthly schedules
`--cron <expr>`	Cron expression. Required for custom schedules
`--disabled`	Create the schedule paused (default: enabled and running)
`--no-recurring`	Retire the schedule after its first run (default: recurring)

Update or delete a schedule

duvo agents schedules update <agent-id> <schedule-id> --time 10:00     # change the time
duvo agents schedules update <agent-id> <schedule-id> --disable        # pause the schedule
duvo agents schedules update <agent-id> <schedule-id> --enable         # resume it
duvo agents schedules update <agent-id> <schedule-id> --one-shot       # run once, then retire
duvo agents schedules delete <agent-id> <schedule-id>                  # delete (prompts unless -y)
duvo agents schedules delete <agent-id> <schedule-id> --yes            # delete without prompting

update also accepts --timezone, --day, --day-of-month, --cron, and matching --clear-* flags to remove a field. Run duvo agents schedules update --help for the full set.

Case triggers

A Case Trigger connects an Agent to a Queue so it automatically picks up new Cases as they arrive. For background on the Queue system, see Queue.

duvo agents case-triggers list <agent-id>                                   # list triggers and their IDs
duvo agents case-triggers get <agent-id> <trigger-id>                       # show details for one trigger
duvo agents case-triggers create <agent-id> --queue <queue-id> --enabled    # create a trigger (omit --enabled to create it disabled)
duvo agents case-triggers update <agent-id> <trigger-id> --enable           # enable an existing trigger
duvo agents case-triggers update <agent-id> <trigger-id> --disable          # disable an existing trigger
duvo agents case-triggers update <agent-id> <trigger-id> \
  --queue <queue-id>                                                        # switch the queue the trigger listens to
duvo agents case-triggers update <agent-id> <trigger-id> --concurrency 1    # run Cases one at a time (sequential)
duvo agents case-triggers update <agent-id> <trigger-id> --clear-concurrency # use the platform default (parallel) again
duvo agents case-triggers delete <agent-id> <trigger-id>                    # delete the trigger
duvo agents case-triggers preview <agent-id> --queue <queue-id>             # check whether a queue already has an active trigger

Only the person who set up a trigger or a team Builder or admin can disable it or change its queue. Disabled triggers stay attached to the Agent but stop dispatching new Runs until re-enabled.

--concurrency only accepts 1 (run Cases one at a time). Use --clear-concurrency to fall back to the platform default, which runs Cases in parallel. Raising a Queue’s parallel limit above the platform default is configured by Duvo and can’t be set from the CLI or API.

Event triggers

An event trigger starts a Run automatically when an external event fires — an email arrives, a Linear issue is created, a file changes in Google Drive, and so on. The Connection must already be set up for the Agent before you can add a trigger for it.

duvo agents triggers list <agent-id>                                        # list your triggers for an Agent
duvo agents triggers types <agent-id>                                       # list available trigger types per Connection
duvo agents triggers set <agent-id> \
  --integration gmail --trigger-type email_received                         # create or update a trigger (enabled by default)
duvo agents triggers set <agent-id> \
  --integration gmail --trigger-type email_received \
  --filter-config '{"from":"boss@acme.com"}'                                # add an integration-specific filter
duvo agents triggers set <agent-id> \
  --integration gmail --trigger-type email_received --disabled              # pause a trigger without removing it

Each Connection has at most one event trigger per Agent, so set creates the trigger the first time and updates it after that. Use triggers types to discover the --integration and --trigger-type values a Connection supports.

Managing Agents

Create and configure the Agents these triggers and schedules fire

Starting Runs

Start and monitor Runs by hand

Cases and Queues

Inspect the Cases a Case Trigger picks up

Get started

Clarity Processes

Agents

Connections, Skills & Secrets

Queues

Automation & advanced

Scheduling and Triggers

Schedules

Create a schedule

Update or delete a schedule

Case triggers

Event triggers

Managing Agents

Starting Runs

Cases and Queues

​Schedules

​Create a schedule

​Update or delete a schedule

​Case triggers

​Event triggers

​Related

Managing Agents

Starting Runs

Cases and Queues

Schedules

Create a schedule

Update or delete a schedule

Case triggers

Event triggers

Related