Skip to main content
A prediction is the AI’s forward-looking signal that a pattern is likely to recur within a given window. Predictions let you act before an incident happens rather than responding after the fact. Predictions are generated automatically from active and emerging patterns. Each prediction carries a probability score (0–1), an impact level, and a time window.

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:
TileDescription
Total predictionsCount of predictions in the selected window
High-probabilityPredictions with probability ≥ 80 %
Above alert thresholdPredictions above the workspace alert threshold (default 70 %)
Avg probabilityMean probability across all predictions in the window
These figures come from 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
  • Impactcritical, high, medium, or low
  • Window — the prediction time window in days (e.g. 5D WINDOW)
  • Status pill — whether the prediction is active or dismissed
Click any row to navigate to the corresponding pattern or to provide feedback on the prediction.

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
Click or arrow-key through any point on the chart to see an exact value tooltip. The projected section of the line is labeled with “PROJECTED” in the tooltip.
The forecast data comes from 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:
The share of predicted incidents that actually occurred. Higher is better. Displayed as a filled arc gauge.
The share of real incidents the model predicted in advance. Higher is better. Displayed as a filled arc gauge.
Mean squared error of the model’s probability estimates. Lower is better (0 = perfect). Displayed as a green arc (inverted scale).
The average number of days of advance warning the model provides. Displayed as a number and a mini progress bar.
The accuracy data comes from 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 on GET /v1/predictions to filter the list:
ParameterDescription
min_probabilityMinimum probability (0.0–1.0)
max_probabilityMaximum probability (0.0–1.0)
impactcritical, high, medium, or low
pattern_idScope to a single pattern
window_daysPrediction 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.
1

Find the prediction

Locate the prediction in the list or navigate to it via its pattern.
2

Submit feedback

Call POST /v1/predictions/{id}/feedback with outcome: "correct" or "incorrect" and an optional notes field.

Dismissing a prediction

If a prediction is no longer relevant (for example, the trigger event was cancelled), you can dismiss it via PATCH /v1/predictions/{id} with dismissed: true. Dismissed predictions are hidden from the default list view but remain in the audit trail.

API reference

EndpointDescription
GET /v1/predictionsList 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}/feedbackRecord outcome feedback
GET /v1/predictions/summaryKPI counters for the summary tiles
GET /v1/predictions/forecastComposite risk forecast time-series
GET /v1/predictions/accuracyModel precision / recall / Brier / lead time
GET /v1/dashboard/forecastForecast data for the Dashboard

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.