WEBA — Orchestrateur IA

WEBA (Web-Enhanced Business Assistant) est l'orchestrateur IA central de la plateforme GoWeBa. Ce n'est pas un simple chatbot — c'est un système intelligent multi-agents qui coordonne 35 spécialistes IA pour accomplir des tâches complexes en langage naturel. WEBA fonctionne comme un chef d'orchestre numérique : l'utilisateur exprime son besoin en français, en anglais ou en espagnol, et WEBA identifie automatiquement l'intention, sélectionne le bon agent spécialisé, exécute l'action, et confirme le résultat — le tout en quelques secondes.

Philosophie : l'IA conversationnelle au service du business

Contrairement aux assistants IA génériques, WEBA est profondément intégré à votre CRM. Il a accès à vos contacts, votre calendrier, vos factures, vos tâches, vos documents et votre boutique. Il ne « devine » pas — il agit sur vos données réelles.

• Chat, Voix, SMS, Email — Multicanal : même identité sur tous les canaux
• Français, Anglais, Espagnol — Multilingue : détection automatique de la langue
• Mémoire organisationnelle — Contextuel : WEBA retient les préférences, les faits clés et les habitudes
• Traçabilité complète — Transparent : chaque action est loguée, chaque crédit est comptabilisé

Architecture multi-agents

WEBA utilise une architecture « hub-and-spoke » :

1. Hub central — Le moteur WEBA reçoit chaque message, analyse l'intention et route vers le bon agent
2. 35 agents spécialisés — Chaque agent est expert dans un domaine (CRM, facturation, calendrier, etc.)
3. Mémoire contextuelle — Le Knowledge Base + Context Entries fournissent la mémoire à long terme
4. Système de billing — Chaque appel IA est facturé via la Loi 1.40× (coût brut × 1.40)

Fonctionnalités principales

Chat conversationnel intelligent

L'interface principale de WEBA est un chat en temps réel avec streaming token par token. L'utilisateur écrit en langage naturel et reçoit une réponse structurée en quelques secondes.

.1 Interface utilisateur

• Zone de conversation avec historique complet
• Indicateur de frappe (animation pendant le streaming)
• Pièces jointes inline : documents PDF, événements, tâches, signatures
• Boutons d'action rapide sur les cartes de résultat
• Système de feedback (👍 / 👎) pour l'entraînement
• Gestion des conversations : créer, renommer, archiver, supprimer
• Dossiers de conversations : organiser par projet/client/thème

.2 Streaming SSE (Server-Sent Events)

La réponse de WEBA est diffusée en temps réel via un flux SSE avec les événements suivants :

.3 Gestion des conversations

Chaque conversation WEBA possède un cycle de vie complet :

Les conversations peuvent être organisées en dossiers avec couleurs personnalisées. Les dossiers permettent de regrouper par client, projet ou thème.

Détection automatique d'intentions

Avant de tomber dans le chat générique, le moteur WEBA essaie séquentiellement de détecter une intention spécialisée. Si aucune intention n'est détectée, WEBA répond en mode conversationnel standard. Voici l'ordre de priorité du routage des intentions :

1. Raffinement de document — Si un document est ouvert dans le Studio, WEBA détecte les demandes de modification (« change la taxe à 15% »)
2. Création de document PDF — Facture, devis ou rapport — WEBA extrait les données et génère le PDF automatiquement
3. Vérification de disponibilité — « Suis-je libre mardi ? » — WEBA consulte le calendrier et répond avec un résumé
4. Création d'événement calendrier — « Planifie une réunion avec Jean demain à 14h » — crée l'événement automatiquement
5. Création de tâche — « Rappelle-moi de facturer Acme vendredi » — crée la tâche avec priorité et échéance
6. Création de signature électronique — « Envoie le contrat de service à Marie pour signature » — crée l'enveloppe
7. Requête boutique — Questions sur les produits, commandes, inventaire — WEBA interroge la base produits
8. Chat général — Si aucune intention n'est détectée, WEBA répond en mode conversationnel enrichi par le Knowledge Base ⚠️ Chaque intention spécialisée déclenche un appel IA dédié. Le coût est facturé selon la Loi 1.40×.

Actions autonomes de WEBA

WEBA ne se contente pas de répondre — il agit. Voici les actions qu'il peut exécuter automatiquement :

Chaque action est loguée dans le journal d'audit (WebaAction) avec les inputs, outputs, statut (COMPLETED/FAILED) et horodatage.

