Architecture
WivenLLM se compose de trois services qui coopèrent, et de briques interchangeables branchées sur le service principal. Cette page décrit l'ensemble sans entrer dans le détail du code.
Les trois services
┌──────────────┐ ┌──────────────────────────┐ ┌────────────────────────┐
│ Interface │─────▶│ Serveur │─────▶│ Service d'extraction │
│ (navigateur │◀─────│ API · orchestration IA │◀─────│ texte des fichiers │
│ ou appli) │ │ base · sécurité │ │ et des URL │
└──────────────┘ └───────────┬──────────────┘ └────────────────────────┘
│
┌───────────────────┼───────────────────┐
▼ ▼ ▼
┌───────────┐ ┌────────────┐ ┌─────────────┐
│ Modèles │ │ Embeddings │ │ Base │
│ LLM │ │ │ │ vectorielle │
└───────────┘ └────────────┘ └─────────────┘
Interface
L'application que vous utilisez : espaces de travail, conversations, documents, écrans d'administration. Elle s'exécute dans un navigateur, ou dans l'application de bureau qui l'embarque. Elle ne parle qu'au serveur.
Serveur
Le cœur du produit. Il porte :
- l'API consommée par l'interface, le widget web, l'application mobile, l'extension de navigateur et les intégrations tierces ;
- l'authentification et les rôles ;
- l'orchestration IA : choix du fournisseur, recherche vectorielle, construction du contexte, exécution des agents ;
- la base de données (espaces, conversations, utilisateurs, réglages) ;
- les traitements de fond : indexation, extraction de mémoires, consolidation du Second Brain, tâches planifiées.
Sur le poste de travail, le serveur démarre aussi les agents autonomes Audit SEO et Prospection. La configuration serveur fournie les désactive.
Service d'extraction
Un service dédié à une seule chose : transformer un fichier ou une URL en texte exploitable. PDF, Word, tableurs, présentations, e-mails, livres numériques, images (reconnaissance de caractères), audio et vidéo (transcription), pages web, dépôts de code, wikis d'entreprise.
Le séparer du serveur a un intérêt concret : un document lourd ou un PDF mal formé est traité dans un processus à part, et son échec n'interrompt pas vos conversations.
Les briques interchangeables
Trois familles de composants sont choisies par l'administrateur et remplaçables sans toucher au reste :
| Brique | Rôle | Par défaut |
|---|---|---|
| Modèle de langage (LLM) | Rédige les réponses, pilote les agents | À choisir à l'onboarding — modèle local possible |
| Moteur d'embeddings | Traduit le texte en vecteurs comparables | Moteur intégré, exécuté localement |
| Base vectorielle | Stocke les vecteurs et retrouve les passages proches | Base locale intégrée, stockée sur disque |
Deux familles s'y ajoutent, optionnelles : la génération d'images et de vidéos, et la synthèse / reconnaissance vocale.
Le trajet d'un document
- Dépôt. Vous déposez un fichier dans le gestionnaire de documents d'un espace de travail, ou vous fournissez une URL.
- Extraction. Le service d'extraction identifie le format, en extrait le texte et les métadonnées (titre, source, date, auteur quand ils existent).
- Mise à disposition. Le texte extrait est enregistré comme document disponible. Il n'est pas encore interrogeable.
- Découpage. À l'ajout dans un espace, le texte est découpé en fragments de taille configurable, avec un recouvrement entre fragments pour ne pas casser les phrases à cheval.
- Vectorisation. Chaque fragment est transformé en vecteur par le moteur d'embeddings.
- Indexation. Les vecteurs sont écrits dans la base vectorielle, dans un espace de noms propre à l'espace de travail.
Le document est alors interrogeable. Un même document peut être ajouté à plusieurs espaces de travail : il n'est extrait qu'une fois, mais indexé dans chacun.
Un fichier déposé directement dans la conversation suit un autre chemin : il est joint à cette conversation comme contexte, sans passer par l'index de l'espace.
Le trajet d'une question
- Envoi. Vous écrivez une question dans une conversation. Si le contrôle du contenu est activé, ses règles s'appliquent à ce moment.
- Commandes. Si le message commence par une commande (/reset, /image ou /img, /video, /note, ou une commande que vous avez définie), elle est traitée avant tout le reste.
- Mode agent. Si le message commence par @agent, ou si l'espace est en mode de chat Agent et que le modèle sait appeler des outils, la main passe à l'agent et le déroulé devient celui des agents.
- Recherche. Votre question est vectorisée, puis comparée aux fragments de l'espace. Les plus proches sont retenus, dans la limite du nombre de résultats et du seuil de similarité configurés.
- Construction du contexte. Le serveur assemble : le prompt système de l'espace, les documents épinglés, les fragments retrouvés, vos mémoires (si elles sont activées) et éléments pertinents de Second Brain, puis les derniers messages de la conversation.
- Génération. L'ensemble est envoyé au modèle, qui répond en flux continu — le texte s'affiche au fil de sa production. Si le bouclier PII est activé, les données personnelles sont remplacées par des pseudonymes avant l'envoi, puis rétablies dans la réponse.
- Restitution. La réponse est enregistrée dans l'historique avec ses sources, affichées sous le message.
Où sont stockées les données
Tout ce que produit une installation vit dans un répertoire de stockage unique :
- la base de données de l'application ;
- les documents extraits ;
- les index vectoriels, lorsque la base vectorielle est locale ;
- les modèles téléchargés, lorsque vous exécutez des modèles en local ;
- les fichiers produits par les agents ;
- le journal d'audit et le registre des sorties réseau.
Sauvegarder une installation revient donc à sauvegarder ce répertoire et le fichier de configuration avec ses secrets, application arrêtée : la copie d'une base en cours d'utilisation peut être inutilisable. Sans ces secrets, les clés de fournisseurs enregistrées deviennent illisibles.
Ce qui sort du réseau, et quand
| Situation | Sortie réseau |
|---|---|
| Modèle local, embeddings natifs, base vectorielle locale | Aucune pour vos messages et vos documents |
| Fournisseur de modèle externe | Les messages et le contexte partent chez ce fournisseur |
| Base vectorielle hébergée | Les vecteurs et métadonnées partent chez cet hébergeur |
| Compétence d'agent « recherche web » (à activer) | La requête part chez le moteur de recherche choisi |
| Import d'une URL ou d'un dépôt | Requête vers l'adresse demandée |
| Téléchargement d'un modèle local | Une fois, au téléchargement |
| Moteur d'embeddings intégré | Une fois, au premier import de document (environ 90 Mo) |
| Application de bureau | Vérification des mises à jour au lancement puis toutes les 6 heures, sauf en mode souverain Strict |
| Télémétrie anonyme | Aucune, sauf si un administrateur l'active |
La page Confidentialité et données, en bas du menu des réglages, indique le fournisseur de modèle, le moteur d'embeddings et la base vectorielle de votre instance. Les sorties effectives se lisent dans Console Wiven → Mode souverain :
- Surveillance, le réglage par défaut, enregistre chaque connexion externe (hôte, adresse, port, jamais le contenu) et ne bloque rien ;
- Strict bloque tout ce qui n'est pas sur la liste blanche ; la configuration serveur fournie applique ce réglage. Pensez à y autoriser ce dont vous avez besoin, comme le téléchargement d'un modèle ou la connexion à Outlook (voir Installation) ;
- Désactivé ne contrôle ni n'enregistre rien.
Ce contrôle porte sur les connexions sortantes du serveur et du service d'extraction.
Gouvernance, conformité et intégration métier
Les services décrits plus haut définissent où s'exécutent les traitements. Quatre couches s'y ajoutent, et ce sont elles qui font la différence en exploitation.
Rôles de gouvernance
Trois niveaux de rôle, en mode multi-utilisateurs (licence WivenLLM Business) : administrateur, gestionnaire, utilisateur. S'y ajoutent les invités, si l'accès invité est activé, et deux rôles dans une organisation : administrateur de l'organisation et membre.
Les comptes sont locaux par défaut. L'authentification peut passer par l'annuaire d'entreprise existant : authentification unique (Microsoft, Google, OIDC), Active Directory, et groupes Entra qui décident qui se connecte, avec quel rôle et où.
Chaque rôle ouvre un périmètre distinct d'espaces de travail, de documents et de réglages. Administrateurs et gestionnaires voient tous les espaces, sauf ceux qu'une muraille leur ferme (Console Wiven → Murailles).
Traçabilité et nLPD
WivenLLM ne génère pas de registre de traitement : il fournit des éléments pour le tenir. Le journal d'audit est horodaté, nominatif en mode multi-utilisateurs, et exportable en CSV ou JSONL. Le mode souverain produit un rapport mensuel signé des sorties réseau. Les solutions sont conçues pour la nLPD ; la conformité d'un traitement dépend aussi des finalités et du registre du client, et Wiven accompagne sur ce point plutôt que de la garantir à sa place.
Périmètre d'agent
Un agent travaille dans l'espace de travail où vous l'appelez et interroge les documents de cet espace. Ses compétences sont activées pour toute l'instance par un administrateur, et non agent par agent. Certaines dépassent l'espace : la recherche de conversations et le Second Brain portent sur vos données dans tous vos espaces. Les compétences de messagerie et d'agenda n'utilisent que les comptes de la personne qui demande, et l'envoi, la réponse ou la suppression d'un e-mail demandent confirmation à chaque fois.
Le client décide de ce qui sort de ce périmètre : en mode souverain Surveillance ou Strict, les connexions externes couvertes par le contrôle sont journalisées. Le tableau ci-dessus indique, situation par situation, ce que cela recouvre au niveau du réseau.
Protections à activer
| Protection | Où | État par défaut |
|---|---|---|
| Bouclier PII | Console Wiven → Bouclier PII | Désactivé |
| Mode souverain | Console Wiven → Mode souverain | Surveillance (Strict dans la configuration serveur fournie) |
| Contrôle du contenu | Réglages → Sécurité → Contrôle du contenu | Désactivé |
| Affirmations non sourcées | Console Wiven → Contrôle des réponses | Désactivé |
| Modèles approuvés | Console Wiven → Modèles approuvés | Non imposés |
| Murailles | Console Wiven → Murailles | Aucune |
| Transparence IA | Console Wiven → Transparence IA | Active |
Connecteurs métier
L'intégration se fait avec les outils déjà en place, sans les remplacer. La version 1.17.2 fournit :
- des sources de documents : sites web, Confluence, DrupalWiki, GitHub, GitLab, Gitea, Obsidian, Paperless-ngx, YouTube ;
- des compétences d'agent : Outlook, Gmail, Google Agenda, Microsoft Teams (annuaire, disponibilité, tickets), bases SQL (MySQL, PostgreSQL, SQL Server) ;
- des points d'extension : API développeur, serveurs MCP, flux d'agents.
Les connexions aux logiciels comptables, ERP et GED (Abacus, bexio, SAP…) sont réalisées par Wiven à travers ces points d'extension.

Deutsch