WEBA — Orquestador IA

WEBA (Web-Enhanced Business Assistant) es el orquestador IA central de la plataforma GoWeBa. No es un simple chatbot — es un sistema inteligente multi-agentes que coordina 35 especialistas IA para realizar tareas complejas en lenguaje natural. WEBA funciona como un director de orquesta digital: el usuario expresa su necesidad en francés, inglés o español, y WEBA identifica automáticamente la intención, selecciona el agente especializado correcto, ejecuta la acción y confirma el resultado — todo en pocos segundos.

Filosofía: la IA conversacional al servicio del negocio

A diferencia de los asistentes IA genéricos, WEBA está profundamente integrado a tu CRM. Tiene acceso a tus contactos, tu calendario, tus facturas, tus tareas, tus documentos y tu tienda. No «adivina» — actúa sobre tus datos reales.

• Chat, Voz, SMS, Email — Multicanal: misma identidad en todos los canales
• Francés, Inglés, Español — Multilingüe: detección automática del idioma
• Memoria organizacional — Contextual: WEBA retiene las preferencias, los hechos clave y los hábitos
• Trazabilidad completa — Transparente: cada acción se registra, cada crédito se contabiliza

Arquitectura multi-agentes

WEBA utiliza una arquitectura «hub-and-spoke»:

1. Hub central — El motor WEBA recibe cada mensaje, analiza la intención y enruta hacia el agente correcto
2. 35 agentes especializados — Cada agente es experto en un dominio (CRM, facturación, calendario, etc.)
3. Memoria contextual — La Knowledge Base + Context Entries proporcionan la memoria a largo plazo
4. Sistema de billing — Cada llamada IA se factura según la Ley 1.40× (costo bruto × 1.40)

Funcionalidades principales

Chat conversacional inteligente

La interfaz principal de WEBA es un chat en tiempo real con streaming token por token. El usuario escribe en lenguaje natural y recibe una respuesta estructurada en pocos segundos.

.1 Interfaz de usuario

• Zona de conversación con historial completo
• Indicador de escritura (animación durante el streaming)
• Adjuntos inline: documentos PDF, eventos, tareas, firmas
• Botones de acción rápida en las tarjetas de resultado
• Sistema de feedback (👍 / 👎) para el entrenamiento
• Gestión de conversaciones: crear, renombrar, archivar, eliminar
• Carpetas de conversaciones: organizar por proyecto/cliente/tema

.2 Streaming SSE (Server-Sent Events)

La respuesta de WEBA se difunde en tiempo real vía un flujo SSE con los siguientes eventos:

.3 Gestión de conversaciones

Cada conversación WEBA posee un ciclo de vida completo:

Las conversaciones pueden ser organizadas en carpetas con colores personalizados. Las carpetas permiten agrupar por cliente, proyecto o tema.

Detección automática de intenciones

Antes de caer en el chat genérico, el motor WEBA intenta secuencialmente detectar una intención especializada. Si ninguna intención es detectada, WEBA responde en modo conversacional estándar. Aquí está el orden de prioridad del enrutamiento de intenciones:

1. Refinamiento de documento — Si un documento está abierto en el Studio, WEBA detecta las solicitudes de modificación (« cambia el impuesto a 15% »)
2. Creación de documento PDF — Factura, presupuesto o informe — WEBA extrae los datos y genera el PDF automáticamente
3. Verificación de disponibilidad — « ¿Estoy libre el martes? » — WEBA consulta el calendario y responde con un resumen
4. Creación de evento de calendario — « Planifica una reunión con Jean mañana a las 14h » — crea el evento automáticamente
5. Creación de tarea — « Recuérdame facturar a Acme el viernes » — crea la tarea con prioridad y vencimiento
6. Creación de firma electrónica — « Envía el contrato de servicio a Marie para firma » — crea el sobre
7. Consulta de tienda — Preguntas sobre productos, pedidos, inventario — WEBA consulta la base de productos
8. Chat general — Si ninguna intención es detectada, WEBA responde en modo conversacional enriquecido por la Knowledge Base ⚠️ Cada intención especializada desencadena una llamada IA dedicada. El costo se factura según la Ley 1.40×.

Acciones autónomas de WEBA

WEBA no se limita a responder — actúa. Estas son las acciones que puede ejecutar automáticamente:

Cada acción se registra en el diario de auditoría (WebaAction) con los inputs, outputs, estado (COMPLETED/FAILED) y marca temporal.

