Cuando algo no funciona
Los cinco problemas que la gente tiene de verdad, y qué significa cada uno.
El asistente dice que no lo sabe
Casi siempre falta contenido, no está roto el asistente. Comprueba en este orden:
- ¿Está indexado el documento? Un documento no se puede buscar hasta que dice Indexado. Un PDF grande tarda un minuto o dos.
- Pregúntaselo en el Playground y lee el contexto recuperado. Cada pasaje que recibió el modelo aparece bajo la respuesta, con su puntuación. Si el pasaje correcto no está ahí, es un problema de recuperación, no del modelo.
- Si el pasaje está y la respuesta sigue siendo mala, probablemente el pasaje no dice lo que crees que dice. Léelo como lo leería un desconocido.
- Si no volvió nada relevante, baja el umbral de similitud o sube Top K en Recuperación -- pero cambia una cosa cada vez y vuelve a hacer la misma pregunta, o no sabrás qué ayudó.
La página de Resumen muestra "respondido desde la KB" como porcentaje. Un número bajo es un mapa de lo que tu contenido no cubre, y las conversaciones que hay detrás te dicen para qué preguntas escribir.
El widget no aparece en mi sitio
- ¿Está publicado? Un widget en borrador solo se ve en tu propia vista previa.
- ¿Está permitido el dominio? Un widget se niega a funcionar en un sitio que no está en su lista de dominios permitidos. Es a propósito: es lo que impide que alguien copie tu fragmento en su web.
- ¿Está el script en la página? Mira el código fuente y busca la etiqueta. Un gestor de etiquetas sin publicar no cuenta.
- Mira el estado del widget. "Activo" significa que lo hemos visto cargar en una página real hace poco. Si dice Publicado pero nunca Activo, el fragmento no se está ejecutando.
Una fuente dejó de sincronizar
Lee el estado, porque los tres fallos piden cosas distintas:
- Credencial caducada: al otro lado cambiaron la contraseña o revocaron el token. Reconéctala. Reintentar no sirve.
- Requiere acción: una página devuelve 404, un robots.txt nos bloquea, se acabó una cuota. Se arregla en el origen.
- Error: algo pasajero. Vuelve a intentarlo y abre el Registro de sincronización, que muestra cada ejecución, qué encontró y qué falló.
Las respuestas citan el mismo documento cinco veces
Eso ya está corregido: las citas se agrupan por sección y se limitan a dos por documento. Si sigues viendo casi duplicados, probablemente el mismo contenido esté dos veces en la base -- un PDF subido y una página rastreada de lo mismo, por ejemplo. Borra uno.
Se paró todo a la vez
Mira Facturación y uso. Si se agotaron los mensajes del periodo, las preguntas nuevas se rechazan hasta que se reinicie, y una prueba terminada hace lo mismo. Ninguna de las dos cosas borra nada ni te cobra por pasarte.
Si no es ninguna de ellas, informa de un error desde la barra lateral. Captura la página, la actividad reciente y la petición que falló, así no tienes que describir nada de eso.