The Predictions screen
Navigate to Predictions in the left sidebar. The top-bar action area contains a window selector (7 d / 30 d / 90 d) that controls the data range shown across all panels.Summary tiles
Four KPI tiles appear at the top of the page:| Tile | Description |
|---|---|
| Total predictions | Count of predictions in the selected window |
| High-probability | Predictions with probability ≥ 80 % |
| Above alert threshold | Predictions above the workspace alert threshold (default 70 %) |
| Avg probability | Mean probability across all predictions in the window |
GET /v1/predictions/summary.
Risk signals table
Below the tiles, a table lists the top predictions by probability. Each row shows:- Pattern name — links to the pattern detail page
- Probability — score from 0.00 to 1.00, displayed as a percentage
- Impact —
critical,high,medium, orlow - Window — the prediction time window in days (e.g.
5D WINDOW) - Status pill — whether the prediction is active or dismissed
Composite risk forecast chart
The forecast chart is an interactive time-series showing the workspace-wide composite risk score over the selected window. It combines:- Observed series (solid line) — historical composite risk from confirmed incidents
- Projected series (dashed line) — AI extrapolation beyond today
- Alert threshold line — horizontal dashed line at your workspace’s alert probability (default 70 %)
- Breach marker — a labeled point where the projection crosses the alert threshold
GET /v1/predictions/forecast. You can scope the chart to a single pattern by passing pattern_id.
Probability matrix
The probability matrix is a 5 × 5 heat grid that maps likelihood (rows, bottom-to-top: Rare → Almost Certain) against impact (columns, left-to-right: Negligible → Severe). Each active prediction is plotted as a signal dot in its corresponding cell. Cell colors range from green (low risk) through amber and red to dark red (critical). The matrix gives you a portfolio view of where your risk is concentrated.Model accuracy panel
The model accuracy panel shows how well the prediction model is calibrated:Precision
Precision
The share of predicted incidents that actually occurred. Higher is better. Displayed as a filled arc gauge.
Recall
Recall
The share of real incidents the model predicted in advance. Higher is better. Displayed as a filled arc gauge.
Brier score
Brier score
Mean squared error of the model’s probability estimates. Lower is better (0 = perfect). Displayed as a green arc (inverted scale).
Lead time
Lead time
The average number of days of advance warning the model provides. Displayed as a number and a mini progress bar.
GET /v1/predictions/accuracy. The eyebrow label (e.g. EVAL 06·06) shows the date of the most recent model evaluation.
Alert rules panel
The alert rules panel displays the active alert rules for this workspace. Each rule shows its name, threshold, time window, and delivery channels. Use the toggle switch to enable or disable a rule.Alert rules are managed in detail on the Notifications & Alerts page. The panel here is a convenience view of the same data.
Filtering predictions
Use the query parameters onGET /v1/predictions to filter the list:
| Parameter | Description |
|---|---|
min_probability | Minimum probability (0.0–1.0) |
max_probability | Maximum probability (0.0–1.0) |
impact | critical, high, medium, or low |
pattern_id | Scope to a single pattern |
window_days | Prediction window in days |
sort | -probability (default), -generated_at, -window_days |
Providing feedback
After an event window closes, you can tell Causeloop whether a prediction was correct. This feedback is used to improve the model over time.Dismissing a prediction
If a prediction is no longer relevant (for example, the trigger event was cancelled), you can dismiss it viaPATCH /v1/predictions/{id} with dismissed: true. Dismissed predictions are hidden from the default list view but remain in the audit trail.
API reference
| Endpoint | Description |
|---|---|
GET /v1/predictions | List predictions with filters and pagination |
GET /v1/predictions/{id} | Get a single prediction |
PATCH /v1/predictions/{id} | Dismiss or update a prediction |
POST /v1/predictions/{id}/feedback | Record outcome feedback |
GET /v1/predictions/summary | KPI counters for the summary tiles |
GET /v1/predictions/forecast | Composite risk forecast time-series |
GET /v1/predictions/accuracy | Model precision / recall / Brier / lead time |
GET /v1/dashboard/forecast | Forecast data for the Dashboard |
Related pages
Patterns
Understand the patterns driving each prediction.
Notifications & Alerts
Create alert rules that fire when predictions cross a threshold.
Recommendations
Act on the AI’s recommended fix before the prediction materialises.
Dashboard
See the top predictions and model accuracy at a glance.