Premiers pas

Ce parcours mène de l'installation vide à une première réponse construite sur vos documents. Comptez une dizaine de minutes, hors téléchargement d'un modèle local.


1. L'assistant de première configuration

Au premier lancement, WivenLLM vous fait choisir l'essentiel :

Le fournisseur de modèle de langage. C'est le moteur qui rédige les réponses. Vous pouvez choisir un modèle exécuté localement, un serveur d'inférence de votre organisation, ou un fournisseur externe. Ce choix se modifie ensuite à tout moment, y compris espace de travail par espace de travail. → Choisir ses modèles

Votre compte. La question « Combien de personnes utiliseront cette instance ? » offre deux réponses. « Juste moi » ne crée aucun compte ; un mot de passe d'instance est facultatif, et il n'existe pas de récupération si vous le perdez. « Mon équipe » crée le compte administrateur et active le mode multi-utilisateurs : ce choix demande la licence WivenLLM Business.

La gestion des données. Un récapitulatif indique ce que deviennent vos données avec le fournisseur retenu. Une courte enquête facultative suit.

Deux éléments sont appliqués sans vous être demandés, et se changent ensuite dans les réglages :

Le moteur d'embeddings. Il traduit vos documents en vecteurs. Le moteur intégré s'exécute localement, ne demande aucune clé et convient à la plupart des usages. Il est téléchargé une fois, au premier import.

Important : changer de moteur d'embeddings plus tard vide l'index de tous vos espaces et en retire les documents, qu'il faut y ajouter à nouveau. Si vous devez en changer, faites-le avant d'importer vos documents.

La base vectorielle. La base locale intégrée est le choix par défaut : rien à installer, tout reste sur disque. Une base d'entreprise se justifie sur de gros volumes ou lorsqu'elle existe déjà chez vous.

Votre premier espace de travail est créé pour vous à la fin de l'assistant. Renommez-le dans ses réglages — par exemple du nom d'un dossier, d'un client ou d'un projet.


2. Comprendre l'écran principal

  • À gauche, la liste de vos espaces de travail. Chacun a ses documents, ses réglages et ses conversations.
  • Au centre, la conversation en cours.
  • En bas, la zone de saisie, avec le bouton pour joindre un fichier et le microphone.
  • En bas à gauche, l'accès aux réglages (icône de clé à molette), que les comptes au rôle Utilisateur ne voient pas.

Un espace de travail est l'unité d'organisation de WivenLLM : c'est lui qui détermine quels documents sont consultables, quel modèle répond et selon quelles consignes. Deux espaces ne partagent aucun document, sauf si vous ajoutez le même aux deux. Vos souvenirs globaux et votre Second Brain, eux, vous suivent d'un espace à l'autre.


3. Importer un document

Ouvrez le gestionnaire de documents de l'espace avec l'icône d'envoi (flèche vers le haut) à côté de son nom ; elle apparaît sur l'espace actif ou au survol. Puis :

  • cliquez ou glissez-déposez un fichier dans la zone d'envoi ;
  • ou collez une URL dans « ou soumettre un lien », puis « Récupérer le site web ».

L'import se déroule en deux temps, et c'est la source de confusion la plus fréquente :

  • Extraction — le fichier est converti en texte. Il apparaît alors dans « Mes documents ».
  • Ajout à l'espace — vous sélectionnez le document, choisissez « Déplacer vers l'espace de travail » puis « Sauvegarder et intégrer » : il est découpé, vectorisé et indexé.

Tant que l'étape 2 n'est pas faite, le document n'est pas interrogeable.

Un fichier glissé directement dans la conversation ou joint avec le bouton « + » suit un autre chemin : il sert de contexte à cette conversation, sans entrer dans l'index de l'espace. S'il dépasse la place disponible dans le contexte, l'application vous propose de l'intégrer à l'espace.

→ Documents


4. Poser une question

Écrivez votre question en langage naturel. La réponse s'affiche au fil de sa génération, suivie d'une mention Sources qui déplie les extraits utilisés : titre du document et extrait, avec un score de similarité. La citation n'indique ni la page ni la section.

Trois conseils qui changent beaucoup la qualité des réponses :

  • Soyez explicite. « Quel est le délai de résiliation du contrat de maintenance ? » vaut mieux que « délai résiliation ? ».
  • Vérifiez les sources. Un extrait sans rapport avec la question signale un problème d'indexation ou de paramètres de recherche.
  • Une conversation, un sujet. Les échanges précédents font partie du contexte envoyé au modèle ; mélanger les sujets dégrade les réponses.

5. Régler l'espace de travail

Ouvrez les réglages de l'espace (icône d'engrenage à côté de son nom), onglet « Paramètres du chat ». Trois réglages produisent l'essentiel de l'effet :

Le mode de chat. « Chat » est le mode par défaut.

  • Chat — le modèle utilise vos documents et ses connaissances générales.
  • Requête — le modèle répond uniquement si des passages de vos documents sont trouvés ; sinon, l'application affiche un message de refus, que vous pouvez personnaliser.
  • Agent — le modèle utilise les outils de lui-même, s'il sait les appeler. Dans les deux autres modes, les outils passent par la commande @agent.

Pour un usage documentaire strict (dossiers clients, base réglementaire), le mode Requête est presque toujours le bon choix.

Le prompt système (« Invite » à l'écran). Les consignes permanentes données au modèle : son rôle, son ton, ce qu'il doit refuser, le format attendu. C'est le levier le plus efficace de toute l'application.

Le modèle. Chaque espace peut utiliser un modèle différent de celui de l'instance.

→ Conversations


6. Aller plus loin

Objectif Page
Organiser plusieurs sujets dans un espace Espaces de travail
Automatiser une tâche Agents
Donner accès à des collègues (licence WivenLLM Business) Utilisateurs et rôles
Publier un assistant sur votre site Widget web
Connecter WivenLLM à vos applications API développeur

Si ça ne marche pas

La réponse ignore mes documents. Vérifiez qu'ils sont bien ajoutés à l'espace et non seulement importés. Vérifiez ensuite le seuil de similarité (onglet « Base de données vectorielle » des réglages de l'espace) : un seuil trop élevé écarte des passages pertinents.

La réponse invente. Passez l'espace en mode Requête et précisez dans le prompt système que toute information absente des documents doit être signalée comme telle.

Les réponses sont lentes. Un modèle local sans GPU est lent par nature, et le premier message après une période d'inactivité attend que le modèle soit rechargé en mémoire. Essayez un modèle plus petit, ou basculez sur un fournisseur externe pour cet espace.

Un import échoue. Le format n'est peut-être pas pris en charge, ou le PDF est une image sans couche texte — la reconnaissance de caractères s'applique alors, avec un résultat variable selon la qualité du scan.