Problem
Agents report success to people based on whatever the product returned. When that response is a redirect or a toast, there is no evidence to check and nothing to reference later.
Context
Use this pattern when:
- Actions create or change something a person cares about: orders, bookings, messages, settings.
- People, agents, or support staff may need to verify what happened afterward.
Recommended solution
Return a receipt for every state-changing action: a durable record with an ID, the action name, the exact inputs applied, the resources affected, the actor and grant used, and a timestamp. Store receipts so they can be retrieved later.
- 01Generate a receipt inside the same transaction as the action.
- 02Include resources affected and amounts charged.
- 03Record the agent and the person it acted for.
- 04Make receipts retrievable by ID.
Interaction diagram
Example implementation
Illustrative exampleExamples use a fictional store and illustrative field names. Adapt the shape to your stack; the qualities matter more than the exact format.
{
"id": "rcpt_77a1",
"action": "create_booking",
"status": "completed",
"occurredAt": "2026-10-06T14:03:52Z",
"actor": { "agent": "assistant.example", "onBehalfOf": "user_2291", "grant": "grt_41c" },
"effects": [
{ "type": "created", "resource": "/bookings/BK-55210" },
{ "type": "charged", "amount": 412.00, "currency": "USD", "paymentId": "pay_19c" }
]
}Accessibility and security
Accessibility
- Send people a human-readable version of the receipt through their preferred channel.
Security
- Receipts can contain personal data; apply the same access controls as the underlying resources.
- Make receipts append-only so they serve as an audit trail.
Related patterns
FeedbackExecution StatusGive long-running actions a status resource that agents can poll or subscribe to.TrustHuman ApprovalPause consequential actions until a person confirms, with a self-contained summary of what will happen.RecoveryRollbackProvide compensating actions so completed steps can be undone when a later step fails.
Applies the principles Verifiable Outcomes and Human Oversight.