Recherche sémantique universelle (⌘K)

GoWeBa intègre une recherche universelle accessible depuis n'importe quelle page via le raccourci ⌘K (Ctrl+K sur Windows).

• Contacts, emails, événements, tâches, documents — Recherche unifiée : tout est cherchable
• Question directe à WEBA — Recherche WEBA : tape une question en langage naturel
• Accès instantané — Navigation rapide : saute directement à la page souhaitée 💡 ⌘K est le raccourci le plus puissant de GoWeBa. Utilisez-le au lieu de naviguer manuellement dans les menus.

Pièces jointes intelligentes (Attachments)

Lorsque WEBA exécute une action, il attache le résultat au message sous forme de carte interactive :

Les 35 agents spécialisés WEBA

WEBA orchestre un écosystème de 35 agents IA spécialisés, chacun expert dans un domaine fonctionnel de la plateforme GoWeBa. Ces agents ne sont pas des chatbots séparés — ils partagent la même mémoire contextuelle, le même système de billing et la même identité de marque.

Mémoire et contexte

Prompt système dynamique

Chaque tour de conversation, WEBA construit un prompt système personnalisé qui inclut :

1. Identité WEBA — Nom, style de communication, tonalité, niveau de formalité
2. Contexte organisationnel — Nom de l'entreprise, devise par défaut, fuseau horaire
3. Contexte utilisateur — Nom, rôle système, style de communication préféré, langue
4. Mémoire à long terme — Entrées de contexte (USER, ORG, GLOBAL) triées par poids et récence
5. Knowledge Base — Top 3 résultats pertinents de la base de connaissances (recherche sémantique)
6. Historique récent — Les 20 derniers messages de la conversation active

Entrées de contexte (WebaContextEntry)

Les entrées de contexte permettent de stocker des faits que WEBA doit retenir :

Les entrées peuvent être épinglées (pinned) et pondérées (weight) pour contrôler leur priorité dans le prompt. Maximum 50 entrées sont injectées par tour. 💡 Utilisez les entrées de contexte pour « enseigner » à WEBA des faits spécifiques à votre entreprise. Par exemple : « Notre délai de livraison standard est de 3-5 jours ouvrables ».

Knowledge Base (Base de connaissances)

La Knowledge Base est le cerveau documentaire de WEBA. Elle stocke des articles, FAQ, procédures et guides qui sont automatiquement injectés dans le prompt quand pertinents.

.1 Catégories

.2 Algorithme de recherche

La recherche dans la Knowledge Base utilise un scoring multi-critères :

Score minimum requis : 1 point. Les 3 meilleurs résultats sont injectés dans le prompt système. Le contenu est tronqué à 900 caractères par article pour garder le prompt compact.

Persona et personnalisation white-label

Configuration de la persona

Chaque organisation peut personnaliser la personnalité de WEBA :

Styles de communication disponibles

Langues et détection automatique

WEBA répond dans la langue préférée de l'utilisateur (paramètre preferredLocale). Si l'utilisateur écrit dans une autre langue, WEBA s'adapte automatiquement.

Système de facturation WEBA

La Loi 1.40× (Crystal Billing)

Chaque appel IA effectué par WEBA est facturé selon un principe transparent : Prix utilisateur = Coût brut du fournisseur IA × 1.40 (marge de 40%) Cette marge couvre l'infrastructure GoWeBa, le stockage, le support et la R&D.

Mécanisme de débit

1. Vérification — Avant chaque appel IA, WEBA vérifie que le portefeuille a suffisamment de crédits (minimum 10 crédits)
2. Appel IA — L'appel est fait vers le modèle IA sélectionné (GPT-4.1, GPT-4.1-mini, etc.)
3. Calcul du coût — Tokens entrée × tarif entrée + Tokens sortie × tarif sortie = coût brut
4. Application de la marge — Coût brut × 1.40 = coût utilisateur
5. Débit — Les crédits sont déduits du portefeuille de l'utilisateur
6. Journalisation — UsageEvent créé avec détails complets (modèle, tokens, coût, action)

Conversion crédits / argent

10 crédits = 1 cent (CAD/USD). Donc 1 000 crédits = 1,00 $.

Budget guard

Lorsque le portefeuille de l'utilisateur est à zéro, WEBA refuse poliment de répondre : « Votre portefeuille de crédits est épuisé. Veuillez recharger vos crédits pour continuer à utiliser WEBA. Allez dans Paramètres → Abonnement pour ajouter des crédits. »

