Guide Ninja 🥷 Documentation pour enrichir l'expérience utilisateur 📕

La Documentation est la base documentaire centralisée de ton environnement muchbetter.ai. Elle contient tes documents officiels (fiches offres, tarifs, conditions générales, argumentaires, guides…) et alimente deux fonctionnalités clés de la plateforme.

🎯 À quoi sert la Documentation ?

Fonctionnalité	Ce qu'elle fait
🔍 Expertise	Vérifie la précision factuelle du collaborateur pendant une simulation : prix, garanties, conditions, caractéristiques produit… en croisant avec tes documents
📚 Open Learning	Permet au collaborateur de poser des questions à l'assistant IA via l'onglet Connaissances (S'entraîner). L'IA répond en s'appuyant sur tes documents sans les afficher.

💡 L'expertise évalue le fond (la bonne information). Les critères d'évaluation évaluent la forme (le bon comportement). Les deux sont complémentaires.

📄 Ajouter un document

Rends-toi dans Admin → Documentation → "Ajouter un document".

Formats acceptés : PDF, DOCX, PPTX.
Nommage : c'est un point critique. Le titre doit être précis et descriptif. Ex : "Offre Prévoyance Pro : Tarifs 2025". Ce titre est utilisé par l'IA pour retrouver la bonne information.

⚠️ Un titre vague ou différent du contenu réel = l'IA risque de ne pas retrouver la bonne information.

💡 Documents "IA-friendly" : privilégie du texte structuré, des titres clairs, des paragraphes nets. Évite les tableaux complexes, schémas graphiques, colonnes multiples et scans. Si un document est trop mis en forme, crée une version simplifiée à côté.

🔗 Activer l'expertise sur une situation

Une fois tes documents ajoutés, tu peux les lier à une situation pour activer l'expertise :

Va dans Admin → Situations → ta situation → onglet Configuration.
Coche "Activation de l'expertise".
Renseigne les titres exacts des documents ou sections pertinentes. Plus c'est précis, mieux l'IA ciblera ses recherches.

Quand une erreur factuelle est détectée pendant une simulation, l'expertise affiche :

Le passage exact de la transcription contenant l'erreur
L'audio correspondant
Ce qui aurait dû être dit

🔐 Sécurité et accès

Ce que le collaborateur peut faire	Ce qu'il ne peut JAMAIS faire
Interroger l'assistant IA via Connaissances (l'IA répond sans afficher les docs)	Accéder à la liste des documents de la base
Consulter les docs attachés à un persona pendant une simulation (si activé)	Télécharger ou exporter un PDF
	Voir des infos d'un document non activé pour sa situation

💡 Tes documents propriétaires (tarifs, conditions, guides internes) sont sécurisés dans l'environnement. Seule l'IA y a accès pour répondre aux questions et évaluer la précision factuelle.

📖 Le Lexique : aider l'IA à bien reconnaître ton vocabulaire métier

🧐 Où ça se passe ? Paramètres → Lexique

Le Lexique est un outil complémentaire à la Documentation. Il permet d'apprendre à l'IA à reconnaître et prononcer correctement des mots spécifiques à ton métier, ta marque ou ton secteur : noms de produits, acronymes, jargon technique, termes étrangers…

Sans Lexique, l'IA peut mal comprendre ce que dit le collaborateur (reconnaissance vocale) ou mal prononcer un mot pendant la simulation (synthèse vocale). Le Lexique corrige les deux.

➕ Ajouter un mot au Lexique

Dans Paramètres → Lexique → "Ajouter", remplis 3 champs :

Champ	Obligatoire	Détail
Mot du lexique	Oui	Le terme exact tel qu'il doit être reconnu et écrit. Ex : "Wifi"
Description	Optionnel	Courte définition pour aider l'IA à contextualiser le mot. Ex : "Réseau sans fil"
Prononciation	Optionnel	L'orthographe phonétique pour guider la synthèse vocale. Ex : "ouifi"

💡 Quand l'utiliser :

Noms de produits ou de marques qui ne sont pas des mots standard
Acronymes internes (ex : CGV, RGPD, TNS…)
Termes anglais dans un environnement francophone (ou l'inverse)
Jargon métier spécifique à ton secteur
Tout mot que l'IA écrit ou prononce mal de façon récurrente

💡 Documentation + Lexique = duo gagnant. La Documentation donne à l'IA la connaissance (quoi dire), le Lexique lui donne le vocabulaire (comment le dire et le reconnaître).