Skip to main content
Version: 11.5.0

Guardrail Settings

Guardrails → Settings sets how loud guardrail alerts get, what happens when an attack is confirmed, how long a held action waits for a person, and how the session investigator behaves. This page lists every field, with its default and range.

Before You Begin​

ToYou needOut of the box
Open the page and read the valuesGuardrails: ManageAdmin and Security analyst
Save changes, and add or change per-agent overridesGuardrails: Manage and Settings: EditAdmin

A role that can open the page but not save it sees the values, and You need settings:edit to change these. in place of Save changes. The page and its sidebar entry are hidden from roles without Guardrails: Manage.

Change the Settings​

  1. Open Guardrails → Settings.
  2. Change the fields you need. Each panel is described below.
  3. Click Save changes.

The console confirms Guardrail settings saved. The form does not accept a value outside its range. The guardrail settings, like the data classification settings, are managed on their own page, and the general settings API does not change them.

Turning on tool quarantine while changed tools still wait for review asks Quarantine changed tools?, because agents lose those tools as soon as you save. Click Quarantine them to go ahead.

The Guardrails Settings page with the Alerts, Containment, Tool integrity, Approvals and Session investigator panels

Alerts​

SettingWhat it controlsDefaultRange
Daily non-critical alerts per supervisorHow many non-critical alerts are raised for one supervisor per UTC day. Critical alerts are always raised30–50
Dedupe window (minutes)How long repeats of the same situation fold into one alert305–1,440
SOC distribution listThe addresses a session pause goes to when the investigator escalates it to soc. Comma-separatedEmptyUp to 5 addresses
Auto-pause a session after repeated denialsWhether repeated guardrail denials on one session, close together, pause the session. See What Pauses a SessionOn—

The SOC distribution list is empty until you fill it. While it is empty, a pause escalated to soc reaches no one by email, and resolves when its pause TTL passes. See Escalation and Signed Resume.

Containment​

SettingWhat it controlsDefault
On a Critical alertThe automatic containment for a critical guardrail event: End session + revoke or Pause onlyEnd session + revoke

Tool Integrity​

SettingWhat it controlsDefault
Quarantine tools whose definition changes after approvalOff: a changed tool is flagged and alerted, and agents can keep using it while you review. On: agents cannot see or call it until the change is approved. A rejected change is always blocked. See Tool-Definition IntegrityOff

Approvals​

SettingWhat it controlsDefaultRange
High-risk sink approval TTL (seconds)How long a held high-risk action waits for a person before it expires12030–900

Session Investigator​

These settings are explained on The Session Investigator.

SettingDefaultRange
Mode: Off, Observe (shadow) or EnforceOff—
When the investigator is uncertain: Fail open (allow + log) or Fail closed (pause)Fail open—
Escalate a pause to: soc, supervisor or an email addresssoc—
Minimum confidence to act (%)8050–100
Pause TTL (seconds)90060–86,400
Fast-approval hold (seconds). Capped at the pause TTL. 0 turns it off3000–1,800
Quarantine the identity on a hostile verdictOn—

Per-Agent Overrides​

The Per-agent overrides panel, below the settings, overrides the session investigator for one agent. Each override can set Mode, Fail-mode, Escalate to, Minimum confidence (%) and Pause TTL (seconds), with the same ranges as the tenant settings. A blank field inherits the tenant setting, and reads Inherit (tenant default) in the table.

The panel saves on its own, separately from Save changes. With no overrides, it reads No per-agent overrides — every agent follows the tenant default. For the steps, see Per-Agent Overrides.