Brain es el corazón de la inteligencia conversacional en Jelou. Aquí se crean, personalizan y entrenan los Agentes AI que interactúan con tus usuarios. Este glosario te servirá para entender cada parte del sistema, especialmente si estás comenzando o si quieres usar todo el potencial de tu bot.
📚 1. Brains, Skills y Nodos: la estructura de tu Agente AI
🔹 Brain
Un Brain es el contenedor general de tu agente AI. Es donde vive toda la lógica de conversación, flujos y configuraciones.
Piensa en él como el “cerebro” de tu bot. Puede tener múltiples Skills, conectarse a canales y almacenar datos.
🔹 Skills
Son los flujos conversacionales que definen cómo responde tu bot ante ciertas preguntas o eventos.
Puedes tener Skills para responder FAQs, guiar una compra, hacer un onboarding o validar identidad.
Se activan por intenciones o disparadores que configures.
Ejemplo: Un Skill llamado “Solicitar factura” puede activarse cuando el usuario escribe "quiero mi factura".
🔹 Nodos
Son los bloques de construcción dentro de una Skill. Cada nodo realiza una acción específica:
Texto: Muestra un mensaje al usuario.
Pregunta: Solicita una respuesta (y puede validarla).
Imagen / Audio / Video / Documento: Envían archivos multimedia.
Contacto / Ubicación: Solicitan datos del usuario.
Condicional / Decisión: Cambia el flujo según reglas.
Tool: Ejecuta funciones como enviar OTP, leer datos, generar códigos, etc.
⚙️ 2. Tools: las funciones inteligentes dentro del flujo
Los Tools permiten agregar comportamientos complejos sin necesidad de programación.
Algunos ejemplos útiles:
OTP: Genera y valida códigos para autenticar usuarios.
Knowledge: Consulta respuestas a partir de un mini FAQ estructurado.
Webhook / API: Llama servicios externos para consultar, guardar o enviar datos.
Variables: Guardan datos dentro del flujo (como nombre, correo, selección de producto).
💡 Puedes reutilizar Tools en distintos nodos y Skills, lo que te permite escalar sin duplicar trabajo.
🔍 3. Intenciones, Palabras clave y Disparadores
🔹 Intención
Es lo que el bot interpreta que el usuario quiere hacer.
Ejemplo: Si el usuario escribe "necesito ayuda con mi pago", la intención puede ser “Problema con pago”.
Las intenciones se entrenan con ejemplos y se conectan a una Skill específica.
🔹 Palabras clave
Son términos específicos que activan Skills o flujos. Se configuran manualmente. A diferencia de las intenciones, no requieren entrenamiento.
Ejemplo: La palabra clave “menú” activa la Skill principal.
🔹 Disparadores (Triggers)
Son eventos automáticos que inician un flujo, como:
Primer mensaje del usuario.
Hora específica del día.
Respuesta a un mensaje anterior.
Evento externo vía API.
🧩 4. Variables, Validaciones y Contexto
🔹 Variables
Permiten guardar y reutilizar información en la conversación.
Ejemplo: guardar el nombre del usuario y luego usarlo para saludarlo automáticamente.
textCopiarEditarHola {{nombre}}, ¿cómo podemos ayudarte hoy?
🔹 Validaciones
Se usan en nodos de tipo Pregunta para asegurarse de que la respuesta cumpla ciertos requisitos (como que sea un correo, un número, una fecha, etc.).
Puedes usar validaciones prediseñadas o personalizadas con expresiones regulares.
🔹 Contexto del flujo
Puedes definir qué debe saber el bot antes de responder. Esto incluye el orden lógico de las Skills, la persistencia de datos, y las condiciones que deben cumplirse para avanzar en el flujo.
🧠 5. AI Tasks: tareas generativas con IA avanzada
Las AI Tasks son flujos automatizados que se apoyan en modelos de IA generativa (como GPT-4). Se usan para tareas como:
Generar textos personalizados.
Responder de forma creativa o extensa.
Procesar y clasificar información ingresada por el usuario.
Estas tareas pueden combinarse con otros Tools para lograr funciones más complejas.
🧪 6. Pruebas, Versiones y Logs
🔹 Modo prueba
Te permite simular el comportamiento del bot antes de activarlo para usuarios reales.
Puedes revisar cómo se activan Skills, si las variables se están guardando bien, y si hay errores.
🔹 Versionado
Cada cambio importante en tu Brain puede guardarse como una versión. Así puedes regresar a un punto anterior si algo falla.
🔹 Logs
Muestran el historial de interacciones, errores, y decisiones que tomó el bot. Es útil para debuggear o entender cómo se comportó en una conversación específica.
El módulo Brain te permite construir agentes AI conversacionales potentes y personalizados sin necesidad de saber programar.
Este glosario es tu mapa para entender cómo encajan todas las piezas: desde los nodos que componen un flujo, hasta las tareas generativas con IA.