Comment rédiger des sources de connaissances efficaces pour les systèmes basés sur RAG (découverte de connaissances)

Ce uid fournit des recommandations pratiques pour la rédaction ou l'amélioration d'articles, de manuels et de uid destinés à un système d'IA RAG (Retrieval-Augmented Generation). L'objectif est de faciliter au maximum la compréhension et la récupération d'informations pertinentes et précises par le modèle.

1. 🎯 Définissez un objectif clair pour chaque document

Chaque document doit répondre à une question ou à un cas d’utilisation spécifique .

Indiquez clairement le sujet du document dans le titre et les en-têtes (par exemple, « Comment réinitialiser votre mot de passe dans ESM » , « Configuration VPN pour les employés distants » ).

Évitez de mélanger les sujets : il est préférable de diviser les longs documents en documents plus petits et plus ciblés.

2. 🧱 Utilisez des sections structurées et des titres clairs

Organisez le contenu en sections logiques : Introduction, Étape par étape, Notes, Problèmes courants, FAQ .

Utilisez les titres H2/H3 : cela aide le modèle à comprendre la structure et le contexte du contenu.

Chaque action ou instruction doit figurer dans sa propre étape ou son propre paragraphe.

3. 🔢 Utilisez des étapes numérotées et des puces

Au lieu de longs paragraphes, utilisez :

## How to reset your password
1. Go to the login page.
2. Click on “Forgot password”.
3. Enter your company email address.
4. Check your inbox and click the reset link.

L’IA gère ce format bien mieux que le texte non structuré.

4. 📌 Utilisez une terminologie cohérente

Utilisez des noms clairs et cohérents pour les systèmes, les équipes, les fonctions et les acronymes (par exemple, « Plateforme ESM », « Équipe de support informatique », « FortiClient VPN »).

Évitez d’utiliser des abréviations ou du jargon interne, sauf s’ils sont définis.

5. 🧠 Pro un contexte dans le document

Ajoutez une brève explication de la raison d'être de la mesure. Par exemple :

« La réinitialisation du mot de passe est requise tous les 90 jours pour se conformer à la politique de sécurité de l'entreprise. »

Le modèle comprend mieux le but et l’intention lorsque le contexte est disponible.

6. 🔍 Mettez en évidence les informations clés

Mettez en évidence les points importants (comme les chemins, les paramètres, les avertissements, les conseils) avec du texte en gras ou une mise en forme visuelle :

Remarque : après avoir réinitialisé votre mot de passe, vous devrez vous reconnecter au VPN.

Cela aide le modèle à reconnaître ce qui est important dans la réponse.

7. 📂 Un document = un sujet

❌ Mauvaise pratique : « Tout ce que vous devez savoir sur l’ESM »

✅ Bonnes pratiques :

« Comment soumettre une demande de congé dans ESS2 »

« Comment vérifier l'état d'un ticket dans ESM »

« Comment activer l'authentification multifacteur pour votre compte d'entreprise »

8. 💬 Inclure des FAQ et des questions typiques des utilisateurs

L'IA répond souvent à des questions en langage naturel. Incluez une section comme :

## Frequently Asked Questions
- What if I didn't receive the reset email?
- Can I reset my password outside the office network?

9. 🧪 Testez avant de publier

Essayez de poser de vraies questions aux utilisateurs et voyez si les réponses sont faciles à trouver dans le texte.

En option, testez le document via le système d’IA et évaluez la qualité des réponses générées.

10. 🧼 Utilisez un langage simple et correct

L’IA fonctionne mieux avec des phrases courtes, claires et grammaticalement correctes .

Évitez les phrases trop techniques ou complexes.

Utilisez des instructions directes plutôt qu’un langage conditionnel ou suggestif.

✍️ Exemple : Mauvais vs Bon

❌ Mauvais :

Si l'utilisateur rencontre des problèmes de connexion, il peut essayer de se souvenir du mot de passe ou accéder à la page de connexion ESM et peut-être utiliser l'option de réinitialisation.

✅ Bien :

Comment réinitialiser votre mot de passe :

Accédez à la page de connexion ESM.

Cliquez sur « Mot de passe oublié ».

Entrez l'e-mail de votre entreprise.

Vérifiez votre boîte de réception et cliquez sur le lien de réinitialisation.

⚠️ Important : utilisez une seule langue pour tous les documents

Pour maintenir un niveau élevé de précision et de qualité des réponses dans le système d'IA, tous les documents sources doivent être rédigés dans la même langue . Le mélange de langues au sein de la base de connaissances réduit considérablement l'efficacité du modèle et la clarté des réponses.

Veuillez décider à l'avance quelle langue principale sera utilisée (par exemple, l'anglais, le finnois, l'allemand, le suédois ou le polonais) et assurez-vous que tous les articles, instructions et documentations suivent ce choix de manière cohérente.