Búsqueda semántica universal (⌘K)

GoWeBa integra una búsqueda universal accesible desde cualquier página vía el atajo ⌘K (Ctrl+K en Windows).

• Contactos, emails, eventos, tareas, documentos — Búsqueda unificada: todo es buscable
• Pregunta directa a WEBA — Búsqueda WEBA: escribe una pregunta en lenguaje natural
• Acceso instantáneo — Navegación rápida: salta directamente a la página deseada 💡 ⌘K es el atajo más poderoso de GoWeBa. Úsalo en lugar de navegar manualmente por los menús.

Adjuntos inteligentes (Attachments)

Cuando WEBA ejecuta una acción, adjunta el resultado al mensaje en forma de tarjeta interactiva:

Los 35 agentes especializados WEBA

WEBA orquesta un ecosistema de 35 agentes IA especializados, cada uno experto en un dominio funcional de la plataforma GoWeBa. Estos agentes no son chatbots separados — comparten la misma memoria contextual, el mismo sistema de billing y la misma identidad de marca.

Memoria y contexto

Prompt del sistema dinámico

En cada turno de conversación, WEBA construye un prompt del sistema personalizado que incluye:

1. Identidad WEBA — Nombre, estilo de comunicación, tonalidad, nivel de formalidad
2. Contexto organizacional — Nombre de la empresa, moneda predeterminada, huso horario
3. Contexto del usuario — Nombre, rol del sistema, estilo de comunicación preferido, idioma
4. Memoria a largo plazo — Entradas de contexto (USER, ORG, GLOBAL) ordenadas por peso y recencia
5. Knowledge Base — Top 3 resultados relevantes de la base de conocimientos (búsqueda semántica)
6. Historial reciente — Los 20 últimos mensajes de la conversación activa

Entradas de contexto (WebaContextEntry)

Las entradas de contexto permiten almacenar hechos que WEBA debe retener:

Las entradas pueden ser fijadas (pinned) y ponderadas (weight) para controlar su prioridad en el prompt. Máximo 50 entradas se inyectan por turno. 💡 Usa las entradas de contexto para «enseñar» a WEBA hechos específicos de tu empresa. Por ejemplo: « Nuestro plazo de entrega estándar es de 3-5 días hábiles ».

Knowledge Base (Base de conocimientos)

La Knowledge Base es el cerebro documental de WEBA. Almacena artículos, FAQ, procedimientos y guías que se inyectan automáticamente en el prompt cuando son relevantes.

.1 Categorías

.2 Algoritmo de búsqueda

La búsqueda en la Knowledge Base utiliza un scoring multi-criterios:

Puntuación mínima requerida: 1 punto. Los 3 mejores resultados se inyectan en el prompt del sistema. El contenido se trunca a 900 caracteres por artículo para mantener el prompt compacto.

Persona y personalización white-label

Configuración de la persona

Cada organización puede personalizar la personalidad de WEBA:

Estilos de comunicación disponibles

Idiomas y detección automática

WEBA responde en el idioma preferido del usuario (parámetro preferredLocale). Si el usuario escribe en otro idioma, WEBA se adapta automáticamente.

Sistema de facturación WEBA

La Ley 1.40× (Crystal Billing)

Cada llamada IA realizada por WEBA se factura según un principio transparente: Precio usuario = Costo bruto del proveedor IA × 1.40 (margen del 40%) Este margen cubre la infraestructura GoWeBa, el almacenamiento, el soporte y la I+D.

Mecanismo de débito

1. Verificación — Antes de cada llamada IA, WEBA verifica que el monedero tenga suficientes créditos (mínimo 10 créditos)
2. Llamada IA — La llamada se realiza al modelo IA seleccionado (GPT-4.1, GPT-4.1-mini, etc.)
3. Cálculo del costo — Tokens entrada × tarifa entrada + Tokens salida × tarifa salida = costo bruto
4. Aplicación del margen — Costo bruto × 1.40 = costo usuario
5. Débito — Los créditos se deducen del monedero del usuario
6. Registro — UsageEvent creado con detalles completos (modelo, tokens, costo, acción)

Conversión créditos / dinero

10 créditos = 1 centavo (CAD/USD). Por lo tanto, 1,000 créditos = 1.00 $.

Budget guard

Cuando el monedero del usuario está en cero, WEBA rechaza amablemente responder: « Tu monedero de créditos está agotado. Por favor recarga tus créditos para continuar usando WEBA. Ve a Configuración → Suscripción para agregar créditos. »