Escalade, sécurité et filtrage

Escalade automatique

WEBA peut automatiquement escalader une conversation vers un humain lorsque :

• Le score de confiance tombe sous le seuil configuré (défaut : 0.50)
• L'utilisateur demande explicitement à parler à un humain
• L'intention est classifiée comme « escalate_to_human »
• Le sentiment est très négatif (VERY_NEGATIVE) de façon répétée

.1 Processus d'escalade

1. Détection — WEBA identifie le besoin d'escalade via l'analyse d'intention
2. Marquage — La conversation est marquée isEscalated = true
3. Notification — Une escalation est créée (WebaEscalation) avec statut OPEN
4. Attribution — Un administrateur peut s'assigner l'escalade (ASSIGNED → IN_PROGRESS)
5. Résolution — L'admin résout et ferme l'escalade (RESOLVED → CLOSED)

Filtre de sortie (Egress Filter)

Avant de renvoyer une réponse à l'utilisateur, WEBA applique un filtre de sortie pour :

• Supprimer les références aux modèles IA sous-jacents (GPT-4, OpenAI, etc.)
• Bloquer la divulgation de données techniques internes
• Détecter et masquer les informations sensibles (numéros de carte, SIN, etc.)
• S'assurer que WEBA ne mentionne que la marque GoWeBa / nom de la persona ⚠️ Si le filtre détecte une violation, la réponse est bloquée et un log de sécurité est créé.

Guard interne (Internal Guard)

Le guard interne protège les endpoints API internes de WEBA :

• Vérifie que les appels proviennent de processus serveur autorisés
• Empêche l'accès direct aux routes /api/internal/weba/* depuis l'extérieur
• Valide les tokens de session à chaque tour de conversation

Analyse de sentiment & intention

Après chaque tour de conversation, WEBA effectue une analyse automatique :

Cette analyse utilise un appel GPT-4.1-mini léger (~0.14¢ par tour) en JSON strict.

Administration WEBA (pages admin)

Tableau de bord analytique

Accessible via Admin → WEBA → Analytics. Fournit des statistiques en temps réel :

Gestion des escalations

Accessible via Admin → WEBA → Escalations. Permet de :

• Voir toutes les escalations en attente, assignées et résolues
• S'attribuer une escalation pour la traiter
• Répondre directement dans la conversation escaladée
• Marquer comme résolu avec un commentaire de résolution
• Filtrer par statut, date, utilisateur

Knowledge Base (admin)

Accessible via Admin → WEBA → Knowledge. Interface complète pour gérer la base de connaissances :

1. Créer un article — Titre, contenu, catégorie, tags, mots-clés
2. Organiser — Catégoriser (GENERAL, PRODUCT, POLICY, FAQ, PROCEDURE, TROUBLESHOOTING)
3. Activer/désactiver — Les articles inactifs ne sont pas injectés dans le prompt
4. Statistiques — viewCount et lastUsedAt pour voir quels articles sont les plus consultés
5. Recherche — Recherche textuelle dans les articles 💡 Alimentez la Knowledge Base avec les questions que vos clients posent souvent. WEBA deviendra de plus en plus précis au fil du temps.

Entraînement (Training Data)

Accessible via Admin → WEBA → Training. Utilise les feedbacks 👍/👎 des utilisateurs :

• Feedbacks positifs : marqués comme « approuvés », servent de renforcement positif
• Feedbacks négatifs : analysés pour identifier les lacunes et améliorer les réponses
• Approbation manuelle : un admin peut approuver ou rejeter les données d'entraînement
• Export : les données d'entraînement peuvent être exportées pour fine-tuning futur

Gestion des phrases (Phrases)

Accessible via Admin → WEBA → Phrases. Permet de configurer des réponses prédéfinies :

• Réponses rapides : phrases courantes que WEBA doit utiliser telles quelles
• Corrections : remplacer systématiquement certaines formulations
• Termes interdits : mots ou phrases que WEBA ne doit jamais utiliser
• Vocabulaire métier : termes spécifiques à votre industrie avec définitions

Cas d'utilisation concrets

Scénario : Créer une facture par chat

Situation : Un utilisateur veut facturer un client après une consultation.

