Cómo usar el componente "NLP Q&A" de wolkvox Studio
Table of Contents
Introducción
El componente NLP Q&A de wolkvox Studio te permite incorporar un bot con Inteligencia Artificial que responde preguntas del cliente con base en un entrenamiento obligatorio (temas y contexto definidos por tu operación). Este componente hace parte del grupo “Cognitivos” y está disponible en los tipos de routing Voice, Interaction, Chat y CRM + Webhook.
NLP Q&A no responde por sí solo al usuario final: su resultado se guarda en una variable (por defecto $nlp_QA) y debes usar un componente de salida (por ejemplo Responder chat) para mostrar esa respuesta al cliente.
Configuración
- Agrega el componente en tu diagrama y abre el panel de configuración dando doble clic izquierdo.
- En el panel de configuración debes hacer lo siguiente:
- Carga una plantilla o crea una nueva: En la parte superior del panel, encontrarás el selector de plantilla (por ejemplo, default) y el botón “Cargar plantilla”.
- Para usar una existente, selecciónala y haz clic en “Cargar plantilla”.
- Para crear una nueva, escribe el nombre de la plantilla en el campo correspondiente y ejecútala con el botón de carga de plantilla. La idea es dejar una plantilla activa para empezar a entrenar.
- Entrena el bot desde la pestaña “Configuración”.
- En “Título”, escribe el nombre del tema (por ejemplo: “Políticas de garantías”, “Horarios de atención”, “Estados de pedido”).
- En “Texto de entrenamiento”, pega el contenido completo que el bot debe aprender para ese tema.
- Límite por ítem: hasta 2000 caracteres (los espacios cuentan como caracter).
- Recomendación operativa: este campo no es compatible con tildes, por lo que debes redactar el texto sin acentos.
- Haz clic en “Agregar” para guardar el entrenamiento.
- Verifica que el ítem quede listado en la tabla (verás columnas como Plantilla, Título y Contexto).
- Si necesitas ajustar un ítem, haz clic derecho sobre el registro en la tabla y usa “Editar ítem” o “Borrar ítem”.
- Revisa el indicador de “Texto total plantilla”, donde se muestra el consumo de caracteres de la plantilla frente al máximo permitido: 10.000 caracteres por plantilla.
- Carga una plantilla o crea una nueva: En la parte superior del panel, encontrarás el selector de plantilla (por ejemplo, default) y el botón “Cargar plantilla”.

Prueba el bot en la pestaña “Preguntas y respuestas” (obligatorio). Esta validación es indispensable: si no pruebas el bot, el sistema no permitirá guardar la configuración del componente.
- En “Pregunta”, escribe una pregunta real que haría un cliente.
- Haz clic en “Test”.
- En “Resultado”, valida que la respuesta sea coherente con el entrenamiento cargado.
- Confirma la “Variable de respuesta”: el componente guarda la respuesta en $nlp_QA (esta variable no se puede cambiar).
- Luego de ejecutar el Test y validar el Resultado, haz clic en “Guardar” para aplicar los cambios.

Recuerda: NLP Q&A genera la respuesta, pero no la envía.
- Agrega un componente de salida, por ejemplo “Responder chat”.
- En el mensaje de salida, inserta la variable $nlp_QA para que el cliente vea el texto generado.
