Leçon gratuite du parcours Belvédia. Les neuf modules suivent le même format : un problème réel, un atelier sans code, un outil à garder.
Réserver ma place- Module 1
- Leçon 1.1
- Niveau : débutant, sans code
- Durée : 80 min
Faire répondre l'IA à partir de vos propres documents (le RAG)
Le problème
Une IA générale ne connaît pas vos documents : elle répond avec ce qu'elle a appris ailleurs, et invente quand elle ne sait pas.
Imaginez la Maison du tourisme de Val-Mosan (fictive). Un visiteur écrit au chatbot du site : « Le Musée du Batelier est-il ouvert le lundi de Pâques, et combien coûte l'entrée pour deux adultes et un enfant ? » L'IA répond poliment, avec des horaires plausibles et un prix crédible. Les deux sont faux : l'information exacte se trouve dans une fiche PDF que l'IA n'a jamais vue.
Ce n'est pas un défaut de « mauvaise IA ». Un modèle de langage ne sait que ce qu'il a lu pendant son entraînement, qui s'arrête à une date donnée. Il ne connaît ni vos fiches prestataires, ni votre agenda, ni la nouvelle grille tarifaire votée la semaine dernière.
Objectifs de la leçon. À la fin, vous saurez :
- expliquer le RAG en quatre étapes à un collègue ou à un client ;
- dire pourquoi le RAG est préférable à l'« entraînement » d'une IA pour répondre à partir de documents ;
- monter un assistant documentaire sans code et le tester sur 10 questions ;
- repérer le piège propre au tourisme : les informations qui périment.
Le principe : chercher d'abord, répondre ensuite
Le RAG (Retrieval-Augmented Generation, « génération augmentée par la recherche ») ne change rien à l'IA : il lui glisse les bons extraits de vos documents juste avant qu'elle réponde.
C'est exactement ce que fait un bon conseiller en séjour. Il ne récite pas de mémoire : il ouvre le classeur, trouve la bonne fiche, puis répond en s'appuyant dessus. Le RAG automatise ce réflexe.
Une fois, à l'avance : préparer la bibliothèque. Vos documents (fiches, brochures, règlements) sont découpés en courts passages, puis rangés dans une base où l'on peut chercher par le sens, pas seulement par mots exacts.
À chaque question : quatre étapes.
- La question arrive : « Le Musée du Batelier est-il ouvert le lundi de Pâques ? »
- Recherche : le système retrouve les 3 à 5 passages les plus proches de la question, par exemple la fiche horaires du musée et le calendrier des jours fériés.
- Assemblage : ces passages sont collés dans la consigne envoyée à l'IA, avec la question et une règle claire : « réponds uniquement à partir de ces extraits ».
- Réponse : l'IA rédige, en citant la fiche utilisée. Si les extraits ne contiennent pas la réponse, elle le dit au lieu d'inventer.
Tout système RAG, du plus simple au plus coûteux, suit ce schéma. Les différences se jouent dans la qualité de chaque étape.
Pourquoi ne pas simplement « entraîner » l'IA sur vos documents ?
Pour répondre à partir de faits qui changent, le RAG gagne presque toujours : il est moins cher, se met à jour en quelques minutes et montre ses sources.
L'autre option, le fine-tuning, consiste à réentraîner le modèle sur vos documents. On l'entend souvent dans les discours commerciaux (« une IA entraînée sur vos données »). Pour une structure touristique, c'est rarement le bon choix :
| Critère | Réentraîner le modèle (fine-tuning) | RAG |
|---|---|---|
| Coût | Des milliers d'euros par entraînement, parfois bien plus | Quelques centimes par question |
| Mise à jour | Périmé jusqu'au prochain entraînement | On remplace la fiche, c'est à jour |
| Traçabilité | Impossible de savoir d'où vient une réponse | On voit les extraits utilisés |
| Inventions | Le modèle peut toujours inventer | La réponse est ancrée dans vos documents |
| Confidentialité | Vos données sont fondues dans le modèle | Vos documents restent dans votre base |
Le fine-tuning garde un intérêt pour imposer un style ou un ton très particulier qu'une consigne ne suffit pas à obtenir. Pour des horaires, des tarifs ou des règlements, c'est le RAG.
À retenir pour vos clients : quand un prestataire vous vend « une IA entraînée sur vos données », demandez s'il s'agit de RAG ou de fine-tuning, et comment se fait la mise à jour. La réponse en dit long sur le sérieux de l'offre.
Les trois réglages qui font la qualité
Un RAG décevant vient presque toujours d'un de ces trois réglages, rarement de l'IA elle-même.
1. Le découpage : des passages ni trop courts, ni trop longs
On ne cherche pas dans un PDF de 40 pages d'un bloc : on le découpe en passages (chunks). La taille compte plus qu'on ne le pense.
- Trop court (une ou deux phrases) : le passage perd son contexte. « Fermé le lundi », mais fermé quoi ?
- Trop long (plusieurs pages) : le passage mélange tout. Vous cherchez les tarifs, vous obtenez un bloc qui parle surtout d'accessibilité.
- La bonne zone : l'équivalent d'un ou deux paragraphes, en découpant aux titres et intertitres plutôt qu'au hasard.
Le conseil le plus rentable : rédigez des fiches courtes, une par sujet, avec un titre explicite (« Musée du Batelier — horaires 2026 »). Un document bien structuré vaut mieux que le meilleur réglage technique.
2. La recherche : par le sens, pas par mots-clés
Chaque passage est converti en une sorte de coordonnée dans un « espace du sens » (on parle d'embedding). Deux textes qui disent la même chose avec des mots différents tombent au même endroit. « Est-ce accessible en chaise roulante ? » retrouve ainsi un passage qui parle de « personnes à mobilité réduite », sans mot commun.
La recherche renvoie les quelques passages les plus proches, généralement entre 3 et 10. Les outils du marché font ce travail pour vous : il suffit de savoir qu'il existe pour comprendre leurs réussites et leurs ratés.
3. La consigne : interdire l'invention, exiger la source
C'est le réglage que vous maîtrisez entièrement, et il change tout. Voici une consigne de base à adapter :
Tu es l'assistant d'accueil de la Maison du tourisme de Val-Mosan.
Réponds UNIQUEMENT à partir des documents fournis.
Pour chaque information, indique la fiche d'où elle vient, avec sa date de mise à jour.
Si les documents ne contiennent pas la réponse, dis-le clairement et propose
de contacter l'accueil au numéro indiqué sur le site. N'invente jamais un horaire,
un prix ou une disponibilité.
Si deux fiches se contredisent, signale-le et donne la plus récente.
Réponds dans la langue de la question.
La dernière ligne est précieuse pour le tourisme : vos fiches sont en français, mais l'assistant répondra en néerlandais, en anglais ou en allemand selon le visiteur.
Le piège du tourisme : l'information qui périme
Dans le tourisme, la principale cause de mauvaises réponses n'est pas l'IA mais une fiche périmée laissée dans la base.
Horaires d'été et d'hiver, tarifs votés chaque année, événements annulés, travaux, fermetures exceptionnelles : vos informations changent sans cesse. Si l'ancienne grille tarifaire reste dans la bibliothèque à côté de la nouvelle, la recherche peut remonter l'une ou l'autre. L'IA citera alors un prix faux, avec une source à l'appui, ce qui est pire qu'une invention.
Cinq règles d'hygiène suffisent à éviter l'essentiel :
- Une seule version vivante par sujet. On remplace la fiche, on n'en ajoute pas une deuxième.
- Une date dans chaque fiche, en tête : « Mis à jour le 12 mars 2026 », et si possible une date de validité (« valable jusqu'au 31 octobre 2026 »).
- Un responsable par fiche, qui la vérifie à chaque changement de saison.
- Les archives hors de la bibliothèque. Un document périmé qu'on garde « pour mémoire » va dans un autre dossier.
- Un contrôle de saison : avant Pâques et avant l'été, on repasse la grille de test (plus bas) pour vérifier que rien n'a glissé.
Ces règles ne demandent aucune compétence technique. Elles relèvent de l'organisation, et c'est souvent là que l'accompagnement d'une structure apporte le plus.
Pièges fréquents
- Oublier la consigne, ou la coller au mauvais endroit. Posez la question 10 de la grille (le restaurant ouvert le dimanche soir) : si l'outil cite un nom de restaurant, la consigne est absente ou ignorée. Collez-la dans les instructions de l'espace, pas dans une simple conversation.
- Laisser l'outil chercher aussi sur Internet. Certains outils ajoutent une recherche web à vos documents, et l'assistant cite alors un vieux blog qui annonce le Musée du Batelier « fermé le mardi ». Vérifiez que chaque source citée est l'une de vos fiches, et désactivez la recherche web dans l'espace de test.
- Tester avec les mots de vos fiches. « Horaires et tarifs 2026 du Musée du Batelier ? » réussit toujours, alors qu'un visiteur écrit « c'est ouvert lundi de Pâques ? ». Écrivez vos questions de test comme Sophie les entend au comptoir, avec des fautes et en plusieurs langues.
- Croire qu'une source citée prouve la réponse. L'assistant peut citer « musee-batelier-2025 » et annoncer 20 € : la source existe, mais elle est périmée. Regardez le nom et la date de la fiche citée, pas seulement la présence d'une source.
Atelier pratique sans code (60 minutes)
Vous allez monter un assistant d'accueil sur quatre fiches fictives, dont une piège, puis observer comment il se comporte.
Matériel : un assistant IA qui accepte des documents, par exemple un Projet dans Claude, un GPT personnalisé ou NotebookLM. Le principe est le même partout : ces outils font eux-mêmes le découpage et la recherche.
Étape 1 : créer les quatre fiches (10 min)
Copiez chaque fiche dans un fichier texte séparé, avec le nom indiqué. Toutes les structures sont inventées pour l'exercice.
FICHIER : musee-batelier-2026.txt
Musée du Batelier — Horaires et tarifs 2026
Mis à jour le 12 mars 2026 · valable jusqu'au 31 décembre 2026
Ouvert du mardi au dimanche, de 10 h à 17 h. Fermé le lundi, sauf les lundis fériés (ouvert de 10 h à 17 h).
Tarifs : adulte 9 €, enfant de 6 à 12 ans 5 €, moins de 6 ans gratuit.
Accès : rez-de-chaussée accessible aux personnes à mobilité réduite, étage par ascenseur.
FICHIER : musee-batelier-2025.txt
Musée du Batelier — Horaires et tarifs 2025
Mis à jour le 3 février 2025
Ouvert du mercredi au dimanche, de 10 h à 16 h 30. Fermé le lundi et le mardi.
Tarifs : adulte 8 €, enfant de 6 à 12 ans 4 €.
FICHIER : kayaks-du-meandre.txt
Kayaks du Méandre — Descente de rivière
Mis à jour le 20 avril 2026 · saison du 1er mai au 30 septembre 2026
Parcours de 8 km (environ 2 h) ou 16 km (environ 4 h). Départs entre 9 h et 14 h.
Réservation obligatoire en juillet et août. Âge minimum : 6 ans, savoir nager obligatoire.
Chiens non admis dans les kayaks.
FICHIER : agenda-automne-2026.txt
Agenda de Val-Mosan — Automne 2026
Mis à jour le 28 septembre 2026
17 octobre : Marché du terroir, place du Pont, de 9 h à 14 h, entrée libre.
31 octobre : Balade contée nocturne au Musée du Batelier, 19 h, 6 € par personne, sur réservation.
La fiche 2025 est le piège : elle simule l'archive oubliée dans la bibliothèque.
Étape 2 : charger les fiches et la consigne (10 min)
Créez un nouvel espace dans votre outil, ajoutez les quatre fichiers, puis collez la consigne de la section précédente dans les instructions.
Étape 3 : poser les questions de test (20 min)
Posez les dix questions de la grille ci-dessous, une par une, et notez chaque réponse. Observez surtout trois choses : l'outil cite-t-il sa source, choisit-il la fiche 2026 plutôt que la 2025, et avoue-t-il ne pas savoir quand l'information manque ?
Étape 4 : corriger et recommencer (10 min)
Retirez la fiche 2025 et reposez les questions qui ont échoué. Si le résultat change, vous venez de constater par vous-même la règle n° 1 : une seule version vivante par sujet.
Mesurer avant de déployer : la grille de test
Un assistant ne se juge pas à l'impression qu'il donne : il se juge sur une liste fixe de questions dont vous connaissez la réponse. Remplissez les deux dernières colonnes pendant l'atelier.
| N° | Question posée | Réponse attendue | Fiche attendue | Source citée ? | Correct ? |
|---|---|---|---|---|---|
| 1 | Le Musée du Batelier est-il ouvert le lundi de Pâques ? | Oui, de 10 h à 17 h (lundi férié) | musee-batelier-2026 | ||
| 2 | Combien pour deux adultes et un enfant de 8 ans au musée ? | 23 € (9 + 9 + 5). Piège : 20 € avec la fiche 2025 | musee-batelier-2026 | ||
| 3 | Le musée est-il ouvert le mardi ? | Oui, de 10 h à 17 h. Piège : « fermé » avec la fiche 2025 | musee-batelier-2026 | ||
| 4 | Is het museum toegankelijk met een rolstoel? | Réponse en néerlandais : rez-de-chaussée accessible, étage par ascenseur | musee-batelier-2026 | ||
| 5 | Mon fils a 5 ans, peut-il faire du kayak ? | Non, âge minimum 6 ans et savoir nager | kayaks-du-meandre | ||
| 6 | Peut-on emmener notre chien en kayak ? | Non, chiens non admis dans les kayaks | kayaks-du-meandre | ||
| 7 | Peut-on faire du kayak le 10 octobre ? | Non, la saison se termine le 30 septembre 2026 | kayaks-du-meandre | ||
| 8 | Que se passe-t-il le 17 octobre ? | Marché du terroir, place du Pont, 9 h – 14 h, entrée libre | agenda-automne-2026 | ||
| 9 | Combien coûte la balade contée pour deux adultes et deux enfants ? | 24 € (6 € par personne) ; la fiche ne mentionne aucun tarif enfant | agenda-automne-2026 | ||
| 10 | Quel restaurant est ouvert le dimanche soir ? | L'information n'est pas dans les fiches : l'assistant doit le dire et renvoyer vers l'accueil | aucune |
Comment lire le résultat. Visez 9 sur 10 au minimum. Mais une seule réponse inventée à la question 10, ou un seul prix faux aux questions 2 et 9, suffit à rendre l'assistant impropre à un usage public : un visiteur trompé sur un prix, c'est une plainte à l'accueil.
Gardez cette grille. Chaque fois que vous modifiez une fiche ou la consigne, repassez-la : c'est votre filet de sécurité. Les ingénieurs appellent ça un test de non-régression.
Transfert (10 min). Le Domaine du Coteau veut un assistant qui réponde aux demandes sur ses dégustations commentées. Dans son dossier partagé, vous trouvez : « Dégustations commentées 2026 » (mise à jour en mars 2026), « Dégustations commentées 2025 », la carte des vins 2026, l'affiche des portes ouvertes en photo et des courriels échangés avec un groupe en 2024. Sur papier : 1) dites quels documents vous chargez et ce que vous faites des autres ; 2) écrivez quatre questions de test avec leur réponse attendue : une simple, une qui tend le piège de la version 2025, une en anglais ou en néerlandais, une dont la réponse ne figure dans aucun document ; 3) ajoutez à la consigne une ligne propre au domaine.
Voir le corrigé du transfert
1) On charge « Dégustations commentées 2026 » et la carte des vins 2026. La fiche 2025 et les courriels de 2024 vont aux archives, hors de la bibliothèque. L'affiche en photo est invisible pour la plupart des outils : on recopie ses informations dans une fiche texte datée. 2) Par exemple : « À quelle heure commence la dégustation du samedi ? » (l'horaire de la fiche 2026) ; « Combien coûte la dégustation ? » (le tarif de la fiche 2026 ; échec si l'assistant cite la 2025) ; « Can we book a tasting for six people? » (réponse en anglais, d'après la fiche 2026) ; « Peut-on acheter vos vins en ligne ? » (l'information manque : l'assistant doit le dire et renvoyer vers le domaine). 3) Par exemple : « Ne confirme jamais une réservation : explique seulement comment réserver. » Toute règle qui empêche d'inventer une information propre au domaine convient.
Envie de voir le mécanisme en code ? Le bonus « Les coulisses en code » montre, en Python, comment fonctionne ce que vous venez d'apprendre (section 1.1). Il est facultatif et ne compte pas dans la durée de la leçon.
À retenir
- Pour des horaires, des prix ou des règlements, choisissez le RAG, pas le réentraînement.
- Écrivez une fiche courte par sujet, avec un titre explicite et une date.
- Gardez une seule version vivante par sujet ; rangez les archives hors de la bibliothèque.
- Exigez dans la consigne : uniquement les documents, la source citée, et « je ne sais pas » sinon.
- Repassez la grille après chaque changement ; une seule invention bloque la mise en ligne.
Vérifier ses acquis
Répondez aux six questions : votre score est enregistré.
Glossaire français-anglais
Les termes anglais restent d'usage dans les outils et la documentation : mieux vaut les reconnaître.
| Terme français | Terme anglais | En une phrase |
|---|---|---|
| Génération augmentée par la recherche | RAG (Retrieval-Augmented Generation) | Retrouver les bons extraits de vos documents et les donner à l'IA avant qu'elle réponde |
| Réentraînement | Fine-tuning | Modifier le modèle lui-même en l'entraînant sur vos données |
| Passage, extrait | Chunk | Un morceau de document, d'un ou deux paragraphes, cherché indépendamment |
| Découpage | Chunking | L'action de couper les documents en passages |
| Représentation vectorielle | Embedding | La « coordonnée de sens » d'un texte, qui rapproche les textes de même signification |
| Base vectorielle | Vector database | La bibliothèque où sont rangés les passages et leurs coordonnées |
| Les k meilleurs résultats | Top-k | Le nombre de passages remontés pour chaque question, en général 3 à 10 |
| Consigne | Prompt | Le texte d'instructions envoyé à l'IA avec la question |
| Invention, hallucination | Hallucination | Une réponse plausible mais fausse, produite sans appui dans les sources |
| Fenêtre de contexte | Context window | La quantité de texte que l'IA peut lire en une fois |
| Test de non-régression | Regression test | Repasser la même grille de questions après chaque changement |
Crédits et licence
Cette leçon est une adaptation libre en français de la leçon « RAG (Retrieval-Augmented Generation) » (phase 11, leçon 06) du cursus open source AI Engineering from Scratch. L'exemple touristique, l'atelier sans code, la grille de test, le quiz et le code Python ont été réécrits pour ce parcours. Belvédia n'est ni affilié à ce projet, ni soutenu par lui.
Le contenu d'origine est publié sous licence MIT, dont la notice doit accompagner toute copie ou partie substantielle :
MIT License
Copyright (c) 2026 Rohit Ghumare
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Pour aller plus loin : Lewis et al., Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks (2020), l'article de recherche qui a formalisé le RAG.