1. L'utilisateur écrit : — « Fais une facture de 500$ pour consultation 2h pour Acme Inc »
2. WEBA détecte l'intention — create_document, template: INVOICE
3. Extraction des données — Client: Acme Inc, Montant: 500$, Description: Consultation 2h
4. Génération du PDF — Document créé avec branding de l'organisation
5. Réponse avec pièce jointe — WEBA répond avec une carte inline montrant la facture
6. L'utilisateur clique — Ouvre le document dans le Studio pour révision finale

Scénario : Planifier un rendez-vous

1. L'utilisateur écrit : — « Planifie une réunion avec Jean-Pierre demain à 14h pendant 1 heure »
2. WEBA vérifie la disponibilité — Consulte le calendrier pour le créneau demandé
3. Création de l'événement — Titre: Réunion avec Jean-Pierre, 14h-15h, fuseau horaire de l'org
4. Notification — Les participants sont invités automatiquement
5. Confirmation — WEBA affiche une carte événement avec les détails

Scénario : Question sur un produit (Boutique)

1. Un client écrit via le chat web : — « Est-ce que vous avez le modèle XR-500 en stock ? »
2. WEBA détecte — Intent: store_query (mot-clé « stock », « modèle »)
3. Requête base produits — Recherche « XR-500 » dans le catalogue de l'organisation
4. Réponse contextualisée — « Oui, le XR-500 est disponible en bleu et noir. Prix : 299,99 $. Voulez-vous passer commande ? »

Scénario : Escalade automatique

1. Le client écrit : — « Je veux parler à un humain, votre bot ne comprend rien ! »
2. Classification — Intent: escalate_to_human, Sentiment: VERY_NEGATIVE
3. Escalade automatique — Conversation marquée isEscalated, escalation créée
4. Message WEBA — « Je comprends votre frustration. Je transfère votre conversation à un membre de notre équipe. »
5. Notification admin — L'administrateur reçoit une notification d'escalade urgente

Scénario : Raffinement de document existant

1. L'utilisateur ouvre une facture dans le Studio — Le client WEBA envoie activeDocumentId
2. L'utilisateur écrit : — « Change la taxe à 15% et ajoute une ligne pour les frais de déplacement 75$ »
3. WEBA détecte le raffinement — Le document est ouvert → priorité au refine path
4. Patch du document — Les données JSON du document sont mises à jour
5. Confirmation — WEBA affiche la carte document mise à jour avec le résumé des changements

Dépannage et FAQ

Problèmes fréquents

FAQ

Q : Combien coûte un message WEBA ? R : En moyenne, un message conversationnel coûte environ 7 crédits (~0.7¢). Les actions complexes (création de facture, résumé d'appel) coûtent entre 20 et 50 crédits. Q : WEBA peut-il accéder à mes emails ? R : WEBA peut composer des emails via la Webabox, mais il ne lit pas vos emails entrants sauf si vous lui demandez explicitement dans le contexte d'une conversation. Q : Comment améliorer les réponses de WEBA ? R : Trois leviers principaux :

1. Alimentez la Knowledge Base avec les FAQ de votre entreprise
2. Utilisez les feedbacks 👍/👎 pour entraîner WEBA
3. Ajoutez des entrées de contexte avec les faits importants Q : WEBA fonctionne-t-il hors ligne ? R : Non. WEBA nécessite une connexion internet pour communiquer avec les modèles IA. En cas de panne, les conversations sont mises en file d'attente et traitées dès le retour de la connexion. Q : Peut-on personnaliser le nom et l'apparence de WEBA ? R : Oui, via la configuration de la Persona (Admin → WEBA). Vous pouvez changer le nom, les couleurs, le style de communication, le message d'accueil et même l'avatar. Q : WEBA est-il conforme au RGPD et à la Loi 25 ? R : Oui. Toutes les données sont hébergées au Canada. Le filtre de sortie empêche la divulgation de données sensibles. Les conversations peuvent être supprimées sur demande (droit à l'oubli). Q : Combien d'agents WEBA peut-on utiliser simultanément ? R : Les 35 agents sont toujours disponibles. WEBA sélectionne automatiquement le bon agent. Il n'y a pas de limite de concurrence — chaque utilisateur a son propre contexte de conversation. Q : Que se passe-t-il si WEBA se trompe ? R : Utilisez le bouton 👎 pour signaler une mauvaise réponse. L'admin peut ensuite corriger via la page Training. WEBA apprend continuellement de ces feedbacks.

Limites connues

— Fin du Module 01 —

GoWeBa — Bible des Opérations Document généré le 06 May 2026