Solución de problemas del agente de IA: no responde, no ejecuta acciones o entra en bucle
Diagnóstico paso a paso de las causas más comunes por las que un agente de IA no contesta, ignora una herramienta o repite la misma respuesta.
Mira este paso en el video · Solución de problemas
Cuando un agente de IA se queda callado, no ejecuta la acción que le pediste en el prompt, o parece repetir la misma respuesta una y otra vez, casi siempre es uno de estos motivos. Revísalos en orden.
1. El agente no responde en absoluto
- Agente inactivo: en el editor del agente (pestaña Identidad), confirma que el interruptor de estado esté en activo.
- Fuera de horario: si en la pestaña Comportamiento el Horario de atención está en Horario del negocio o Personalizado, fuera de esas ventanas la IA no responde con el modelo: envía el mensaje de Fuera de horario (si lo escribiste) y/o pasa la conversación al equipo. Es intencional. En el probador lo ves con el aviso de fuera de horario y puedes pulsar Probar como si estuviera en horario.
- Presupuesto diario de tokens: no es la causa. Ese campo del editor ya no frena al agente (está desactivado en toda la plataforma).
- Bolsa del plan y Saldo Omnifox agotados: cada plan tiene una bolsa mensual de tokens de IA. Cuando se agota, la IA sigue con tu Saldo Omnifox si tiene saldo y está activada Continuar con tu Saldo al superar el tope; si no, el sistema deja de llamar al modelo y escala la conversación en vez de dejar al cliente sin respuesta. Revisa el uso y recarga en Configuración → Facturación.
- Canal configurado en "nunca": si el canal tiene la estrategia de enrutamiento IA en "nunca", ese canal simplemente no dispara al bot.
2. El agente responde pero no ejecuta la acción esperada
- La herramienta está apagada para ese agente: cada herramienta (cerrar conversación, asignar, etc.) tiene un interruptor propio en la pestaña Acciones personalizadas / editor del agente. Si está apagado, el modelo nunca la ve disponible, por más que el prompt la mencione.
- La herramienta no está incluida en tu plan: agendar, mover y cancelar citas en el calendario de Omnifox está en todos los planes; las acciones HTTP requieren Impulsa o superior; actualizar datos o etiquetas del contacto, disparar workflow y agendar reunión (link de Cal.com) requieren Crece; manejar llamadas de voz (
handle_call) requiere Escala. - El prompt no da instrucciones claras de CUÁNDO usarla: el modelo solo llama a una herramienta si el system prompt describe la condición de disparo explícitamente (ej. "si el cliente confirma que está resuelto, cierra la conversación").
- Parámetros mal formados: si una herramienta requiere un dato exacto (ej.
stagede lifecycle o unworkflow_idnumérico) y el modelo no lo tiene, la llamada falla silenciosamente para el cliente pero queda registrada en el log/traza del Sandbox.
3. El agente entra en bucle / repite la misma respuesta
- Usa el Sandbox (Probador en vivo) del editor para reproducir la conversación y ver la traza completa turno por turno.
- Activa el candado anti-bucle: en la pestaña Comportamiento, el campo "Escalar a humano tras N respuestas sin resolver" corta el ciclo automáticamente después de N respuestas seguidas sin cierre (ver artículo dedicado).
- Revisa el umbral de confianza (
auto_handoff_confidence_threshold): si está muy bajo, el modelo puede seguir respondiendo aunque no esté seguro. - Si el bot recibe varios mensajes seguidos del cliente en pocos segundos, el anti-spam (Comportamiento → Anti-spam) agrupa esos mensajes en una sola respuesta — si está apagado, puede generar respuestas duplicadas o cruzadas.
Ejemplo
Un agente de Ventas no cierra nunca las conversaciones aunque el cliente diga "gracias, todo bien". Al revisar la pestaña Acciones, close_conversation estaba apagado para ese agente — se activó el interruptor y el prompt ya incluía la instrucción, así que empezó a funcionar de inmediato.
Consejos
- Prueba siempre los cambios en el Sandbox antes de asumir que "el modelo se equivocó" — la mayoría de los casos son de configuración, no del modelo.
- Si el problema persiste después de revisar todo esto, contacta a soporte con el ID de la conversación afectada.
Artículos relacionados
-
Crear tu primer agente de IA
Aprende qué hace un agente de IA en Omnifox, cómo darle instrucciones, conectarlo a un canal y probarlo en el sandbox antes de que hable con clientes reales.
-
Cómo escribir buenas instrucciones para tu agente de IA
Aprende a redactar instrucciones claras para que tu agente de IA responda con el tono, los límites y las acciones correctas.
-
Guía completa de los Agentes de IA
Los Agentes de IA a fondo, en 65 capítulos: crear, instrucciones, herramientas, conocimiento, comportamiento, probador, bandeja, flujos, analítica y consumo, con cada opción explicada.
-
Conectar tu agente de IA a WhatsApp, Instagram, Messenger y el chat web
Un agente sin canales no atiende a nadie. Conéctalo a tu WhatsApp, Instagram, Messenger o al chat de tu sitio web desde la sección Conexiones, y enciéndelo para que empiece a responder.
-
Empieza aquí: los Agentes de IA en 8 minutos
Lo esencial de los Agentes de IA en un video corto: crear un agente, sus instrucciones, herramientas, conocimiento, canales, el probador, el horario y el paso a una persona.