Guide Pratique Des 3 Couches Que Tout Le Monde Confond
La plupart des gens parlent des agents IA comme s'il s'agissait d'une seule chose.
Ce n'est pas le cas.
Quand un agent dépasse le stade de la démonstration ludique et commence à manipuler des fichiers, des API, des documents, des clients ou du code de production, vous ne faites plus simplement « prompter un modèle ».
Vous concevez un système.
Et dans ce système, trois idées sont constamment mélangées :
- L'ingénierie du harnais
- L'ingénierie de la boucle
- L'ingénierie du graphe
Elles reposent toutes sur le même modèle.
Elles affectent toutes la fiabilité.
Et oui, elles peuvent toutes contenir des boucles.
Mais elles résolvent des problèmes différents.
Si vous les confondez, vous finissez par déboguer la mauvaise couche.
La Réponse en 30 Secondes
Voici la version claire :
- L'ingénierie du harnais construit l'environnement autour du modèle
- L'ingénierie de la boucle conçoit le cycle répété de travail et de retour d'information
- L'ingénierie du graphe rend la topologie du workflow explicite
Un bon modèle mental est :
Environnement → Feedback → Flux
- Le harnais donne au modèle des outils, de la mémoire, du contrôle et un espace de travail
- La boucle décide comment le travail est relancé, vérifié et amélioré
- Le graphe définit quelle étape est autorisée à se produire ensuite
Voilà la différence.
Pourquoi Ces Termes Comptent Maintenant
Un modèle brut ne peut pas faire de travail réel tout seul.
Il ne peut pas :
- maintenir l'état du projet entre les sessions
- appeler des outils en toute sécurité
- inspecter un navigateur
- appliquer des permissions
- relancer un travail échoué
- valider la qualité de la sortie
- router des tâches entre des spécialistes
- s'arrêter au bon moment
Tout cela vient du système qui l'entoure.
À mesure que les logiciels agentiques mûrissent, une stack pratique émerge :
- Le harnais donne au modèle des conditions de fonctionnement
- Les boucles rendent le travail répétable et vérifiable
- Le graphe rend les workflows complexes explicites et contrôlables
Une fois que vous voyez ces trois couches séparées, une grande partie de la confusion sur l'architecture IA disparaît.
Ce Qu'un Harnais Sérieux Inclut Habituellement
- Injection de Contexte
Ce que le modèle voit avant d'agir :
- instructions
- connaissances récupérées
- état de la conversation
- mémoire
- politiques
- règles spécifiques à la tâche
- Surfaces d'Action
Ce que le modèle peut faire :
- appels API
- actions navigateur
- commandes shell
- exécution de code
- outils MCP
- bases de données
- fonctions personnalisées
- Persistance
Ce qui survit dans le temps :
- fichiers
- points de contrôle
- état de session
- journaux de progression
- historique git
- mémoire à long terme
- Contrôle d'Exécution
Comment l'exécution est gérée :
- relances
- timeouts
- budgets
- sélection de modèle
- création de sous-agents
- portes d'approbation
- Sécurité et Gouvernance
Ce qui maintient le système sûr :
- permissions au plus bas niveau
- isolation
- listes blanches
- gestion des secrets
- approbation humaine
- Observabilité
Ce qui permet de le déboguer :
- traces
- entrées et sorties des outils
- transitions d'état
- latence
- coût
- résultats d'évaluation
Pourquoi l'Ingénierie du Harnais est Importante
Deux équipes peuvent utiliser le même modèle et obtenir des résultats complètement différents.
Pourquoi ?
Parce qu'une équipe donne au modèle :
- des outils propres
- un état stable
- une mémoire structurée
- des permissions claires
- une exécution observable
Et l'autre lui donne :
- un prompt vague
- des outils désordonnés
- un contexte bruyant
- aucune mémoire
- aucune vérification
Le modèle peut être le même.
Les conditions de travail, non.
L'ingénierie du harnais est importante chaque fois que l'agent :
- ne peut pas accéder à la bonne capacité
- perd le contexte entre les sessions
- agit de manière incohérente selon les environnements
- ne peut pas être audité
- a trop de permissions
- ne peut pas se rétablir proprement après une interruption
Si le modèle ne peut pas fonctionner de manière fiable, le premier endroit à regarder est le harnais.
2. Ingénierie de la Boucle
Ce Que C'est
Chaque agent utilisant des outils a déjà une petite boucle intégrée :
- appeler le modèle
- observer le résultat
- exécuter des outils
- renvoyer les observations
- répéter jusqu'à la fin
L'ingénierie de la boucle commence lorsque vous concevez intentionnellement des cycles supplémentaires autour de ce comportement.
Pas juste « demander à nouveau ».
Pas juste « réessayer ».
Mais un véritable système de travail et de feedback.
Anatomie d'une Bonne Boucle
Déclencheur
Qu'est-ce qui commence un nouveau cycle ?
- demande utilisateur
- test échoué
- nouveau document
- exécution planifiée
- webhook
- retour d'évaluateur
Objectif
Quelle condition spécifique essayons-nous d'atteindre ?
Pas « continuer à s'améliorer ».
Une cible réelle.
État
De quoi le prochain cycle a-t-il besoin ?
- brouillon actuel
- tentative précédente
- résultats des outils
- erreurs
- statut de progression
Politique d'Action
Qu'est-ce que l'agent est autorisé à faire ?
- éditer
- déléguer
- appeler des outils
- dépenser des tokens
- écrire des fichiers
- ouvrir des PR
Preuve
Comment savons-nous si cela a fonctionné ?
- tests
- validation de schéma
- citations
- diffs
- métriques
- approbation du relecteur
Feedback
Qu'est-ce qui a exactement échoué ?
Le feedback doit être compact et actionnable.
Règle d'Arrêt
Quand cela se termine-t-il ?
- succès
- timeout
- budget épuisé
- nombre maximum de relances atteint
- échec irrécupérable
- escalade vers un humain
Le Principe le Plus Important de l'Ingénierie de la Boucle
**Ne bouclez pas sur la confiance.
Bouclez sur la preuve.**
« L'agent dit que c'est fini » n'est pas une condition d'arrêt.
Une vraie condition d'arrêt ressemble plutôt à :
- les tests passent
- le schéma valide
- les citations se résolvent
- le relecteur approuve
- la vérification de politique est propre
Voilà l'ingénierie de la boucle.
Pourquoi l'Ingénierie de la Boucle n'est Pas Juste de l'Ingénierie de Prompt
Un prompt dit au modèle quoi faire pendant un appel.
Une boucle définit ce que le système fait après l'appel.
Cela inclut :
- comment il vérifie les résultats
- comment il réagit aux échecs
- comment il persiste la progression
- comment il décide de continuer
- comment il se termine
Le prompting améliore une réponse.
Une boucle améliore un processus.
C'est un problème d'ingénierie très différent.
3. Ingénierie du Graphe
Ce Que C'est
L'ingénierie du graphe rend la structure du workflow explicite.
Elle répond à une question différente :
Pas seulement « que doit faire l'agent ? » Mais « qu'est-ce qui est autorisé à se produire ensuite ? »
En ingénierie du graphe :
- les étapes sont des nœuds
- les transitions sont des arêtes
- le branchement est explicite
- le travail parallèle est explicite
- les jonctions sont explicites
- les relances sont explicites
- les interruptions humaines sont explicites
Le graphe devient la carte de contrôle du système.
Ce Que les Ingénieurs de Graphe Conçoivent Réellement
Limites des Nœuds
Ce qui appartient à :
- une fonction déterministe
- un appel LLM
- un agent spécialiste
- une étape de relecture humaine
Schéma d'État
Ce que chaque nœud peut lire ou écrire.
Conditions de Routage
Quelle preuve déplace le travail :
- en avant
- en arrière
- latéralement
- vers une escalade
Concurrence
Ce qui peut s'exécuter en parallèle, et ce qui doit attendre.
Cycles et Sorties
Où les relances sont autorisées, combien sont autorisées, et comment elles s'arrêtent.
Durabilité
Où les points de contrôle se produisent et comment le workflow reprend après une interruption.
Quand les Graphes Valent la Peine
Les graphes sont précieux lorsque le processus comporte :
- un branchement significatif
- des approbations
- des transferts entre spécialistes
- du travail parallèle
- des chemins de récupération
- des workflows multi-étapes avec des points de contrôle explicites
Ils sont moins utiles lorsque le travail consiste simplement à :
« Donner quelques outils à un agent et le laisser travailler. »
Dans ce cas, un harnais solide plus quelques boucles peuvent suffire.
Un graphe ajoute de la clarté, mais il ajoute aussi de la structure.
Trop de structure trop tôt peut rendre le système fragile.
Comment les 3 Couches Fonctionnent Ensemble
Imaginons que vous construisiez un agent de recherche et de publication.
Il doit :
- cadrer un sujet
- rassembler des sources
- filtrer les citations
- rédiger un rapport
- passer une revue juridique
- publier seulement après approbation
Voici comment les couches se cartographient :
Harnais
Fournit :
- accès navigateur
- outils de recherche
- espace de travail fichiers
- mémoire
- citations
- approbations
- traces
- routage de modèle
Boucle
Gère :
- la relance de la récupération de sources lorsque les preuves sont faibles
- la correction des échecs de citation
- l'exécution de vérifications de notation
- l'actualisation du travail lorsque le marché change
Graphe
Contrôle le chemin :
- cadrage
- recherche
- filtrage
- synthèse
- rédaction
- relecture
- publication
Avec une porte humaine avant la publication.
C'est pourquoi les 3 couches ne sont pas interchangeables.
Elles travaillent ensemble, mais elles ne sont pas la même chose.
Diagnostiquez l'Échec Avant de Choisir la Solution
Voici la règle pratique :
Si l'agent ne peut pas fonctionner, corrigez le harnais
Exemples :
- accès à un outil manquant
- état obsolète
- mémoire faible
- mauvaises permissions
- aucune observabilité
Si l'agent fonctionne presque mais est peu fiable, corrigez la boucle
Exemples :
- le premier brouillon est proche mais faible
- le succès est inconstant
- les relances sont incontrôlées
- il n'y a pas de preuve d'achèvement
Si le processus lui-même est complexe, corrigez le graphe
Exemples :
- nombreux spécialistes
- approbations
- logique de branchement
- chemins parallèles
- transferts structurés
Erreurs Courantes
1. Construire le Graphe Trop Tôt
Les équipes schématisent souvent un workflow énorme avant de voir comment le travail se comporte réellement.
Meilleure approche :
- commencer avec un harnais plus simple
- collecter des traces
- trouver les motifs stables
- formaliser seulement ce qui mérite un contrôle
2. Laisser le Même Modèle Écrire et Noter Sans Garde-fous
L'auto-relecture peut aider, mais elle partage les mêmes angles morts.
Préférez :
- des vérifications déterministes quand c'est possible
- un contexte de relecteur séparé
- des évaluateurs externes
- une approbation humaine pour les actions à fort impact
3. Utiliser « Continue d'Essayer » Comme Boucle
Ce n'est pas une conception de boucle.
C'est une fuite de coût incontrôlée.
Chaque boucle a besoin :
- d'un objectif mesurable
- de vraies preuves
- de limites de relance
- de règles d'escalade
4. Traiter le Harnais Comme un Tiroir à Bazar
Plus d'outils ne signifie pas automatiquement de meilleurs agents.
Trop d'outils créent :
- des erreurs de sélection
- un contexte bruyant
- une fiabilité faible
- une surface de risque plus large
Un bon harnais n'est pas encombré.
Il est précis.
5. Blâmer le Modèle pour les Échecs d'Orchestration
Un modèle ne peut pas compenser :
- des API cassées
- un état obsolète
- des conditions de sortie manquantes
- des schémas d'outils vagues
- des modes de défaillance invisibles
Corrigez la couche qui possède l'échec.
Une Checklist Simple pour la Production
Harnais
- Les outils sont-ils précis et documentés ?
- L'état est-il durable ?
- Les permissions sont-elles au plus bas niveau ?
- Les opérateurs peuvent-ils mettre en pause, inspecter et reprendre ?
- Les traces sont-elles visibles ?
Boucle
- Quelle preuve prouve le succès ?
- Quel feedback est retourné en cas d'échec ?
- Combien de relances sont autorisées ?
- Quelle est la règle d'arrêt ?
- Que se passe-t-il quand le budget est épuisé ?
Graphe
- Quels chemins doivent être déterministes ?
- Qu'est-ce qui peut s'exécuter en parallèle ?
- Où sont les portes humaines ?
- Quel état est partagé ?
- Où commencent les chemins de récupération ?
Évaluation
- Pouvez-vous rejouer des traces réelles ?
- Pouvez-vous comparer des versions ?
- Pouvez-vous attribuer une amélioration à un changement réel ?
Opérations
- Suivez-vous le coût ?
- la latence ?
- le taux d'échec ?
- le taux d'intervention ?
- le succès des tâches en production ?
La Façon la Plus Simple de Se Rappeler la Différence
Si vous ne retenez qu'une chose, retenez ceci :
- L'ingénierie du harnais rend le modèle opérationnel
- L'ingénierie de la boucle rend le travail itératif et vérifiable
- L'ingénierie du graphe rend le chemin d'exécution explicite et contrôlable
Aucune ne remplace les autres.
Un graphe parfait ne sauvera pas un harnais faible.
Un harnais solide gaspillera quand même de l'argent sans bonnes boucles.
Et des boucles propres deviennent difficiles à gérer quand les branchements et les approbations restent cachés dans du code ad hoc.
Des systèmes agentiques fiables apparaissent quand les 3 couches sont conçues intentionnellement.
C'est la véritable stack d'architecture.
Dernier Point à Retenir
Les gens continuent de parler des agents IA comme si la percée était le modèle.
En production, ce n'est rarement le vrai différenciateur.
Le différenciateur, c'est le système autour du modèle :
- le harnais qui lui permet de travailler
- les boucles qui lui permettent de s'améliorer
- le graphe qui lui permet de fonctionner sous contrôle
C'est ainsi que les agents jouets deviennent de vrais systèmes.
Si vous avez lu jusqu'ici :
- METTEZ CE PAGE EN FAVORIS.
- Suivez @LunarResearcher
- Suivez ma Substack
- Suivez ma Chaîne Telegram Privée
