El 95% de los AI Agents Que Construyes Hoy se Van a Romper en Producción
No es culpa del modelo. Es culpa de tu try-catch.
La mayoría de los desarrolladores tratáis los AI Agents como software determinista. Escribís código que asume que el LLM va a devolver JSON válido. Que la tool call va a funcionar. Que el contexto va a caber en la ventana.
Y cuando falla, ponéis un try-catch.
*El problema no es que los agents fallen. Es que los tratáis como funciones puras cuando son sistemas probabilísticos. *
Un AI Agent no es una API REST. Es un bucle que toma decisiones. Y en cada iteración de ese bucle, hay al menos cinco puntos donde todo puede explotar:
- El LLM alucina un tool name que no existe.
- La tool recibe parámetros que no esperaba.
- La respuesta de la tool no es parseable.
- El contexto excede el límite de tokens.
- El LLM decide "no hacer nada" y entra en un bucle infinito.
Si tu estrategia de error recovery es un try-catch genérico que logea el error y reintenta, *no tienes un sistema de recuperación. Tienes una bomba de relojería. *
Vamos a construir algo que sí funcione.
---
❌ El Enfoque Que Mata a tus Agents: el Try-Catch Generalista
Esto no es error recovery. Es *tirar la toalla con estilo. *
El problema es conceptual: estás modelando un agent como una función pura. Pero un agent no es (input) => output. Un agent es un bucle:
Cada paso del bucle tiene tipos de error radicalmente diferentes. Y cada tipo requiere una estrategia de recuperación distinta.
✅ El enfoque correcto: no un try-catch, sino una máquina de estados con handlers específicos por fase.
---
El Framework de 4 Capas para Error Recovery en AI Agents
Basado en lo que he aprendido desplegando agents en producción para gestoriascercademi.com y Juridica Integral, aquí tenéis la arquitectura que sí funciona.
1. Capa de Detección: Clasificar el Error Antes de Actuar
No todos los errores son iguales. Y tratarlos igual es el error más caro que podéis cometer.
Clasificad los fallos en tres categorías:
| Tipo | Ejemplo | Estrategia |
|------|---------|------------|
| Recoverable | Tool timeout, JSON malformado | Reintentar con parámetros corregidos |
| Degradable | Contexto excede límite, modelo responde en inglés | Degradar comportamiento, no detener |
| Fatal | API key inválida, schema roto | Parar. No hay recuperación posible |
2. Capa de Estrategia: Cómo Recuperar Cada Tipo
Aquí es donde la mayoría se deja la productividad. Tener un plan de recuperación para cada tipo de error.
Para errores recoverable (tool timeout, JSON malformado):
Para errores degradable (contexto excedido, modelo impreciso):
El agent no se detiene. Simplemente opera con menos capacidad.
3. Capa de Circuit Breaker: No Dejar que un Error lo Contamine Todo
Esto es lo que diferencia un agent "de demo" de un agent "de producción".
Un circuit breaker monitoriza la tasa de fallos de cada tool y, cuando supera un umbral, la desactiva temporalmente.
Cuando el circuito está abierto, el agent no intenta llamar a esa tool. Simplemente salta al siguiente paso o responde con un mensaje de degradación.
4. Capa de Auditoría: Lo Que no Registras, No lo Puedes Mejorar
El error recovery no termina cuando el agent responde. Termina cuando tú analizas el fallo y mejoras el sistema.
Cada error recovery debe generar un evento. Cada evento debe ir a un log estructurado que puedas interrogar.
Si no tienes esto, estás operando a ciegas.
---
Implementación Completa: El Bucle del Agent con Error Recovery
Aquí tenéis el código que une todo. Es el patrón que uso en producción para Juridica Integral (procesamiento de documentos legales con agents autónomos):
---
Lo Que la Mayoría Sigue Haciendo Mal
Tres errores que veo cada semana revisando codebases de agents:
1. Reintentar sin backoff. Si una tool falla por timeout, reintentar inmediatamente es inútil. Usad backoff exponencial con jitter. Si no sabéis qué es eso, buscad "exponential backoff jitter" antes de desplegar nada.
2. No diferenciar entre error del LLM y error de la tool. Que el LLM devuelva JSON inválido no es lo mismo que una API externa caída. El primero se arregla con un mejor prompt o un parser robusto. El segundo requiere circuit breaker.
3. Ignorar el estado. Un error recovery que no actualiza el estado interno del agent produce respuestas inconsistentes. Si el agent dice "no puedo buscar en la web", pero su estado interno sigue asumiendo que puede, las siguientes decisiones serán incorrectas.
---
El Patrón que Debéis Robar: Supervisor Agent con Fallback Planning
La mejor arquitectura que he visto para error recovery no es un try-catch. Es tener un supervisor agent separado que monitoriza al worker agent y decide la estrategia de recuperación.
Este patrón duplica el coste de ejecución (dos LLM calls en lugar de una), pero multiplica la fiabilidad. Para agents en producción que manejan datos de clientes reales, es la única opción sensata.
---
La Regla de Oro del Error Recovery
*Un AI Agent no es bueno porque nunca falle. Es bueno porque sabe qué hacer cuando falla. *
La diferencia entre un agent de demo y un agent de producción no es la calidad del LLM. Es la calidad del sistema de error recovery.
Podéis tener el modelo más avanzado del mundo. Si vuestro agent se cuelga en un bucle infinito porque la tool devolvió undefined en lugar de null, ese modelo no vale nada.
En 2026, si estáis aprendiendo how to build ai agents 2026, lo primero que tenéis que dominar no es prompting ni RAG. Es error recovery. Todo lo demás viene después.
Construid el circuito. Clasificad los errores. Recuperad con estrategia.
Y dejad el try-catch genérico para los tutoriales de YouTube.
Artículos relacionados
- Error Recovery en Claude Agent SDK: El Framework de 5 Capas que Transforma Fallos en Recuperación
- Error Recovery en AI Agents: El Framework que Transforma el 40% de Fallos en Aprendizaje
- Error Recovery en AI Agents: Por Qué el Try-Catch No Es Suficiente y Cómo Implementar un Sistema de Clasificación que No Falle
- Error Recovery en AI Agents 2026: El 95% se Rompe en el Primer Error Real — y No, un Try-Catch No Va a Salvarlos
- Error Recovery en AI Agents 2026: El 95% se Rompe en el Primer Error Real — y No, un Try-Catch No Va a Salvarlos
---
¿Quieres recibir contenido como este cada semana? Suscríbete a mi newsletter

