Skip to content

Commit 81b184a

Browse files
committed
Sync open source content 🐝 (from 08418dc31f3a22e6a506d3dcf5c28a6710c6bace)
1 parent f27ddd7 commit 81b184a

3 files changed

Lines changed: 43 additions & 2 deletions

File tree

docs/ai-control-plane/secure/index.mdx

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,11 @@ Secure pages require the organization admin role.
1111

1212
### [Watchdog](/docs/ai-control-plane/secure/watchdog)
1313

14-
The risk dashboard: findings clustered into ranked signals, with headline metrics, exposure by data type, and suppression and exclusion actions. Any finding opens the full session transcript for investigation. Watchdog replaces the former Risk Overview and Risk Events pages.
14+
The risk dashboard: findings clustered into ranked signals, with headline metrics, exposure by data type, and suppression and exclusion actions. Any finding opens the full session transcript for investigation. Watchdog replaces the former Risk Overview page.
15+
16+
### [Risk Events](/docs/ai-control-plane/secure/risk-events)
17+
18+
The finding-level log: every policy finding across recently analyzed sessions, one row per finding, with redacted matches, filters, and a risk-focused session view for investigating any single finding.
1519

1620
### [Guardrails](/docs/ai-control-plane/secure/guardrails)
1721

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
---
2+
title: Risk Events
3+
description: "Review individual policy findings across analyzed agent sessions, with redacted matches and full-session investigation."
4+
---
5+
6+
import { Callout } from "@/mdx/components";
7+
8+
The **Risk Events** page is the finding-level log: every policy finding across recently analyzed sessions, one row per finding. Open it from **Secure > Risk Events** in the dashboard.
9+
10+
Where [Watchdog](/docs/ai-control-plane/secure/watchdog) clusters findings into ranked signals for triage, Risk Events lists the raw findings themselves — useful for auditing individual matches, tracking down a specific rule or user, or handing a single finding to a teammate.
11+
12+
## Access requirements
13+
14+
<Callout type="info">
15+
Viewing this page requires the `org:admin` scope. Access is included in the [default Admin role](/docs/ai-control-plane/org-admin/roles-and-permissions) but not the Member role.
16+
</Callout>
17+
18+
## Event list
19+
20+
Each finding shows its timestamp, category, severity, rule, session name, user, matched content, and the [guardrail policy](/docs/ai-control-plane/secure/guardrails) that raised it. The list loads continuously with a running count of findings shown.
21+
22+
Filters narrow the stream. **Policy** and **Date range** are always visible, and the rest live behind **More filters**:
23+
24+
- **Policy** — including inactive policies, which are labeled and produce a notice
25+
- **Date range**
26+
- **Rule ID** — matches rule IDs containing the entered text
27+
- **User**
28+
- **Unique matches only**
29+
- **Assistant** — including sessions with no assistant
30+
31+
## Redaction and reveal
32+
33+
Matched content is redacted by default. Individual matches can be revealed inline, and a **Reveal all** toggle in the header switches the whole view. Findings from natural-language guardrails open a match dialog with the evaluated content.
34+
35+
## Investigating a finding
36+
37+
Clicking a finding opens the session detail in a risk-focused view — the same transcript panel as [Agent Sessions](/docs/ai-control-plane/observe/agent-sessions), with flagged messages highlighted and unflagged messages dimmed. Each finding also has a copyable share link for handing an investigation to a teammate.

docs/ai-control-plane/secure/watchdog.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ import { Callout } from "@/mdx/components";
88
The **Watchdog** page shows the riskiest AI usage in the organization, clustered and ranked. Open it from **Secure > Watchdog** in the dashboard.
99

1010
<Callout type="info">
11-
Watchdog replaces the former Risk Overview and Risk Events pages. Old links redirect here.
11+
Watchdog replaces the former Risk Overview page, and old Risk Overview links redirect here. The raw finding-level log lives on the [Risk Events](/docs/ai-control-plane/secure/risk-events) page.
1212
</Callout>
1313

1414
## Access requirements

0 commit comments

Comments
 (0)