Errores de sincronización

Cuando una fuente termina con estado de error, Kelova guarda el motivo y te muestra un mensaje accionable en el dashboard. Esta guía te ayuda a identificar la causa y corregirla sin perder los chunks ya indexados de la versión anterior.

Cómo saber que una fuente falló

En /dashboard/sources, cada fuente muestra una insignia de estado:

Pendiente — creada, todavía no se ha sincronizado nunca.
Sincronizando — el sync está en curso.
Sincronizado — el último sync terminó bien.
Error — el último sync falló. El mensaje de error queda visible en la tarjeta de la fuente.
Reconectar credenciales — las credenciales de la fuente (por ejemplo Google Drive) expiraron y necesitas volver a autorizar el acceso.

Si una fuente queda en error, los documentos indexados en el sync anterior siguen disponibles para el agente — Kelova nunca borra chunks válidos hasta que un sync nuevo termina con éxito. Solo esa fuente queda desactualizada hasta que corrijas el problema.

Categorías de error más comunes

Error de autenticación

Ocurre cuando las credenciales de un conector (Google Drive, OneDrive) expiraron o fueron revocadas. La fuente pasa a estado "Reconectar credenciales".

Cómo resolverlo:

Abre la fuente en /dashboard/sources.
Usa el botón "Reconectar" para volver a autorizar el acceso.
Una vez reconectada, el siguiente sync (manual o automático) se ejecuta con normalidad.

Error de extracción

Ocurre cuando Kelova no pudo obtener texto legible del documento o la página web. Los casos más frecuentes:

PDF escaneado o infográfico sin texto digital (pdf_scanned_no_ocr): el PDF es una imagen, no texto. Exporta el documento como PNG o JPG y súbelo de nuevo — la imagen sí se procesa con OCR.
Sitio web no indexable (sitio_no_indexable): la página requiere JavaScript para renderizar el contenido o bloquea indexadores automáticos. Exporta el contenido como PDF o TXT y súbelo como archivo en vez de conectar la URL. Ver Subir archivos.
Contenido no accesible: la URL devolvió un error o el sitio bloqueó la solicitud. Verifica que la página sea pública y esté disponible antes de reintentar.

Error de embeddings

Ocurre cuando falla la llamada al proveedor de embeddings durante el sync. Es un error transitorio en la mayoría de los casos — espera unos minutos y sincroniza manualmente de nuevo desde la fuente.

Error de validación de calidad

Kelova valida cada chunk antes de indexarlo. Si el contenido no pasa el control de calidad, el sync falla con uno de estos motivos:

Fragmentos demasiado cortos: el documento tiene muy poco texto por sección. Usa un documento más extenso o combina varios archivos relacionados en uno solo.
Fragmentos demasiado largos: el documento no tiene párrafos o encabezados claros que permitan dividirlo en secciones manejables.
Contenido duplicado: varias páginas o secciones tienen el mismo texto (frecuente en sitios web con plantillas repetidas). Reduce las URLs indexadas o sube el contenido relevante como archivo.
Calidad insuficiente: el contenido detectado es mayormente texto de plantilla (menús, pies de página) sin información sustantiva.

Reintentar un sync manual

Corrige la causa del error según la categoría (reconectar credenciales, cambiar el formato del archivo, etc.).
Ve a /dashboard/sources y ejecuta el sync manual de esa fuente.
Espera a que el estado cambie a "Sincronizado". Si vuelve a fallar, el mensaje de error se actualiza con el motivo más reciente.

Si el problema persiste después de aplicar la corrección sugerida, revisa que el tipo de archivo esté soportado en Subir archivos antes de volver a intentarlo.