Premiers pas

Ce parcours mène de l'installation vide à une première réponse construite sur vos documents. Comptez une dizaine de minutes.

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

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.

Important : changer de moteur d'embeddings plus tard rend les index existants inutilisables et impose de réindexer vos espaces. Ce choix mérite d'être fait une fois, correctement.

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 compte. Nom et identifiants du premier compte, qui est administrateur.

Votre premier espace de travail. Un nom suffit — par exemple le 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 dépôt de fichiers et le microphone.
• En bas à gauche, l'accès aux réglages.

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 rien, sauf si vous ajoutez le même document aux deux.

3. Importer un document

Trois manières :

• Glisser-déposer un fichier dans la zone de saisie ;
• ouvrir le gestionnaire de documents de l'espace (icône de trombone ou de dossier) et téléverser depuis là ;
• coller une URL pour importer une page web.

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

1. Extraction — le fichier est converti en texte. Il apparaît alors dans la bibliothèque de documents.
2. Ajout à l'espace — vous sélectionnez le document et validez : il est découpé, vectorisé et indexé.

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

→ 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 : nom du document et passage exact.

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

• Soyez explicite. « Quel est le délai de résiliation dans le contrat Dupont ? » 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). Trois réglages produisent l'essentiel de l'effet :

Le mode de conversation. - Chat — le modèle utilise vos documents et ses connaissances générales. - Requête — le modèle répond uniquement à partir de vos documents, et indique qu'il ne sait pas lorsqu'ils ne contiennent pas la réponse.

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

Le prompt système. 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

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é : 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. 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.