Escalamiento, seguridad y filtrado

Escalamiento automático

WEBA puede escalar automáticamente una conversación hacia un humano cuando:

• La puntuación de confianza cae por debajo del umbral configurado (predeterminado: 0.50)
• El usuario pide explícitamente hablar con un humano
• La intención se clasifica como «escalate_to_human»
• El sentimiento es muy negativo (VERY_NEGATIVE) de forma repetida

.1 Proceso de escalamiento

1. Detección — WEBA identifica la necesidad de escalamiento vía el análisis de intención
2. Marcado — La conversación se marca isEscalated = true
3. Notificación — Se crea una escalación (WebaEscalation) con estado OPEN
4. Asignación — Un administrador puede asignarse la escalación (ASSIGNED → IN_PROGRESS)
5. Resolución — El admin resuelve y cierra la escalación (RESOLVED → CLOSED)

Filtro de salida (Egress Filter)

Antes de devolver una respuesta al usuario, WEBA aplica un filtro de salida para:

• Eliminar las referencias a los modelos IA subyacentes (GPT-4, OpenAI, etc.)
• Bloquear la divulgación de datos técnicos internos
• Detectar y enmascarar información sensible (números de tarjeta, SIN, etc.)
• Asegurarse de que WEBA solo mencione la marca GoWeBa / nombre de la persona ⚠️ Si el filtro detecta una violación, la respuesta se bloquea y se crea un registro de seguridad.

Guard interno (Internal Guard)

El guard interno protege los endpoints API internos de WEBA:

• Verifica que las llamadas provengan de procesos de servidor autorizados
• Impide el acceso directo a las rutas /api/internal/weba/* desde el exterior
• Valida los tokens de sesión en cada turno de conversación

Análisis de sentimiento e intención

Después de cada turno de conversación, WEBA realiza un análisis automático:

Este análisis utiliza una llamada GPT-4.1-mini ligera (~0.14¢ por turno) en JSON estricto.

Administración WEBA (páginas admin)

Panel de analytics

Accesible vía Admin → WEBA → Analytics. Proporciona estadísticas en tiempo real:

Gestión de escalaciones

Accesible vía Admin → WEBA → Escalaciones. Permite:

• Ver todas las escalaciones en espera, asignadas y resueltas
• Asignarse una escalación para tratarla
• Responder directamente en la conversación escalada
• Marcar como resuelto con un comentario de resolución
• Filtrar por estado, fecha, usuario

Knowledge Base (admin)

Accesible vía Admin → WEBA → Knowledge. Interfaz completa para gestionar la base de conocimientos:

1. Crear un artículo — Título, contenido, categoría, tags, palabras clave
2. Organizar — Categorizar (GENERAL, PRODUCT, POLICY, FAQ, PROCEDURE, TROUBLESHOOTING)
3. Activar/desactivar — Los artículos inactivos no se inyectan en el prompt
4. Estadísticas — viewCount y lastUsedAt para ver qué artículos son los más consultados
5. Búsqueda — Búsqueda textual en los artículos 💡 Alimenta la Knowledge Base con las preguntas que tus clientes hacen frecuentemente. WEBA se volverá cada vez más preciso con el tiempo.

Entrenamiento (Training Data)

Accesible vía Admin → WEBA → Training. Utiliza los feedbacks 👍/👎 de los usuarios:

• Feedbacks positivos: marcados como «aprobados», sirven de refuerzo positivo
• Feedbacks negativos: analizados para identificar las carencias y mejorar las respuestas
• Aprobación manual: un admin puede aprobar o rechazar los datos de entrenamiento
• Exportación: los datos de entrenamiento pueden ser exportados para fine-tuning futuro

Gestión de frases (Phrases)

Accesible vía Admin → WEBA → Phrases. Permite configurar respuestas predefinidas:

• Respuestas rápidas: frases comunes que WEBA debe usar tal cual
• Correcciones: reemplazar sistemáticamente ciertas formulaciones
• Términos prohibidos: palabras o frases que WEBA nunca debe usar
• Vocabulario de negocio: términos específicos de tu industria con definiciones

Casos de uso concretos

Escenario: Crear una factura por chat

Situación: Un usuario quiere facturar a un cliente después de una consulta.

1. El usuario escribe: — « Haz una factura de 500$ por consulta 2h para Acme Inc »
2. WEBA detecta la intención — create_document, template: INVOICE
3. Extracción de datos — Cliente: Acme Inc, Monto: 500$, Descripción: Consulta 2h
4. Generación del PDF — Documento creado con branding de la organización
5. Respuesta con adjunto — WEBA responde con una tarjeta inline mostrando la factura
6. El usuario hace clic — Abre el documento en el Studio para revisión final

Escenario: Planificar una cita

1. El usuario escribe: — « Planifica una reunión con Jean-Pierre mañana a las 14h durante 1 hora »
2. WEBA verifica la disponibilidad — Consulta el calendario para la franja solicitada
3. Creación del evento — Título: Reunión con Jean-Pierre, 14h-15h, huso horario de la org
4. Notificación — Los participantes son invitados automáticamente
5. Confirmación — WEBA muestra una tarjeta de evento con los detalles

Escenario: Pregunta sobre un producto (Tienda)

1. Un cliente escribe vía el chat web: — « ¿Tienen el modelo XR-500 en stock? »
2. WEBA detecta — Intent: store_query (palabra clave «stock», «modelo»)
3. Consulta base de productos — Búsqueda « XR-500 » en el catálogo de la organización
4. Respuesta contextualizada — « Sí, el XR-500 está disponible en azul y negro. Precio: 299.99 $. ¿Desea hacer un pedido? »

Escenario: Escalamiento automático

1. El cliente escribe: — « Quiero hablar con un humano, ¡su bot no entiende nada! »
2. Clasificación — Intent: escalate_to_human, Sentimiento: VERY_NEGATIVE
3. Escalamiento automático — Conversación marcada isEscalated, escalación creada
4. Mensaje WEBA — « Entiendo su frustración. Transfiero su conversación a un miembro de nuestro equipo. »
5. Notificación admin — El administrador recibe una notificación de escalación urgente

Escenario: Refinamiento de documento existente

1. El usuario abre una factura en el Studio — El cliente WEBA envía activeDocumentId
2. El usuario escribe: — « Cambia el impuesto a 15% y agrega una línea para los gastos de desplazamiento 75$ »
3. WEBA detecta el refinamiento — El documento está abierto → prioridad al refine path
4. Patch del documento — Los datos JSON del documento se actualizan
5. Confirmación — WEBA muestra la tarjeta de documento actualizada con el resumen de cambios

Solución de problemas y FAQ

Problemas frecuentes

FAQ

P: ¿Cuánto cuesta un mensaje WEBA? R: En promedio, un mensaje conversacional cuesta aproximadamente 7 créditos (~0.7¢). Las acciones complejas (creación de factura, resumen de llamada) cuestan entre 20 y 50 créditos. P: ¿WEBA puede acceder a mis emails? R: WEBA puede componer emails vía la Webabox, pero no lee tus emails entrantes a menos que se lo pidas explícitamente en el contexto de una conversación. P: ¿Cómo mejorar las respuestas de WEBA? R: Tres palancas principales:

1. Alimenta la Knowledge Base con las FAQ de tu empresa
2. Usa los feedbacks 👍/👎 para entrenar a WEBA
3. Agrega entradas de contexto con los hechos importantes P: ¿WEBA funciona sin conexión? R: No. WEBA necesita una conexión a internet para comunicarse con los modelos IA. En caso de falla, las conversaciones se ponen en cola y se procesan cuando se restablece la conexión. P: ¿Se puede personalizar el nombre y la apariencia de WEBA? R: Sí, vía la configuración de la Persona (Admin → WEBA). Puedes cambiar el nombre, los colores, el estilo de comunicación, el mensaje de bienvenida e incluso el avatar. P: ¿WEBA es conforme al RGPD y a la Ley 25? R: Sí. Todos los datos se alojan en Canadá. El filtro de salida impide la divulgación de datos sensibles. Las conversaciones pueden ser eliminadas bajo solicitud (derecho al olvido). P: ¿Cuántos agentes WEBA se pueden usar simultáneamente? R: Los 35 agentes están siempre disponibles. WEBA selecciona automáticamente el agente correcto. No hay límite de concurrencia — cada usuario tiene su propio contexto de conversación. P: ¿Qué pasa si WEBA se equivoca? R: Usa el botón 👎 para reportar una mala respuesta. El admin puede luego corregir vía la página Training. WEBA aprende continuamente de estos feedbacks.

Límites conocidos

— Fin del Módulo 01 —

GoWeBa — Biblia de Operaciones Documento generado el 06 May 2026