# Evidence-Based Alert Schema

Companion to **AI Agent Alerts That Explain What Happened and What to Do Next**.

Traditional: `Sales down 15%`. Agent: measured drop + **contributors with tools** + **actions**. If a contributor has no tool, it is an **unknown**, not a story.

## Schema

```json
{
  "alert_id": "ALT-DEMO-001",
  "headline": "Sales declined vs prior week as measured by salesByPeriod",
  "metric": { "name": "net_revenue", "delta_pct": -15, "evidence_tool": "salesByPeriod" },
  "contributors": [
    {
      "text": "Advertised SKU DEMO-1 ATP 0 from Tue 14:00",
      "evidence_tool": "getInventory",
      "evidence_ref": "sku:DEMO-1",
      "causation": "possible_contributor"
    }
  ],
  "unknowns": ["Paid traffic mix — no sessionsByChannel tool"],
  "recommended_actions": [
    { "rank": 1, "action": "Pause ads on DEMO-1", "autonomy": "recommend" },
    { "rank": 2, "action": "Expedite receipt if PO exists", "autonomy": "draft" },
    { "rank": 3, "action": "Do not markdown without pricing owner", "autonomy": "request_approval" }
  ],
  "human_required": true
}
```

Deltas in this file are **fixtures**. Do not cite them as a FactualMinds store KPI.

## Related

- RCA: [`root-cause-investigation-playbook.md`](root-cause-investigation-playbook.md)
- Monitoring: [`store-monitoring-signal-catalog.md`](store-monitoring-signal-catalog.md)
- Daily brief: [`operations-daily-brief-schema.md`](operations-daily-brief-schema.md)