Soporte

Solución de problemas

Fallos frecuentes—claves, conectores, CSP del widget, recuperación vacía—y cómo acotar la causa antes de contactar soporte.

solución de problemaserroresdepuración

La mayoría de incidencias giran en torno a credenciales, ámbito y contenido obsoleto. Esta página ofrece un orden de triage rápido; adjunta registros y marcas de tiempo al abrir tickets.

Reproduce en el chat de prueba del panel para saber si el problema es específico de canal o afecta a todo el agente.

Errores de claves API y de modelo

401/403 suelen indicar clave incorrecta, organización incorrecta o credencial BYOK caducada. Verifica que el entorno (prod frente a staging) coincida con la clave configurada.

Tras rotar, reinicia o refresca servicios dependientes que cachean cabeceras.

Respuestas pobres o vacías

Confirma que el agente usa la base de conocimiento esperada. Vuelve a ejecutar trabajos de sync o rastreo si el contenido cambió recientemente.

Comprueba si las instrucciones son demasiado restrictivas—el modelo puede rechazar aunque la recuperación acierte.

El widget no carga

Revisa CSP, bloqueadores de anuncios y colocación del script. Busca errores de consola que mencionen hosts connect-src bloqueados.

Confirma que la clave de embed coincide con el agente y listas de dominio permitidos si están habilitadas.

Errores de cuota en subida o rastreo (402 / “límite alcanzado”)

Si las subidas de conocimiento fallan con error estilo cuota o pago tras muchas imágenes o archivos de medios, puede que hayas agotado límites mensuales alojados de reconocimiento de imagen Gemini o transcripción de medios.

Mitigaciones: añade clave API Google Gemini en Ajustes → Claves API de LLM para que esas operaciones usen tu proyecto de Google, pide a un administrador que suba límites del plan, o sube temporalmente formatos con texto nativo y desactiva procesamiento de medios en rastreos.

  • Los rastreos que activan imagen o medios requieren configuración Gemini resoluble (alojada u org); si no, la API rechaza el inicio del rastreo con mensaje de Gemini faltante.
  • El texto solo OCR desde imágenes puede seguir apareciendo cuando se omite visión; no asumas que el archivo falló del todo—revisa el cuerpo almacenado del documento.

Construye sobre tu pila tecnológica

¿Listo para desplegar asistentes fundamentados?

Empieza una prueba o cuéntanos tus necesidades de despliegue, gobernanza y requisitos empresariales.