Architecture Decision Record : une page qui consigne une décision technique, l'option écartée, et la mesure chiffrée qui la ferait changer.
BAA 101 · 70 notions
Le glossaire
Toutes les notions rencontrées dans mes formations et mes challenges, par ordre alphabétique, avec un lien vers le chapitre de BAA 101 qui les explique.
A
- ADR
- Agent
Un programme qui utilise un modèle de langage pour décider quoi faire (chercher, appeler un outil, répondre, refuser), en boucle, avec des règles d'arrêt.
- Appel d'outil
La demande du modèle d'exécuter un outil avec des arguments précis. C'est lui qu'on lit dans la trace, pas la réponse finale.
VoirL'outil vu par le modèleLire l'appel d'outil, pas la réponseHacktoberfest 2026 · Week 1Hacktoberfest 2026 · Week 2
B
- Backtest
Tester une méthode sur le passé : on fait comme si on ignorait l'issue des cas récents, on prédit, puis on compare à ce qui s'est vraiment passé.
- Base de connaissances
Un ensemble de documents découpés et indexés que l'agent interroge avant de répondre. Une base non synchronisée renvoie du vide, sans erreur.
- Boucle d'agent
Le cycle message → modèle → appel d'outil → résultat → modèle, répété jusqu'à une réponse ou une sortie prévue.
- Budget
Le nombre maximal d'appels qu'une boucle d'agent peut faire, vérifié avant chaque appel, jamais après.
C
- Calibration
Un score de 80 % est bien calibré si, sur beaucoup de cas notés 80 %, environ 8 sur 10 se réalisent. Un seul cas ne peut pas le prouver.
- Chunk (passage)
Un morceau de document que la récupération peut renvoyer. Un passage trop court peut perdre la phrase qui répond.
- Citation
L'identifiant du document qui soutient une réponse. Une citation juste ne prouve pas que la phrase vient du document.
VoirLa sortie du modèle est une donnée non fiableÉvaluer sans se mentir
- Cold start
La lenteur du premier appel à un service qui vient de démarrer. On la mesure : c'est un nombre, pas un verdict de panne.
- Corpus
L'ensemble des documents sur lesquels l'agent a le droit de s'appuyer.
D
- Diff
La liste exacte des lignes ajoutées et supprimées dans un fichier. C'est lui qui fait foi, pas ce que l'assistant annonce.
- Données ouvertes (open data)
Des données publiées par une institution, que n'importe qui peut télécharger et réutiliser gratuitement, souvent sous licence ouverte.
E
- Échec silencieux
Une erreur qui ressemble à une réponse normale, comme « aucun résultat » alors qu'il y en a. Le pire type d'erreur.
F
- Fail closed
En cas de doute, le garde-fou bloque plutôt que de laisser passer. Un garde-fou qui ne vérifie rien quand le modèle n'appelle pas l'outil échoue « ouvert ».
VoirLire l'appel d'outil, pas la réponseCe qui doit toujours arriver s'impose dans le codeHacktoberfest 2026 · Week 2
- Faux modèle
Un modèle déterministe aux réponses prévues. Il teste le circuit, pas le jugement : un test vert sur lui prouve la tuyauterie.
- Fuite de données (data leakage)
Quand le modèle voit par erreur une information qu'il n'aurait pas eue au moment de prédire (par exemple la date de paiement) : le score paraît excellent, mais il est faux.
G
- Garde d'URL
Un contrôle qui décide, sur la seule chaîne de caractères et avant toute requête, si une adresse est autorisée : protocole, adresse publique, domaine permis.
- Golden set
Un petit jeu de questions de référence, chacune étiquetée avec le comportement attendu : répondre, citer, ou refuser.
- Grounding (ancrage)
Le fait qu'une réponse soit réellement soutenue par le document qu'elle cite.
- Guardrail
Un filtre appliqué aux entrées et aux sorties du modèle : contenus dangereux, données personnelles, sujets interdits. Il se teste comme du code, faux positifs compris.
VoirUne donnée n'est jamais un ordreHacktoberfest 2026 · Week 2
H
- Hallucination d'action
L'agent affirme avoir agi sans l'avoir fait, par exemple en donnant un numéro de ticket inventé. Le texte de la réponse ne prouve rien.
- Harness
Tout ce qui entoure le modèle : la boucle qui le fait tourner, les instructions, les outils, les traces, les évaluations. Un harness géré fait tourner la boucle à votre place, avec moins de contrôle.
- Hit rate @k
La part des questions dont le document attendu figure parmi les k premiers résultats de la recherche.
- Hook
Du code déclenché à un moment précis de la vie de l'agent, avant ou après un appel, pour imposer une règle que le prompt ne garantit pas.
I
- Idempotence
Relancer une action ne change pas le résultat : un retour déjà initié n'est pas initié deux fois, une ressource existante est réutilisée.
- Injection de prompt
Un ordre caché dans un texte (document, page, sortie d'outil, nom de produit) qui tente de piloter le modèle. On le traite comme une donnée, jamais comme une instruction.
- Intention épinglée
Ce qui a été demandé, écrit avant que l'action existe. Chaque vérification compare l'action à cette épingle, jamais à elle-même.
L
- Licence open-weights
Des poids ouverts ne veulent pas dire « libre de vendre » : un modèle peut être gratuit pour un prototype et interdit dans un produit payant.
- LLM
Large Language Model : le modèle de langage qui génère du texte et choisit les outils à appeler.
- LLM-as-judge
Un modèle qui note les réponses d'un autre selon un critère. Il lit le texte, mais ne voit ni les appels d'outils ni ce qui a été écrit en base.
M
- Masquage (redaction)
Remplacer un secret (clé, token, e-mail) par une étiquette avec une empreinte avant d'écrire un log, sans supprimer le champ. Même secret, même étiquette.
- MCP
Model Context Protocol : un standard pour exposer des outils et des sources de données à n'importe quel agent. Un outil MCP se découvre par son nom, sa description et son schéma.
- Mémoire de session
L'historique d'une conversation, qui disparaît quand elle se termine.
- Mémoire long terme
Ce qui survit d'une session à l'autre, rangé par utilisateur : faits, préférences, résumés. Sans propriétaire ni limite, elle fuit et contamine les tests.
- Modèle de fondation tabulaire
Un modèle déjà entraîné sur des millions de tableaux synthétiques : on lui donne un petit tableau d'exemples et il prédit les lignes suivantes, sans long entraînement.
O
- Orchestrateur
Dans un système multi-agents, l'agent qui ne répond jamais lui-même : il route le travail vers des agents spécialisés.
- Outil borné
Un outil qui valide ses arguments avant d'agir, refuse en nommant les valeurs valides, et reste en lecture seule par défaut.
P
- Parser
Le code qui lit la sortie du modèle et la rejette si elle ne respecte pas le schéma : format, champs exacts, types, bornes.
- Politique de rétention
Ce qu'une mémoire garde, pourquoi, comment le corriger, quand ça expire, et ce qu'elle refuse de garder. Écrite avant le premier enregistrement.
- Prompt système
Les instructions fixes données au modèle avant toute conversation. Une règle y réduit un comportement sans l'éliminer, et un prompt trop long est moins bien suivi.
VoirUne donnée n'est jamais un ordreCe qui doit toujours arriver s'impose dans le codeHacktoberfest 2026 · Week 1
R
- RAG
Retrieval-Augmented Generation : chercher des passages dans une base, puis répondre à partir d'eux, en les citant.
- Récupération (retrieval)
L'étape qui cherche dans le corpus les passages utiles à une question, avant d'appeler le modèle. Rien trouvé : on refuse sans appel.
- Refus
Une réponse explicite « je ne peux pas répondre » : pas de citation, confiance nulle, relecture humaine. Un état, pas un crash.
- Refus excessif
Refuser aussi ce à quoi l'agent aurait pu répondre. Sûr, mais moins utile ; on le mesure autant que les erreurs.
- Retry correctif
Un second essai unique où l'on renvoie au modèle l'erreur de son premier essai. Au-delà, refus signalé.
VoirLa sortie du modèle est une donnée non fiableHacktoberfest 2026 · Week 2
- ROC-AUC
Une note entre 0,5 (hasard) et 1 (parfait) qui mesure si le modèle classe bien les cas à risque avant les autres.
- Rollback
Le retour à la dernière version qui marchait, décrit d'avance par une action, un nombre et une unité.
- Routage hybride
Choisir la méthode selon le cas : par exemple un modèle pour un nouveau client, et l'historique du client sinon.
VoirCe qui doit toujours arriver s'impose dans le codeHacktoberfest 2026 · Week 2
S
- Schéma
La forme obligatoire d'une donnée : ses champs, leurs types, leurs bornes.
VoirLa sortie du modèle est une donnée non fiableHacktoberfest 2026 · Weekend
- Seam (couture)
Le point de contact unique entre l'agent et n'importe quel modèle : une seule méthode, et l'on change de fournisseur sans toucher à l'agent.
- Seau d'échec
La catégorie dans laquelle on range une panne avant de la corriger : recherche, choix d'outil, consigne non suivie, format.
- Seuil de décision
Le score à partir duquel on dit « oui ». On le choisit sur une tranche de données à part, jamais sur les données du test final.
- Skill
Une fiche d'instructions que l'assistant charge seulement quand la tâche correspond. Elle se juge à la différence qu'elle fait, preuve à l'appui.
- Slot filling
Remplir les paramètres d'un outil au fil de la conversation : garder ce qui est donné, demander un seul champ manquant à la fois, agir dès que tout est là.
- Smoke test
Un test rapide lancé juste après un déploiement, conçu pour pouvoir dire « ce déploiement est mauvais ».
- Sortie structurée
Demander au modèle de répondre dans un format fixe (du JSON), pour que l'interface affiche toujours la même chose, au même endroit.
VoirLa sortie du modèle est une donnée non fiableHacktoberfest 2026 · Weekend
- SSRF
Server-Side Request Forgery : pousser un outil qui va chercher des URL à appeler une adresse interne ou privée à la place de l'attaquant.
- Surconfiance
Une confiance affichée plus haute que ce que les sources justifient, par exemple 1.0 sur un seul document.
T
- Table de transitions
La liste des couples (état, événement) autorisés et de l'état où chacun mène. Tout couple absent est refusé, et l'état ne bouge pas.
- Tâche planifiée
Un programme que la machine lance toute seule à heure fixe, par exemple chaque matin.
VoirCe qui doit toujours arriver s'impose dans le codeHacktoberfest 2026 · Week 1
- Taux de base
La proportion « normale » dans les données. Un modèle qui répète toujours la réponse la plus fréquente a l'air bon sans rien comprendre.
- Télémétrie
Les statistiques d'usage qu'un logiciel envoie à son éditeur. Certains outils en envoient par défaut ; on peut les couper.
- Température
Le réglage du hasard dans la génération. À 0, les réponses et les appels d'outils deviennent plus stables, sans devenir parfaits.
- Test fresh clone
Cloner son propre dépôt dans un dossier vide et suivre uniquement le README, comme un inconnu, pour voir si ça marche.
VoirVérifier l'effet, pas la paroleHacktoberfest 2026 · Week 2
- Timeout
Une durée maximale d'attente. Passé ce délai, on abandonne l'appel et on renvoie un refus lisible, au lieu d'attendre sans fin.
- Trace
Le journal d'un run : chaque étape (recherche, appel au modèle, appel d'outil, décision) avec ses arguments et son résultat.
V
- Verrouillage optimiste
Chaque écriture porte la version lue juste avant ; si la version a changé entre-temps, l'écriture est refusée. Deux agents ne peuvent pas s'écraser en silence.