Parcours expert

Ce parcours couvre le cycle complet : déposer un document, le curer, le rattacher aux rôles, puis régénérer l'index. Les noms de boutons et d'onglets sont ceux de l'interface en français.

Le dépôt, la curation et la gestion des rôles demandent un compte admin. Un compte user consulte les fichiers en lecture seule.

1. Déposer les documents (admin)

1. Passer en mode admin et ouvrir le tableau de bord (/admin/dashboard).
2. Dans le widget Télécharger des fichiers techniques, glisser-déposer le fichier, ou le sélectionner.
3. Attendre la fin du traitement : le fichier est analysé, découpé en fragments, puis apparaît dans la liste.

Formats acceptés pour les fichiers techniques : PDF, Word (.docx, .doc), PowerPoint (.pptx, .ppt), Excel (.xlsx, .xls), CSV, texte, Markdown, HTML, images (PNG, JPEG, TIFF, BMP, WebP), OpenDocument, EPUB, JSON, XML et quelques formats LaTeX, VTT et e-mail. La taille maximale est de 50 Mo par fichier.

Pour les Q&R, le widget Télécharger des données Q&R accepte les fichiers CSV et XLSX. Le fichier doit contenir au moins deux colonnes (question et réponse) ; une troisième colonne peut donner la catégorie. Les règles exactes sont rappelées dans l'onglet « Instructions » de la page Fichiers.

Des fragments ou des paires peuvent aussi être ajoutés à la main, sans fichier parent, avec les widgets d'ajout manuel.

2. Suivre le traitement

La page Fichiers (/admin/files) affiche la progression de chaque fichier. Attendre la fin du traitement avant de curer le fichier.

3. Curer les fragments

Ouvrir un fichier technique : la visualisation des fragments (/chunk-visualisation/$fileId) affiche un fragment par ligne.

Pour chaque fragment :

1. Lire le contenu et vérifier qu'il est correct et complet.
2. Si besoin, cliquer sur Modifier pour corriger ou reformuler le texte.
3. Choisir la catégorie :
   • Statique : information qui ne change pas (par exemple le nom d'une entreprise) ;
   • Dynamique : information qui change souvent (par exemple un prix) ;
   • Pas une info : fragment inutile pour le chat, exclu de l'index.
4. Ajouter ou retirer les tags du fragment.
5. Cliquer sur Enregistrer la progression : sans cet enregistrement, les modifications ne sont pas conservées.

Les paires Q&R se traitent sur /qa-visualisation/$fileId (ou sa version admin) : relire la question et la réponse, les modifier au besoin, appliquer la catégorie et les tags, puis enregistrer.

La catégorie finetuned existe dans la base mais n'est pas proposée à l'édition : le serveur refuse de la modifier, dans un sens comme dans l'autre.

4. Gérer les tags (admin)

Dans /admin/admin, onglet Gestion des tags : créer, renommer, colorer et supprimer les tags.

Les tags s'appliquent :

• à un fichier entier, depuis la boîte Tags du fichier de la liste des fichiers : ils remplacent les tags actuels du fichier ;
• à un fragment ou une paire Q&R, depuis sa visualisation.

5. Associer les rôles aux tags (admin)

Un rôle donne accès aux contenus portant ses tags. Dans /admin/admin :

• Gestion des rôles : créer un rôle, lui associer des tags, et définir l'ordre des rôles. Le rôle admin est le rôle super-admin : il voit tous les contenus.
• Gestion des utilisateurs : donner à chaque compte son rôle applicatif. Un compte a un rôle à la fois.

L'ordre des rôles compte. Un rôle hérite des tags des rôles placés après lui dans cet ordre, sauf les rôles exclus de la hiérarchie.

6. Régénérer l'index (admin)

Quand la curation est terminée, cliquer sur Régénérer l'index dans le widget du tableau de bord (mode admin). Le chat répond à partir de l'index construit à ce moment-là : tant qu'il n'est pas régénéré, les dernières modifications ne sont pas prises en compte.

L'index est construit pour chaque rôle, à partir des fragments et paires Q&R dynamiques ou statiques que ce rôle peut voir. Les fragments « Pas une info » et les paires non catégorisées n'y figurent pas.

Bonnes pratiques

• Vérifier une question d'échantillon dans le chat après chaque régénération.
• Classer en « Statique » uniquement ce qui ne change pas : le reste doit être « Dynamique » pour être mis à jour facilement.
• La suppression d'un fichier est réservée aux admins.