SupportRetriever LogoSupportRetrieverAtención al cliente con IA

Solución de problemas de AI Companion

Problemas habituales y soluciones para AI Companion. Si tienes problemas, empieza aquí.

La sugerencia no aparece

Comprobar el estado de AI Companion

Problema: Las sugerencias dejaron de aparecer.

Soluciones:

  1. Ve a la configuración de AI Companion
  2. Comprueba que el interruptor de estado muestre Activo (no Pausado)
  3. Si está pausado, haz clic para activarlo
  4. Comprueba si la configuración sigue presente

Comprobar la fuente del último mensaje

Problema: La sugerencia no se genera para tu respuesta.

Motivo: AI Companion solo genera sugerencias cuando el último mensaje es del cliente.

Soluciones:

  • Espera a que el cliente responda
  • Las sugerencias se generan automáticamente con los mensajes del cliente
  • Tus respuestas no activan sugerencias

Comprobar validez de la clave API

Problema: La clave API puede ser inválida o haber caducado.

Síntomas:

  • Las sugerencias dejaron de aparecer
  • No se muestran mensajes de error
  • La configuración parece correcta

Soluciones:

  1. Ve a la configuración de AI Companion
  2. Haz clic en editar en Clave API
  3. Comprueba que la clave sea correcta (sin espacios extra)
  4. Prueba la clave en la consola del proveedor
  5. Genera una nueva clave si hace falta
  6. Actualízala en la configuración

Revisar el estado de la cuenta del proveedor

Problema: La cuenta del proveedor puede tener problemas.

Comprobar:

  • Estado de facturación – La cuenta tiene método de pago activo
  • Créditos/cuota – Créditos suficientes disponibles
  • Estado de la cuenta – La cuenta está activa y no suspendida
  • Límites de uso – Límites no superados

Soluciones:

  1. Inicia sesión en la consola del proveedor
  2. Revisa el estado de la cuenta y la facturación
  3. Comprueba créditos/cuota disponibles
  4. Revisa los límites de uso
  5. Añade método de pago si hace falta
  6. Contacta con el soporte del proveedor si persisten los problemas

Problemas de calidad de las sugerencias

Comprobar la URL de la base de conocimiento

Problema: Las sugerencias no hacen referencia a tu documentación.

Comprobar:

  • La URL de la base de conocimiento es correcta
  • La URL es accesible públicamente
  • El contenido está indexado por buscadores
  • El dominio coincide con tu sitio de documentación

Soluciones:

  1. Prueba la URL en el navegador en modo incógnito (debe cargarse sin iniciar sesión)
  2. Comprueba que el formato de la URL incluya https://
  3. Comprueba si el contenido aparece en la búsqueda de Google
  4. Actualiza la URL si la documentación se ha movido
  5. Asegúrate de que el contenido sea accesible públicamente

Revisar la calidad del contenido de la base de conocimiento

Problema: Las sugerencias son inexactas o desactualizadas.

Posibles causas:

  • La documentación está desactualizada
  • El contenido no coincide con tus productos/servicios
  • La información es incorrecta
  • La estructura no es clara

Soluciones:

  1. Revisa y actualiza la documentación
  2. Asegura la precisión del contenido
  3. Mejora la organización del contenido
  4. Añade información que falte
  5. Mantén la documentación al día

Valorar cambiar de proveedor

Problema: Calidad de sugerencias consistentemente baja.

Cuándo cambiar:

  • Las sugerencias son frecuentemente inexactas
  • El tono no encaja con tu marca
  • Las respuestas son demasiado genéricas
  • El proveedor no cubre tus necesidades

Cómo cambiar:

  1. Ve a la configuración de AI Companion
  2. Haz clic en editar en Proveedor
  3. Selecciona un nuevo proveedor
  4. Introduce la clave API del nuevo proveedor
  5. Guarda los cambios

Recomendaciones de proveedores:

  • OpenAI – Mejor calidad global
  • Anthropic – Rápido y eficiente
  • Gemini – Rentable
  • Grok – Opción alternativa

Revisar el contexto de la conversación

Problema: Las sugerencias no encajan con el contexto de la conversación.

Comprobar:

  • El historial de la conversación está completo
  • La pregunta del cliente es clara
  • Los mensajes anteriores dan contexto
  • No falta información

Soluciones:

  • Asegura el historial completo de la conversación
  • Comprueba el orden de los mensajes
  • Revisa si falta contexto
  • Proporciona más detalles si hace falta

Errores de clave API

Formularioato de clave inválido

Problema: El formato de la clave API es incorrecto.

Síntomas:

  • Mensaje de error sobre clave inválida
  • La clave no se acepta durante la configuración
  • Las sugerencias no se generan

Soluciones:

  1. Comprueba que el formato coincida con el proveedor:
    • OpenAI: Empieza por sk-proj- o sk-
    • Anthropic: Empieza por sk-ant-
    • Grok: Empieza por grok-
    • Gemini: Empieza por AIza
  2. Comprueba espacios extra (copia/pega con cuidado)
  3. Asegúrate de haber copiado la clave completa
  4. Genera una nueva clave si el formato es incorrecto

Claves caducadas o revocadas

Problema: La clave ya no funciona.

Síntomas:

  • Las sugerencias dejaron de funcionar
  • Mensajes de error sobre autenticación
  • La clave fue revocada en la consola del proveedor

Soluciones:

  1. Inicia sesión en la consola del proveedor
  2. Comprueba el estado de la clave
  3. Genera una nueva clave API
  4. Actualízala en la configuración de AI Companion
  5. Revoca la clave antigua por seguridad

