# AX-SYS-15: Sé idempotente y predecible donde importa

> Recovery and reliability · intermediate · AX-SYS-15

La misma llamada debe producir el mismo resultado, y los reintentos deben ser seguros, para que los agentes se recuperen sin causar efectos duplicados.

## Por qué

Los agentes reintentan. A diferencia de las personas, que notan un cobro duplicado y llaman a soporte, los agentes reintentan silenciosamente una escritura fallida y crean un registro duplicado o disparan una transacción duplicada. Speakeasy identifica la predictibilidad como una propiedad fundamental de AX. El patrón de clave de idempotencia de Stripe es el estándar de la industria: el cliente genera una clave única por intención y el servidor devuelve el mismo resultado para cualquier llamada posterior con esa clave. Esto es especialmente crítico en fintech y comercio electrónico, donde los reintentos no idempotentes causan daño financiero directo.

## Haz

Usa claves de idempotencia en las escrituras.

## No hagas

Crear un nuevo recurso en cada reintento idéntico.

## Artefacto

Envía una `Idempotency-Key` en las escrituras para que la misma clave devuelva el mismo resultado (reintentos seguros). Consulta el ejemplo de reembolso en [AX-SYS-13](ax-sys-13-consequential-actions-explicit-reversible.mdx).

## Fuentes

1. [Speakeasy — Designing Agent Experience](https://www.speakeasy.com/blog/agent-experience-introduction) — Predictability is a foundational AX property: agents must be able to retry safely; non-idempotent write endpoints turn retries into duplicate charges, duplicate records, or data corruption
2. [Stripe — Idempotent Requests](https://stripe.com/docs/api/idempotent_requests) — Industry-standard pattern: idempotency keys on write operations ensure the same request returns the same result regardless of how many times it is sent — essential for safe agent retries
3. [Anthropic — Building Effective AI Agents](https://www.anthropic.com/research/building-effective-agents) — Agents in automated pipelines will retry on network errors and timeouts; predictable, idempotent APIs are a prerequisite for reliable agentic operation

---
Source: Agent Experience Principles (axprinciples.com)