Tu agente de IA no necesita ser más inteligente. Necesita ser idempotente
La mayoría de los agentes de IA en producción no fallan por un mal razonamiento. Fallan por errores de red.
El modelo elige la herramienta correcta. Completa los detalles correctos. Luego, le cobra dos veces a un cliente.
Esto sucede porque los agentes con capacidad de escritura operan en redes poco fiables.
- Las solicitudes agotan el tiempo de espera.
- Las conexiones se caen.
- Los frameworks reintentan pasos que ya han finalizado.
En un agente de solo lectura, un reintento es gratuito. En un agente con capacidad de escritura, un reintento es una segunda acción irreversible.
La solución es la idempotencia.
Observa este fallo común:
- El agente llama a una función para enviar una factura.
- El servicio crea la factura.
- La conexión se interrumpe antes de que la respuesta llegue al agente.
- El agente detecta un tiempo de espera agotado y reintenta.
- Ahora, tienes dos facturas.
Un modelo más inteligente no solucionará esto. De hecho, un modelo más inteligente podría empeorarlo al ser más agresivo con los reintentos.
Puedes aprender de sistemas de pago como Stripe. Ellos utilizan una Idempotency-Key. El servidor guarda el resultado de la primera solicitud. Si el cliente envía la misma clave de nuevo, el servidor devuelve el resultado almacenado en lugar de ejecutar la acción por segunda vez.
Para un agente de IA, debes derivar esta clave de la intención.
No utilices IDs aleatorios. Utiliza un hash del nombre de la herramienta y sus parámetros estables.
Ejemplo:
- Herramienta:
charge_customer - Parámetros:
{customer_id: 42, amount: 500} - Clave:
hash(tool + params)
Si el agente reintenta exactamente el mismo cargo, la clave sigue siendo la misma. El sistema la reconoce y evita un cargo duplicado.
Una advertencia: tu clave es tan buena como tu definición de una acción única.
- Si incluyes una marca de tiempo (timestamp) en tu hash, cada reintento obtendrá una clave nueva. Tu protección fallará.
- Si incluyes el cuerpo de un mensaje escrito por un LLM, el modelo podría cambiar una sola palabra. Esto creará una nueva clave y una acción duplicada.
Utiliza siempre datos estables como IDs de cliente o IDs de factura para generar la clave. Excluye cualquier cosa que el modelo pueda cambiar.
Deja de intentar arreglar la fiabilidad de los agentes con mejores prompts.
La fiabilidad consiste en hacer que el coste de una decisión repetida sea cero. Si tu agente realiza la misma acción dos veces, nada debería romperse.
Comunidad de aprendizaje opcional: https://t.me/GyaanSetuAi