Permisos insuficientes

Problema: La clave no tiene los permisos necesarios.

Comprobar:

  • La clave tiene acceso API habilitado
  • Los ámbitos/permisos necesarios están concedidos
  • La cuenta tiene el nivel de acceso necesario

Soluciones:

  1. Revisa los permisos de la clave en la consola del proveedor
  2. Asegúrate de que el acceso API esté habilitado
  3. Genera una nueva clave con los permisos correctos
  4. Actualízala en la configuración

Códigos de error por proveedor

Errores OpenAI:

Errores Anthropic:

  • 401 – Clave API inválida
  • 429 – Límite de tasa superado
  • 500 – Error del servidor
  • Consulta el estado de Anthropic

Errores Grok:

  • 401 – Clave API inválida
  • 429 – Límite de tasa superado
  • Consulta la consola xAI para el estado

Errores Gemini:

Preguntas de facturación

Entender los costes

Pregunta: ¿Cuánto cuesta AI Companion?

Respuesta:

  • SupportRetriever no cobra por el uso de IA
  • Pagas directamente a tu proveedor de IA
  • Coste típico: 0,005–0,03 € por sugerencia
  • Los costes mensuales varían según el volumen

Estimar costes:

  • 100 mensajes/día: ~15–45 €/mes
  • 500 mensajes/día: ~75–225 €/mes
  • 1000 mensajes/día: ~150–450 €/mes

Supervisar el uso

Cómo supervisar:

  1. Inicia sesión en la consola del proveedor
  2. Revisa el panel de uso
  3. Revisa los registros de llamadas API
  4. Configura alertas de uso
  5. Supervisa el gasto con regularidad

Cargos inesperados

Problema: Costes más altos de lo esperado.

Comprobar:

  • El volumen de uso ha aumentado
  • Las búsquedas en la base de conocimiento añaden coste
  • El precio del proveedor ha cambiado
  • No hay límites de uso configurados

Soluciones:

  1. Revisa el uso en el panel del proveedor
  2. Configura límites/alertas de uso
  3. Supervisa los costes con regularidad
  4. Valora cambiar de proveedor si los costes son altos
  5. Optimiza el uso de la base de conocimiento

Problemas de configuración

La configuración no se guarda

Problema: Los cambios no se mantienen.

Soluciones:

  1. Actualiza la página e inténtalo de nuevo
  2. Comprueba la conexión a internet
  3. Verifica los formatos de los campos (URL, clave API)
  4. Revisa la consola del navegador por errores
  5. Prueba otro navegador

Configuración perdida

Problema: La configuración ha desaparecido.

Posibles causas:

  • La configuración fue eliminada
  • Problema de cuenta
  • Problema de base de datos

Soluciones:

  1. Comprueba si la configuración sigue existiendo
  2. Verifica que hayas iniciado sesión en la cuenta correcta
  3. Intenta configurar de nuevo
  4. Contacta con soporte si el problema persiste

Problemas de la base de conocimiento

Base de conocimiento no encontrada

Problema: La IA no puede acceder a tu base de conocimiento.

Comprobar:

  • La URL es correcta y accesible
  • El dominio es accesible públicamente
  • El sitio no está detrás de autenticación
  • El contenido está indexado por buscadores

Soluciones:

  1. Prueba la URL en el navegador en modo incógnito
  2. Verifica el acceso público (sin inicio de sesión)
  3. Comprueba si el contenido aparece en la búsqueda de Google
  4. Asegúrate de que la URL incluya https://
  5. Actualiza la URL si la documentación se ha movido

La base de conocimiento no se está usando

Problema: Las sugerencias no hacen referencia a la documentación.

Comprobar:

  • La URL de la base de conocimiento está configurada
  • La URL es correcta y accesible
  • El contenido es buscable
  • El dominio coincide con el sitio de documentación

Soluciones:

  1. Verifica la URL de la base de conocimiento en la configuración
  2. Prueba la accesibilidad de la URL
  3. Asegúrate de que el contenido esté indexado
  4. Actualiza la URL si hace falta
  5. Revisa el comportamiento específico del proveedor

Problemas de rendimiento

Generación lenta de sugerencias

Problema: Las sugerencias tardan demasiado en aparecer.

Posibles causas:

  • Latencia de la API del proveedor
  • Historial de conversación largo
  • Retrasos en la búsqueda en la base de conocimiento
  • Problemas de red

Soluciones:

  1. Comprueba la página de estado del proveedor
  2. Reduce la longitud del historial de conversación (si es posible)
  3. Optimiza el contenido de la base de conocimiento
  4. Comprueba la conexión de red
  5. Valora un proveedor más rápido (Anthropic, Gemini)

Las sugerencias hacen timeout

Problema: Las sugerencias no se generan.

Soluciones:

  1. Comprueba el estado del proveedor
  2. Verifica que la clave API sea válida
  3. Comprueba créditos/cuota de la cuenta
  4. Revisa los mensajes de error
  5. Inténtalo más tarde si es un problema temporal

Obtener ayuda

¿Siguen los problemas?

Si los problemas persisten:

  1. Revisa esta guía – Consulta las secciones relevantes
  2. Revisa la configuración – Verifica la configuración
  3. Prueba el proveedor – Comprueba el estado del proveedor
  4. Contacta con soporte – Pide ayuda

Recursos útiles

Temas relacionados

¿Listo para simplificar tu soporte?
Únete a miles que usan SupportRetriever para gestionar conversaciones con clientes.
Probar gratis

Explorar más

Ver todos los artículos