---
title: Un agente se queda atascado en un bucle de reintentos
summary: Un agente reintenta repetidamente la misma llamada de herramienta fallida en lugar de detenerse o escalar: normalmente una credencial caducada o un desajuste en el ajuste de autonomía.
date: 2026-08-20
---

# Un agente se queda atascado en un bucle de reintentos

Un agente reintenta repetidamente la misma llamada de herramienta fallida en lugar de detenerse o escalar: normalmente una credencial caducada o un desajuste en el ajuste de autonomía.

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](/es/docs/guides/integrations-guide) 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](/es/docs/guides/agent-management)) 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](/es/docs/guides/agent-management): modos de autonomía y cuándo usar aprobación requerida
- [Seguridad](/es/docs/guides/security): cómo se delimitan y rotan las credenciales