Nexovate RAG

El módulo Nexovate RAG (Retrieval-Augmented Generation) mejora las respuestas del bot de Discuss (NexoBot) utilizando documentación interna como fuente de conocimiento. Cuando un usuario envía una pregunta al bot en un canal de chat, el módulo envía la consulta al servicio nexovate-rag y devuelve respuestas precisas con enlaces a las fuentes originales.

Nota

Este módulo funciona de forma independiente a Victoria IA. Se integra con el bot estándar de Discuss (NexoBot), no con el asistente virtual de WhatsApp. Victoria IA tiene su propia integración RAG configurada en su panel de ajustes.

Características principales

• Búsqueda semántica en la base de conocimiento interna

• Respuestas formateadas con sugerencias numeradas

• Enlaces a las fuentes originales de la información

• Cola de tareas asíncrona con reintentos automáticos

• Deduplicación de consultas dentro de una ventana de tiempo

• Registro de depuración opcional

• Fallback automático a la respuesta estándar del bot si el servicio RAG falla

Requisitos previos

El servicio nexovate-rag debe estar instalado y en ejecución en su red privada antes de activar este módulo. El servicio expone un endpoint /ask que recibe preguntas y devuelve respuestas basadas en los documentos indexados.

Importante

El módulo se auto-instala junto con nexovate_base y mail_bot, pero permanece inactivo hasta que se configure la URL del servicio y se active manualmente.

Configuración

Para configurar Nexovate RAG:

1. Vaya a Ajustes ‣ Nexovate ‣ RAG.

2. Configure los siguientes campos:

   • URL del servicio RAG: Endpoint del servicio de consulta (por defecto: http://127.0.0.1:8081/ask). Solo se permiten direcciones de red privada (localhost, 10.x, 172.16-31.x, 192.168.x).

   • Timeout (segundos): Tiempo máximo de espera para la respuesta del servicio (por defecto: 20).

   • Número de sugerencias: Cantidad de resultados que se solicitan al servicio (por defecto: 3).

   • Mostrar fuentes: Incluir enlaces a los documentos fuente en la respuesta (activado por defecto).

   • Modo depuración: Registrar información detallada de las consultas en el log del servidor (desactivado por defecto).

3. Haga clic en Probar conexión para verificar que el servicio responde correctamente. El sistema guarda los parámetros y muestra una notificación con el resultado.

Uso

Una vez configurado, el bot responde automáticamente con información del servicio RAG:

1. Abra Discuss y envíe un mensaje directo a NexoBot (o en un canal donde el bot sea miembro).

2. Escriba una pregunta sobre la documentación interna.

3. El bot procesa la consulta:

   • Limpia el texto (elimina HTML, menciones y espacios extra).

   • Envía la pregunta al servicio RAG.

   • Formatea la respuesta con sugerencias numeradas y enlaces a fuentes (si está habilitado).

4. La respuesta aparece en el chat con el formato:

   📖 Según la documentación:
   
   1. [Primera sugerencia con enlace a la fuente]
   2. [Segunda sugerencia]
   3. [Tercera sugerencia]
   

Truco

Si el servicio RAG no tiene información relevante para la pregunta, el bot responde con el comportamiento estándar de NexoBot.

Cola de tareas

Las consultas se procesan mediante una cola asíncrona para evitar bloqueos:

• Las tareas se crean con estado pendiente y se procesan secuencialmente.

• Se usa bloqueo a nivel de base de datos (FOR UPDATE SKIP LOCKED) para permitir procesamiento seguro en entornos multi-worker.

• Las consultas duplicadas dentro de una ventana de tiempo configurable se deduplicano.

• En caso de error, se reintenta con backoff exponencial:

  • 1er reintento: 1 minuto

  • 2do reintento: 2 minutos

  • 3er reintento: 4 minutos

  • Después de 3 intentos fallidos: se marca como failed

• Una acción programada (Nexovate RAG: Procesar cola) se ejecuta cada minuto como respaldo del procesamiento en tiempo real.

Solución de problemas

Problema	Solución
El bot no responde con información RAG	Verifique que el servicio esté activo con Probar conexión. Compruebe que el bot sea miembro del canal. Asegúrese de que la pregunta se envía en un canal de tipo chat.
Respuestas lentas	Aumente el Timeout o verifique la latencia de red hacia el servicio RAG.
Errores frecuentes en la cola	Active el Modo depuración y revise los logs del servidor para identificar el problema de conectividad.
Resultados poco relevantes	Aumente el Número de sugerencias para obtener más opciones. Verifique que los documentos estén correctamente indexados en el servicio RAG.