Síntoma / Necesidad

Necesito integrar inteligencia artificial en wolkvox CRM para que asista a los usuarios con información relevante del negocio, automatizar respuestas, y mejorar la eficiencia operativa. Quiero crear, configurar y gestionar bases de conocimiento específicas (RAGs) para diferentes equipos o áreas, y activar el asistente de IA para que los usuarios puedan consultarlo en tiempo real.

Contexto / Escenarios

"Knowledge Retrieval" y "wvx CRM Assistant" son herramientas integradas en wolkvox CRM diseñadas para potenciar la asistencia a los usuarios mediante inteligencia artificial. Permiten crear "RAGs" (Retrieval Augmented Generation) que son bases de conocimiento entrenadas con información específica de su negocio. Esta segmentación es crucial para que cada equipo (ventas, recaudo, atención al cliente, soporte técnico, etc.) tenga acceso a información precisa y relevante para sus funciones.

El "wvx CRM Assistant" es la interfaz de chat donde los usuarios interactúan con la IA, obteniendo respuestas basadas en la base de conocimiento configurada. Este asistente está diseñado para brindar apoyo rápido y puntual en diversas situaciones dentro de los módulos de wolkvox CRM, sin mantener un historial de conversación prolongado para enfocarse en consultas específicas.

Escenarios de uso:

• Un agente de ventas necesita información rápida sobre un producto específico o una política de descuentos.
• Un agente de soporte requiere datos técnicos para solucionar un problema común.
• Un agente de recaudo necesita verificar detalles sobre un plan de pagos o un caso de cartera.
• Automatizar respuestas a preguntas frecuentes para liberar tiempo del personal.

Respuesta (Solución / Recomendación)

Para configurar y utilizar el wvx CRM Assistant, siga los siguientes pasos:

Acceder a la Configuración de Knowledge Retrieval:

1. En el menú lateral izquierdo de wolkvox CRM, haga clic en el botón "Configuración".
2. Dentro de la sección de Configuración, seleccione la pestaña "Knowledge Retrieval".

Crear un nuevo RAG (Base de Conocimiento):

En la interfaz de "Knowledge Retrieval", en la parte inferior derecha, haga clic en el botón " + Crear rag".

1. Se abrirá una ventana modal. Complete los siguientes campos:
   1. Nombre del RAG: Asigne un nombre único al RAG (solo letras, números y guion bajo; sin espacios ni caracteres especiales).
   2. Descripción: Proporcione una breve descripción del propósito o contenido del RAG.
   3. Etiquetas: Escriba etiquetas relevantes y presione Enter después de cada una para asignarlas. Esto ayuda a categorizar y organizar sus RAGs.
2. Haga clic en el botón "Crear".
3. El nuevo RAG aparecerá en la tabla "Lista de rags".

Configurar un RAG existente:

1. En la tabla "Lista de rags", haga clic izquierdo en el "Nombre del RAG" que desea configurar. Esto lo llevará a la pantalla de configuración de ese RAG.
2. Alternativamente, puede hacer clic en el botón de tres puntos verticales al lado derecho de un RAG en la lista y seleccionar "Configuración".

Pestaña "Configuración RAG":

Una vez dentro de la configuración del RAG, en la pestaña "Configuración RAG", ajuste los siguientes parámetros:

1. Modelo AI:
   1. Seleccione "Fast": Para respuestas rápidas y directas.
   2. Seleccione "Thinking": Ideal para situaciones que requieren un análisis más detallado del contexto y razonamiento.
2. Instrucciones: Escriba instrucciones claras para la inteligencia artificial. Por ejemplo: “Proporciona información detallada únicamente en base a la documentación ingresada. No inventes información. Si no encuentras información relacionada con la solicitud, responde que no tienes datos al respecto.”
3. Número max. resultados: Establezca la cantidad máxima de resultados que la IA debe considerar. El valor debe estar entre 5 y 100. (Recomendación: Pruebe diferentes valores para encontrar el óptimo).
   1. Mensaje de error si el rango es incorrecto: “El topk debe ser un número entre 5 y 100.”
4. Nivel de precisión (%): Defina el nivel de precisión deseado para las respuestas, lo que puede optimizar costos o mejorar la exactitud. El valor debe estar entre 0 y 2 (con decimales). (Recomendación: Realice pruebas para identificar el nivel ideal).
   1. Mensaje de error si el rango es incorrecto: “Debe ser un número entre 0 y 2 con un decimal.”
5. Haga clic en el botón "Guardar" para aplicar los cambios.

Subir documentos a un RAG (Pestaña "Configuración RAG" o "Knowledge management"):

Puede subir documentos desde dos ubicaciones:

1. Desde la pestaña "Configuración RAG": Haga clic en el botón "Subir documentos" (debajo del campo "Instrucciones").
2. Desde la pestaña "Knowledge management": En la parte superior derecha, haga clic en el botón "+ Subir documento".

En ambos casos, se abrirá una ventana modal:

• Categorías: Ingrese categorías relevantes para el documento. Presione Enter después de cada categoría.
• Cantidad de chunks: Defina el tamaño de los "chunks" (fragmentos) de texto. Un valor común y recomendado es 500 chunks, pero puede establecer un valor entre 100 y 4096. (Recomendación: Pruebe y ajuste según el tipo de documento y las respuestas deseadas).

Seleccionar o soltar los documentos para cargar: Arrastre y suelte el archivo o haga clic para seleccionarlo.

• Formatos soportados: PDF, TXT.
• Tamaño máximo por archivo: 50 MB.
• Nota: Solo se puede cargar un documento a la vez.

Gestionar documentos en la pestaña "Knowledge management":

1. En la pestaña "Knowledge management" del RAG, verá una tabla con todos los documentos subidos. Las columnas son: 'Título', 'Categoría', 'Fecha de subida' y 'Tamaño'.

Para cada documento, hay un botón de tres puntos verticales al lado derecho con las siguientes opciones:

• Detalles: Muestra una ventana modal con información básica del archivo.
• Editar: Permite editar únicamente las categorías asignadas al documento. No se puede cambiar el título, el nombre del archivo ni reemplazar el documento.
• Eliminar: Permite eliminar el documento del RAG.

Probar la configuración:

Utilice el hilo de mensajes del chat de prueba en la pestaña "Configuración RAG" para validar el comportamiento del RAG antes de activarlo para los usuarios finales.

Activar el wvx CRM Assistant para los usuarios:

Una vez que haya configurado su RAG y subido los documentos, debe activar el asistente para los usuarios:

1. Vuelva al menú lateral izquierdo y haga clic en "Configuración".
2. Diríjase a la pestaña "General".
3. Dentro de la pestaña "General", seleccione "CRM Assistant".
4. En el campo "Seleccionar knowledge retrieval base", elija el RAG que desea usar para el asistente de IA.
5. Active el servicio haciendo clic en el botón tipo interruptor "Activar wvx CRM Assistant".

Usar el wvx CRM Assistant:

1. Una vez activado, los usuarios de wolkvox CRM verán un botón en la parte superior derecha de la interfaz llamado "wvx CRM Assistant".
   • Haga clic en este botón para abrir la ventana de chat del asistente.
2. Escriba su mensaje o pregunta en el campo "Escribe tu mensaje..." y presione Enter o haga clic en el icono de envío.
   • El asistente responderá basándose en la información contenida en el RAG configurado.
   • Cada respuesta del wvx CRM Assistant incluye un botón para copiar el mensaje.
   • Tenga en cuenta que el chat no mantiene un historial persistente; se reinicia con cada recarga de página, ya que está diseñado para asistencias puntuales.