This page is machine-translated from French. Read the French original.

First steps

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. The first-time setup wizard

On first launch, WivenLLM lets you choose the essentials:

The language model provider. 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. → Choosing your models

Your account. 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 :

The embeddings engine. 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.

The vector basis. 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. Understanding the main screen

  • À 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. Import a 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é.

Until step 2 is completed, the document cannot be searched.

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. Ask a 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.

Three tips that greatly improve the quality of the responses:

  • Be explicit. « Quel est le délai de résiliation du contrat de maintenance ? » vaut mieux que « délai résiliation ? ».
  • Check the 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. Adjust the workspace

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. Going further

Objective Page
Organize multiple topics in one space Workspaces
Automate a task Agents Verification Status
Donner accès à des collègues (licence WivenLLM Business) Users and roles
Publish an assistant on your site Web widget
Connect WivenLLM to your applications API developer

If that doesn't work

The response ignores my 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.

The answer is invented. 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.

Responses are slow. 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.

An import fails. 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.