From eb1b0b30c42e328c08afad3436a8e15f939da693 Mon Sep 17 00:00:00 2001 From: "claude[bot]" <41898282+claude[bot]@users.noreply.github.com> Date: Tue, 22 Sep 2026 09:40:10 +0000 Subject: [PATCH 1/3] docs(85bacd35-7888-4e9f-ba59-c586df9d5538): add trigger inventory page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documents the trigger inventory feature — a centralized view of all workspace triggers with bulk alert configuration support. Co-Authored-By: Claude Sonnet 4.6 --- docs.json | 1 + .../build-your-agent/trigger-inventory.mdx | 56 +++++++++++++++++++ 2 files changed, 57 insertions(+) create mode 100644 site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx diff --git a/docs.json b/docs.json index 5efed2c5..346a2846 100644 --- a/docs.json +++ b/docs.json @@ -109,6 +109,7 @@ "build/agents/build-your-agent/tools", "build/agents/build-your-agent/triggers", "build/agents/build-your-agent/alerts", + "build/agents/build-your-agent/trigger-inventory", "build/agents/build-your-agent/memory", "build/agents/build-your-agent/variables", "build/agents/build-your-agent/version-history", diff --git a/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx b/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx new file mode 100644 index 00000000..43dbfb61 --- /dev/null +++ b/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx @@ -0,0 +1,56 @@ +--- +title: 'Trigger inventory' +sidebarTitle: 'Trigger inventory' +description: 'View and manage triggers across all agents in your workspace from a single page.' +--- + + +Trigger inventory is in early access and requires both the `trigger-inventory-list-be` and `trigger-inventory-page-fe` feature flags to be enabled for your workspace. + + +The trigger inventory page gives you a centralized view of every trigger across all agents in your workspace. Instead of navigating to each agent individually to check or update trigger alerts, you can see the full picture in one place and take action on multiple triggers at once. + +## Accessing the trigger inventory + +Navigate to **Triggers** in the main sidebar. The trigger inventory page lists all triggers across your workspace in a table, regardless of which agent owns them. + +## Trigger table + +The table shows all workspace triggers with their associated agent, trigger type, status, and alert configuration. Use the column headers to sort by any field, or use the search bar to filter by trigger name or agent name. + +## Bulk alert configuration + +You can configure or mute alerts on multiple triggers at the same time without opening each agent individually. + +### Selecting triggers + +Each row in the trigger table has a checkbox in the leftmost column. Check one or more rows to select those triggers. Use the checkbox in the column header to select all triggers on the current page. + +Selection persists as you paginate through the table and apply search filters, so you can build a selection across multiple pages before taking action. + +### Setting up alerts in bulk + +1. Select one or more triggers using the checkboxes +2. In the action bar that appears at the bottom of the page, click **Set up alarm** +3. In the modal that opens, choose the notification channels you want to use (email, Slack, or Microsoft Teams) +4. Confirm to apply the alert configuration to all selected triggers + +The action bar shows a count of how many triggers are selected. While alerts are being configured, a live progress indicator shows how many triggers have been processed (for example, "Enabling alarms… 3/10"). + +For details on notification channel setup, see [Alerts](/build/agents/build-your-agent/alerts). + +### Muting alerts in bulk + +1. Select one or more triggers that already have alerts configured +2. In the action bar at the bottom, click **Mute alarms** +3. Confirm the action + +The mute action only affects triggers that already have alerts active — triggers without alerts are skipped. The progress indicator tracks the operation across all selected triggers. + +### Reviewing and removing selections + +After selecting triggers, you can review the full selection in the action bar popover. To remove a specific trigger from the selection without deselecting everything, open the popover and click the remove control next to that trigger. + +### Error handling + +If an operation fails on some triggers, the progress indicator distinguishes between permanent failures and retryable ones. Permanent failures are reported individually so you can investigate the specific trigger. Retryable failures are handled automatically. From 4f4fb4b86d51edf62bc493c14c9392fa7f89d4eb Mon Sep 17 00:00:00 2001 From: Jordan Date: Thu, 15 Oct 2026 10:16:21 +1100 Subject: [PATCH 2/3] docs: correct trigger status page against product code - Drop the early access banner; the gating flags are at 100% - Match UI names: Triggers nav entry, Trigger status heading, real columns - Cover workforces, grouping tabs and the per-row alarm bell - Mute runs without confirmation and only hits triggers with an alarm on - Describe the real failure handling: summary toast, no auto-retry Co-Authored-By: Claude Opus 5.5 --- .../build-your-agent/trigger-inventory.mdx | 88 ++++++++++++------- 1 file changed, 58 insertions(+), 30 deletions(-) diff --git a/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx b/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx index 43dbfb61..1118c68a 100644 --- a/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx +++ b/site/content/docs/build/agents/build-your-agent/trigger-inventory.mdx @@ -1,56 +1,84 @@ --- -title: 'Trigger inventory' -sidebarTitle: 'Trigger inventory' -description: 'View and manage triggers across all agents in your workspace from a single page.' +title: 'Trigger status' +sidebarTitle: 'Trigger status' +description: 'View and manage triggers across all agents and workforces in your project from a single page.' --- - -Trigger inventory is in early access and requires both the `trigger-inventory-list-be` and `trigger-inventory-page-fe` feature flags to be enabled for your workspace. - +The trigger status page gives you a centralized view of every trigger in your project, whether it belongs to an agent or a workforce. Instead of opening each agent or workforce to check its triggers, you can see the full picture in one place and set up alarms on many triggers at once. -The trigger inventory page gives you a centralized view of every trigger across all agents in your workspace. Instead of navigating to each agent individually to check or update trigger alerts, you can see the full picture in one place and take action on multiple triggers at once. +## Accessing the page -## Accessing the trigger inventory +Click **Triggers** in the main sidebar. The page opens with the heading **Trigger status** and lists every trigger in your project. -Navigate to **Triggers** in the main sidebar. The trigger inventory page lists all triggers across your workspace in a table, regardless of which agent owns them. + +If you don't see **Triggers** in the sidebar, ask a project admin to check your permissions. In the classic sidebar, the entry only shows for users who can create agents and workforces. + ## Trigger table -The table shows all workspace triggers with their associated agent, trigger type, status, and alert configuration. Use the column headers to sort by any field, or use the search bar to filter by trigger name or agent name. +The table has these columns: -## Bulk alert configuration +- **Alarm**: a bell showing whether a failure alarm is set up for the trigger +- **Trigger**: the trigger's name, with an icon for its type +- **Belonging to**: the agent or workforce that owns the trigger. Click it to open that agent or workforce. +- **Status**: the trigger's current status +- **Last successful run**: when the trigger last ran successfully +- **Last failed**: when the trigger last failed -You can configure or mute alerts on multiple triggers at the same time without opening each agent individually. +The table opens sorted by status, with failed triggers first. Click a column header to sort by that column (every column except **Alarm**). Use the search bar to filter by trigger, workforce or agent name. -### Selecting triggers +### Grouping triggers -Each row in the trigger table has a checkbox in the leftmost column. Check one or more rows to select those triggers. Use the checkbox in the column header to select all triggers on the current page. +Use the tabs above the table to change how triggers are grouped: -Selection persists as you paginate through the table and apply search filters, so you can build a selection across multiple pages before taking action. +- **All**: every trigger in one list +- **By workforce**: triggers grouped under the workforce that owns them +- **By agent**: triggers grouped under the agent that owns them -### Setting up alerts in bulk +## Setting up an alarm on one trigger -1. Select one or more triggers using the checkboxes -2. In the action bar that appears at the bottom of the page, click **Set up alarm** -3. In the modal that opens, choose the notification channels you want to use (email, Slack, or Microsoft Teams) -4. Confirm to apply the alert configuration to all selected triggers +Click the bell in a trigger's **Alarm** column: -The action bar shows a count of how many triggers are selected. While alerts are being configured, a live progress indicator shows how many triggers have been processed (for example, "Enabling alarms… 3/10"). +- If the alarm is off, a modal opens where you choose the notification channels (email, Slack or Microsoft Teams). Save to turn the alarm on. +- If the alarm is on, clicking the bell turns it off straight away. For details on notification channel setup, see [Alerts](/build/agents/build-your-agent/alerts). -### Muting alerts in bulk +## Bulk alarm actions + +You can set up or mute alarms on many triggers at once. + +### Selecting triggers + +Each row has a checkbox in the leftmost column. Check one or more rows to select those triggers. Use the checkbox in the column header to select all triggers on the current page. + +Your selection stays as you change pages, search or switch tabs, so you can build a selection across several pages before taking action. + +When you select triggers, an action bar appears at the bottom of the page showing how many are selected (for example, "3 selected"). Click the count to see the selected triggers, and click the **x** next to one to remove it from the selection. Click the **x** at the right of the action bar to clear the selection. + +### Setting up alarms in bulk + +1. Select one or more triggers +2. In the action bar, click **Set up alarm** +3. In the modal that opens, choose the notification channels you want to use (email, Slack or Microsoft Teams) +4. Save to apply the alarm to all selected triggers + +Triggers that already have an alarm get the channels you choose in place of their current ones. + +While alarms are being set up, the action bar shows live progress (for example, "Enabling alarms… 3/10"). + +### Muting alarms in bulk -1. Select one or more triggers that already have alerts configured -2. In the action bar at the bottom, click **Mute alarms** -3. Confirm the action +1. Select one or more triggers +2. In the action bar, click **Mute alarms** -The mute action only affects triggers that already have alerts active — triggers without alerts are skipped. The progress indicator tracks the operation across all selected triggers. +Muting starts as soon as you click; there's no confirmation step. Only triggers whose alarm is currently on are muted, and the rest of the selection is skipped. If none of the selected triggers has an alarm on, the button is disabled. -### Reviewing and removing selections +### When some triggers fail -After selecting triggers, you can review the full selection in the action bar popover. To remove a specific trigger from the selection without deselecting everything, open the popover and click the remove control next to that trigger. +When a bulk action finishes, a message summarizes the result (for example, "Enabled for 7 triggers, 3 failed"). -### Error handling +- **Triggers that can't be changed**, because you don't have permission or alarms aren't available for that trigger, are named in the message and removed from your selection. +- **Triggers that failed for other reasons** stay selected, so you can try again. When you click **Set up alarm** again, the modal is prefilled with the channels you just used. -If an operation fails on some triggers, the progress indicator distinguishes between permanent failures and retryable ones. Permanent failures are reported individually so you can investigate the specific trigger. Retryable failures are handled automatically. +Triggers that succeeded are removed from your selection. From 55fd5b9455ee9fa52385a6754a40ddccfdcb080f Mon Sep 17 00:00:00 2001 From: Jordan Date: Thu, 15 Oct 2026 10:42:37 +1100 Subject: [PATCH 3/3] docs: add trigger status page to sidebar meta docs.json listed the page but gen-nav was never run, so the site's meta.json (which drives the sidebar) didn't include it. Co-Authored-By: Claude Opus 5.5 --- site/content/docs/build/agents/meta.json | 1 + 1 file changed, 1 insertion(+) diff --git a/site/content/docs/build/agents/meta.json b/site/content/docs/build/agents/meta.json index 8d0cd44e..e73a2ff3 100644 --- a/site/content/docs/build/agents/meta.json +++ b/site/content/docs/build/agents/meta.json @@ -5,6 +5,7 @@ "build-your-agent/tools", "build-your-agent/triggers", "build-your-agent/alerts", + "build-your-agent/trigger-inventory", "build-your-agent/memory", "build-your-agent/variables", "build-your-agent/version-history",