Tell agents when things change
Avisa a los agentes cuando algo cambia
Offer webhooks, change feeds, or versioned change notes so agents do not operate on stale state or guess what moved.
Why
Agents acting on stale state cause real errors — wrong prices, cancelled orders, missing records. The canonical AX framework (agentexperience.ax — Contextual Alignment) explicitly requires that services provide feedback on both synchronous and asynchronous changes so agent context stays accurate. Biilmann's context pillar ("do your responses build the right context?") directly covers this: a response that doesn't surface changes forces the agent to re-crawl or guess.
Do
Provide webhooks plus a dated changelog.
Don't
Change schemas silently.
Artifact
{
"event": "order.updated",
"id": "evt_77",
"occurred_at": "2026-06-04T12:00:00Z",
"api_version": "2026-06-01",
"data": { "order_id": "ord_123", "status": "paid" }
}
X-API-Version: 2026-06-01
Sunset: Wed, 31 Dec 2026 23:59:59 GMT
Citations
- [01]agentexperience.ax — Principles of AX ↗
Contextual Alignment: services must provide feedback to agents on both synchronous (immediate) and asynchronous (eventual) changes so context stays accurate
- [02]Mathias Biilmann — AX in Practice ↗
Context pillar: responses should build the right context — stale state causes agents to act on wrong information