Schedule triggers

A schedule trigger runs an agent automatically on a recurring schedule, with a fixed input you define when you create the trigger.

In the CLI and REST API, schedule triggers are referred to as time triggers. --type time is the value you pass when creating one.

Frequencies

Frequency	Options
`HOURLY`	—
`DAILY`	Time of day
`WEEKLY`	Days of week, time of day
`MONTHLY`	Days of month, time of day

Time of day is required for DAILY, WEEKLY, and MONTHLY triggers. HOURLY triggers do not take a time of day.

Create a schedule trigger

Open your workspace

Go to app.guild.ai and open the workspace where the agent is installed.

Go to Triggers

In the workspace’s left nav, click Triggers under Run, then click Add Trigger.

Configure the schedule

Select Scheduled, choose a frequency, and set the time of day (and days of week or month, if applicable).

Select an agent and input

Choose the agent the trigger will run, and define the fixed input it receives each time the trigger fires.

Name the trigger

Enter a Name, such as Nightly report. The name is required, up to 255 characters, and labels the trigger in the workspace’s Triggers list.

With the CLI

# Daily trigger at 9:00 AM
guild trigger create \
  --type time \
  --frequency DAILY \
  --time 09:00 \
  --agent daily-report \
  --input '{"project": "GUILD"}'

# Weekly trigger on Monday mornings
guild trigger create \
  --type time \
  --frequency WEEKLY \
  --days-of-week monday \
  --time 09:00 \
  --agent weekly-summary

# Monthly trigger on the 1st of the month
guild trigger create \
  --type time \
  --frequency MONTHLY \
  --days-of-month 1 \
  --time 09:00 \
  --agent monthly-report

With the public API

Account API keys can create time triggers through the public API with Create a trigger in a workspace. The key must hold both the workspaces:write and agents:read scopes; a key missing either scope receives a 403. Guild records the API key as the trigger’s creator.

Account API keys can create time triggers only. webhook and api triggers cannot be created with an account API key.

Agent input

Define the input the agent receives each time the trigger fires. Open the Edit Trigger dialog to edit it. On desktop, a schema-driven panel appears on the right side of the dialog, driven by the selected agent’s input schema. On mobile, a text field appears instead.

Update a schedule trigger

guild trigger update <trigger-id> --time 10:00

Removing a schedule trigger deactivates it rather than deleting it, so you can reactivate it later. See Manage triggers for activating, deactivating, listing, and inspecting triggers of any type.

Event triggers to run an agent when something happens in a connected service
API triggers to start a run from your own code
Post a daily digest of untriaged GitHub issues to Slack for a schedule trigger built end to end
guild trigger for every flag on create and update

Overview

The Smith

The Factory

Platform

Agent SDK

Schedule triggers

Frequencies

Create a schedule trigger

With the CLI

With the public API

Agent input

Update a schedule trigger

​Frequencies

​Create a schedule trigger

​With the CLI

​With the public API

​Agent input

​Update a schedule trigger

​Related pages

Frequencies

Create a schedule trigger

With the CLI

With the public API

Agent input

Update a schedule trigger

Related pages