Un agente se queda atascado en un bucle de reintentos

Si un agente parece repetir la misma acción una y otra vez sin avanzar, casi siempre está reintentando una llamada de herramienta que falla de la misma forma cada vez, no un fallo en el propio razonamiento del agente.

Causa más común: una credencial caducada o revocada

Si la integración de la que depende una llamada de herramienta tiene un token caducado que no se renovó, o fue revocada desde Configuración → Integraciones, cada reintento falla de forma idéntica. Reconecta la integración desde su tarjeta de configuración. Ver la Guía de integraciones para saber cómo funciona normalmente la renovación automática de tokens.

Límites de tasa en el servicio externo

Un límite de tasa de una API de terceros (no un límite de HeartBeatAgents) puede parecer, desde fuera, idéntico a un bucle atascado. El agente sigue reintentando una llamada que el servicio externo sigue rechazando. Comprueba el propio panel de ese servicio para errores de límite de tasa o de cuota en las mismas marcas de tiempo.

Desajuste de modo de autonomía

Un agente en modo automático completo no tiene un punto natural donde detenerse y pedir ayuda cuando falla una llamada de herramienta. Simplemente sigue intentándolo. Si una tarea realmente necesita una decisión humana en algún punto, pasar ese agente a aprobación requerida (ver Gestión de agentes) le da un lugar donde detenerse y mostrar el fallo en lugar de reintentar a ciegas.

Si nada de lo anterior aplica

Revisa el registro de conversación del agente para ver el error de herramienta real que se devuelve: el bucle de reintentos es un síntoma, y el error de herramienta subyacente suele nombrar directamente la causa real.

Relacionado

• Gestión de agentes: modos de autonomía y cuándo usar aprobación requerida
• Seguridad: cómo se delimitan y rotan las credenciales