Cuando se habla de agentes de inteligencia artificial, la mayoría de las demostraciones se centran en lo llamativo: el modelo que responde con precisión, la herramienta que se conecta sin esfuerzo, la memoria que contextualiza cada interacción. Sin embargo, la verdadera madurez de un sistema basado en agentes IA no reside en la agudeza del prompt, sino en la infraestructura invisible que lo sostiene. Esa capa, a menudo denominada 'fontanería', incluye límites de velocidad, reintentos inteligentes, presupuestos de tokens, circuit breakers y políticas de idempotencia. Es lo que separa una demo impresionante de un sistema fiable en producción.

Imaginemos un agente encargado de monitorizar precios hoteleros. El flujo básico parece sencillo: buscar hoteles, comparar tarifas, generar un resumen y notificar al usuario. Pero cuando ese agente se despliega en un entorno real, las cosas se complican. Una API de hoteles responde lentamente, el gateway de red alcanza su tiempo de espera, el cliente reintenta la petición y, de repente, dos instancias del mismo agente están ejecutándose en paralelo. Ambas consumen tokens, ambas escriben estado y ambas intentan enviar una notificación. El resultado es un caos determinista que nada tiene que ver con la inteligencia del modelo: es un fallo de arquitectura.

Para evitar estas situaciones, el primer paso es sacar el trabajo de larga duración del camino de la petición HTTP. En lugar de que el agente se ejecute dentro de la respuesta síncrona, conviene delegar la tarea a un worker asíncrono con una cola de trabajos. Esto permite controlar reintentos, backoff exponencial, tiempos de espera y límites de fallo sin bloquear al usuario. Un ejemplo práctico es utilizar BullMQ con un identificador de idempotencia basado en los parámetros de entrada. Si el cliente reintenta la misma petición, la cola lo reconoce como el mismo trabajo lógico y evita duplicados.

Los reintentos son necesarios, pero deben aplicarse con criterio. No todos los errores merecen un reintento. Un error de validación no se solucionará repitiendo la llamada; una violación de política debe detener el flujo de inmediato; una respuesta 429 (límite de velocidad) sí puede reintentarse respetando el tiempo de enfriamiento del proveedor. Clasificar los errores antes de decidir el próximo paso es una práctica de ciberseguridad y de resiliencia. Además, añadir un pequeño jitter aleatorio al retardo evita el efecto de 'manada atronadora' que satura los servicios downstream.

Otro aspecto crítico son los presupuestos de tokens. En un sistema de ia para empresas, cada ejecución de agente debe tener un límite predefinido de tokens de entrada y salida. Sin ese control, un bucle de reintentos puede disparar costes inesperados. Implementar un contador que verifique antes de cada llamada al modelo si aún queda presupuesto permite detener el agente de forma segura y registrar la razón. Esto se complementa con deadlines: un tiempo máximo total para la ejecución, con tiempos de espera individuales para cada herramienta. Si solo quedan dos segundos, no se debe iniciar una llamada que típicamente tarda diez.

Proteger los efectos secundarios -como notificaciones, reservas o actualizaciones de CRM- con claves de idempotencia es fundamental. Redis puede servir como almacén temporal: una operación solo se ejecuta si la clave no existe, y se marca como completada tras el éxito. Si falla, se elimina la clave para permitir un reintento controlado. Esto evita que un mismo usuario reciba dos correos o que se realice un doble cobro.

Los circuit breakers son otra pieza clave. Cuando una dependencia externa empieza a fallar repetidamente, el agente debe dejar de llamarla durante un periodo de enfriamiento. No tiene sentido seguir martilleando un servicio roto solo porque el flujo de trabajo lo permita. El agente puede registrar el fallo, abrir el circuito y decidir si continuar con otra estrategia o simplemente suprimir la acción. A veces, el mejor comportamiento es el silencio: si no se puede verificar el dato, no se debe inventar una respuesta amable pero imprecisa.

Todas estas decisiones deben ser observables. Un registro de decisiones de runtime -qué se reintentó, qué se suprimió, por qué se excedió el presupuesto- facilita la depuración y la mejora continua. No es necesario un sistema de trazado complejo; basta con una cola de eventos que guarde la razón de cada paso. Esto es especialmente relevante cuando se integran servicios cloud aws y azure o se gestionan pipelines de datos con power bi para monitorizar el rendimiento de los agentes.

En Q2BSTUDIO entendemos que construir un agente IA robusto va más allá de conectar un modelo a una API. Por eso ofrecemos servicios de inteligencia artificial para empresas que incluyen diseño de arquitecturas tolerantes a fallos, gestión de presupuestos y políticas de reintentos. También desarrollamos aplicaciones a medida y software a medida que integran estas mejores prácticas desde la primera línea de código. Nuestro equipo combina experiencia en ciberseguridad, servicios de inteligencia de negocio y cloud para garantizar que los agentes no solo sean inteligentes, sino también fiables.

En resumen, la fontanería de los agentes IA es tan importante como el modelo que los impulsa. Los límites, reintentos y presupuestos no son adornos: son la base sobre la que se construye la confianza del usuario. Si su organización quiere dar el salto de la demo a la producción, necesita un runtime que se comporte de forma segura cuando el mundo es lento, duplicado, limitado o parcialmente roto. En Q2BSTUDIO le ayudamos a lograrlo.