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.

→ Fournisseurs supportés


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.

→ Sécurité et confidentialité


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.

→ Sécurité WivenLLM · Intégrations