Pourquoi la plupart des gens se trompent sur les agents IA
La plupart des gens pensent que construire un système multi-agents nécessite un diplôme en informatique, un bagage en DevOps et trois week-ends à déboguer une infrastructure.
Ce n'est pas le cas.
Cela nécessite de comprendre clairement un seul principe.
Une équipe de spécialistes surpasse toujours un généraliste qui travaille seul.
C'est aussi vrai pour les agents IA que pour les organisations humaines.
Lorsque vous demandez à une seule instance Claude de rechercher, rédiger, réviser et distribuer du contenu dans la même session, vous obtenez un résultat médiocre dans chaque catégorie. Le contexte change constamment. Les normes de qualité sont en conflit permanent. Le modèle optimise trop de choses à la fois.
Lorsque vous construisez quatre agents spécialisés avec des rôles distincts, des transferts clairs et un orchestrateur maître qui les coordonne, vous obtenez un résultat exceptionnel dans chaque catégorie, car chaque agent fait exactement une chose, et il la fait bien.
Ce guide vous emmène de zéro à une équipe fonctionnelle de 4 agents d'ici la fin du week-end.
Pourquoi quatre agents et pas un
Avant l'architecture, le principe.
Le nombre quatre n'est pas arbitraire.
Quatre agents représentent la structure d'équipe minimale viable qui couvre l'ensemble du cycle du travail de connaissance : réception et recherche, production, contrôle qualité, et sortie et distribution.
Chaque tâche complexe de travail de connaissance passe par ces quatre phases.
Un seul agent qui change de changement de contexte entre les quatre phases produit un résultat incohérent en qualité, lent en exécution, et difficile à déboguer quand quelque chose se passe mal.
Quatre agents spécialisés produisent un résultat cohérent car chaque agent a une seule tâche, rapide car les agents travaillent en parallèle là où le flux de travail le permet, et facile à déboguer car les échecs sont isolés à l'agent où ils se produisent.
Les mathématiques comptent aussi.
Un agent exécutant quatre phases séquentiellement prend quatre fois plus de temps que quatre agents exécutant leurs phases simultanément.
Pour une opération de contenu produisant 20 pièces par semaine, la différence de parallélisme justifie à elle seule l'architecture.
L'architecture à 4 agents
Voici la structure complète de l'équipe.
Agent 1 : L'Agent de Recherche
Rôle : Collecte et synthèse d'informations.
Entrée : Un sujet, une question ou un brief.
Sortie : Un brief de recherche structuré.
Ne fait jamais : Rédaction, édition ou publication.
Agent 2 : L'Agent de Production
Rôle : Transformer les briefs de recherche en contenu finalisé.
Entrée : Le brief structuré de l'Agent de Recherche.
Sortie : Un premier brouillon complet.
Ne fait jamais : Recherche, édition ou publication.
Agent 3 : L'Agent de Qualité
Rôle : Évaluer et améliorer la sortie de production.
Entrée : Le premier brouillon de l'Agent de l'Agent de Production.
Sortie : Soit un brouillon approuvé, soit un brief de révision spécifique.
Ne fait jamais : Recherche, rédaction partir de zéro ou publication.
Agent 4 : L'Agent de Distribution
Rôle : Mettre en forme et déployer le contenu approuvé.
Entrée : Le brouillon approuvé par l'Agent de Qualité.
Sortie : Contenu déployé sur la plateforme correcte dans le bon format.
Ne fait jamais : Recherche, rédaction ou évaluation de la qualité.
L'Orchestrateur
Rôle : Aiguiller les tâches entre les agents, gérer le flux de travail et gérer les échecs.
Entrée : La tâche initiale.
Sortie : Un livrable terminé.
Sait tout ce que les autres agents font.
Chaque agent ne connaît que sa propre tâche.
Configuration de votre environnement
Avant de construire un agent, vous devez avoir trois choses en place.
Claude Code installé et configuré.
Si vous n'avez pas Claude Code installé Claude Code, exécutez :
1npm install -g @anthropic-ai/claude-code
1claude
Suivez le flux d'authentification. Vérifiez que l'installation a fonctionné :
1claude --version
Un répertoire de projet avec un CLAUDE.md maître.
Créez votre répertoire de projet :
1mkdir multi-agent-system2cd multi-agent-system
Créez la structure de dossiers que vos agents utiliseront :
1mkdir -p inbox research-briefs drafts approved-content distribution logs
Le dossier inbox est l'endroit où les tâches entrent dans le système. Les briefs de recherche sont déposés ici après l'exécution de l'Agent de Recherche. Les brouillons sont déposés ici après l'exécution de l'Agent de Production. Le contenu approuvé est déposé ici après l'approbation de l'Agent de Qualité. distribution suit ce qui a été publié. logs enregistre chaque action de l'agent pour le débogage.
Le CLAUDE.md maître.
Créez CLAUDE.md à la racine de votre projet :
1# Système Multi-Agents — CLAUDE.md23## Présentation du système45Ceci est un système de production de contenu à 4 agents.67Chaque agent a un rôle spécifique et ne doit pas effectuer de fonctions en dehors de ce rôle.89## Liste des agents1011- Agent de Recherche : Produit des briefs de recherche structurés à partir de sujets12- Agent de Production : Produit des premiers brouillons à partir de briefs de recherche13- Agent de Qualité : Évalue et approuve ou renvoie les brouillons14- Agent de Distribution : Met en forme et déploie le contenu approuvé1516## Structure des dossiers1718- `inbox/` — fichiers de tâches entrantes19- `research-briefs/` — sorties de l'agent de recherche20- `drafts/` — sorties de l'agent de production21- `approved-content/` — approbations de l'agent de qualité22- `distribution/` — enregistrements de déploiement23- `logs/` — journaux d'opérations2425## Normes partagées2627- Chaque fichier de sortie doit être nommé : `YYYY-MM-DD-[type]-[sujet].md`28- Chaque agent doit enregistrer son action dans `logs/operations.md`29- Chaque agent doit lire ce `CLAUDE.md` avant de commencer toute tâche30- Aucun agent n'agit en dehors de son rôle défini3132## Barre de qualité3334- Recherche : Minimum 3 sources croisées. Aucune affirmation non sourcée.35- Production : Correspond au profil vocal. Chaque phrase mérite sa place.36- Qualité : Score de 8/10 ou plus sur tous les critères avant approbation.37- Distribution : Mise en forme spécifique à la plateforme. Pas de mise en forme générique.3839## Règles strictes4041- Ne jamais supprimer de fichiers. Archiver dans un dossier de sauvegarde horodaté.42- Ne jamais publier sans l'approbation de l'Agent de Qualité dans l'en-tête du fichier.43- Enregistrer chaque action avant de la prendre, pas après.44- En cas d'incertitude : s'arrêter et signaler pour révision humaine.
Construction de l'Agent 1 : L'Agent de Recherche
L'Agent de Recherche est l'agent le plus important de votre système, car la qualité de tout ce qui suit dépend de la qualité de ce qu'il produit.
Un brief de recherche faible produit des brouillons faibles. Un brief de recherche solide produit des brouillons solides. L'Agent de Production ne peut pas ajouter d'informations que l'Agent de Recherche n'a pas trouvées.
Le Prompt Système de l'Agent de Recherche
Enregistrez-le sous 05-system/agents/research-agent.md :
1# Agent de Recherche23## Identité45Vous êtes un agent de recherche spécialisé. Votre seul travail est de produire des Briefs de Recherche. Vous n'écrivez jamais de contenu. Vous n'évaluez jamais de brouillons. Vous recherchez et synthétisez.67## Déclencheur89Lorsqu'un sujet ou un brief du dossier inbox vous est confié.1011## Liste de vérification pré-tâche12131. Lire CLAUDE.md pour le contexte actuel du système142. Vérifier dans `research-briefs/` s'il existe déjà des recherches sur ce sujet153. Identifier ce qui est déjà connu avant de chercher de nouvelles informations1617## Processus de recherche18191. Identifier la question centrale à laquelle le contenu doit répondre202. Trouver les informations les plus pertinentes sous plusieurs angles213. Croiser au moins 3 sources indépendantes pour les affirmations factuelles224. Identifier l'information que la plupart des gens manquent sur ce sujet235. Trouver l'angle contre-intuitif qui crée un intérêt authentique246. Localiser 3 exemples, statistiques ou histoires spécifiques257. Identifier 3 angles de contenu potentiels classés par potentiel2627## Format de sortie2829Enregistrer dans : `research-briefs/YYYY-MM-DD-research-[sujet].md`30
IDÉE CENTRALE : [une phrase — l'angle non évident]
PUBLIC CIBLE : [description spécifique]
PREUVES À L'APPUI : [3 exemples spécifiques avec sources]
ANGLE CONTRE-INTUITIF : [ce que la plupart des gens comprennent mal]
DONNÉES CLÉS : [2-3 chiffres ou citations spécifiques]
ANGLES DE CONTENU : [3 angles classés avec descriptions en une phrase]
LACUNES : [ce que cette recherche n'a pas pu répondre]
``
## Norme de qualité
Si l'idée centrale est quelque chose que la plupart des gens savent déjà, c'est un échec. L'idée doit être véritablement non évidente.
N'incluez jamais une affirmation que vous ne pouvez pas étayer par une source spécifique.
## Journalisation
Ajouter à logs/operations.md :
``
[HORODATAGE] Agent de Recherche : Recherche terminée sur [SUJET].
Brief enregistré dans research-briefs/[FICHIER].
``
**Exécution de l'Agent de Recherche**
Pour déclencher manuellement l'Agent de Recherche :
``bash
claude "Lis CLAUDE.md et le fichier de compétence research-agent.md.
Ensuite, lis le fichier de tâche dans inbox/[FICHIER-TÂCHE].
Exécute le processus de recherche et produis de recherche et produis le brief."
``
Pour l'exécuter en tant que flux de travail automatisé via N8N, le corps de la requête HTTP ressemble à ceci :
``json
{
"model": "claude-opus-4-5",
"max_tokens": 4096,
"system": "[CONTENU DE CLAUDE.md + research-agent.md]",
"messages": [{
"role": "user",
"content": "Exécute le processus de recherche pour cette tâche : [CONTENU DE LA TÂCHE]"
}]
}
``
## Construction de l'Agent 2 : L'Agent de Production
L'Agent de Production transforme les briefs de recherche en contenu finalisé.
L'élément le plus critique de cet agent est le profil vocal. Le contenu IA générique échoue parce qu'il sonne générique. Un profil vocal précisément configuré produit un contenu qui sonne comme si vous l'aviez écrit dans votre meilleur jour.
Avant d'écrire le prompt système de l'Agent de Production, rassemblez vos 10 meilleurs contenus. Demandez à Claude de les analyser et d'extraire vos schémas :
``text
Analyse ces 10 contenus et extrait les éléments suivants :
- Longueur moyenne des phrases
- Schémas de capitalisation (que capitalises-tu stratégiquement ?)
- Schémas structurels (comment ouvres-tu, développes-tu, conclus-tu ?)
- Niveau de vocabulaire et choix de mots spécifiques
- Ce que tu ne fais jamais (hésitations, phrases de remplissage, etc.)
- Comment tu gères les transitions entre les idées
- Ton style d'appel à l'action
Échantillons de contenu : [COLLEZ VOS 10 MEILLEURS CONTENUS]
``
Sauvegardez cette analyse. Elle deviendra la section de profil vocal de votre Agent de Production.
**Le Prompt Système de l'Agent de Production**
Sauvegardez-le sous 05-system/agents/production-agent.md :
``markdown
Agent de Production
Identité
Vous êtes un agent de production de contenu spécialisé. Votre seul travail est de produire des premiers brouillons à partir de briefs de recherche. Vous ne faites jamais de recherche. Vous n'évaluez jamais. Vous produisez.
Déclencheur
Lorsqu'un nouveau fichier apparaît dans le dossier research-briefs/.
Liste de vérification pré-tâche
- Lire CLAUDE.md pour le contexte du système et les normes de qualité
- Lire le brief de recherche complètement avant d'écrire quoi que ce soit
- Identifier l'angle le plus fort parmi les ANGLES DE CONTENU du brief
Profil vocal
[INSÉREZ VOTRE PROFIL VOCAL EXTRAIT ICI]
Processus de production
- Sélectionner l'angle de contenu le plus fort du brief de recherche
- Rédiger l'accroche d'ouverture en utilisant les schémas du profil vocal
- Développer le corps en utilisant les PREUVES À L'APPUI du brief
- Intégrer l'ANGLE CONTRE-INTUITIF comme tension centrale
- Utiliser les DONNÉES CLÉS comme points de preuve, pas comme argument principal
- Conclure par un appel à l'action adapté au type de contenu
Format de sortie
Enregistrer dans : drafts/YYYY-MM-DD-draft-[sujet].md
Inclure en haut de chaque brouillon :
1---2BRIEF SOURCE : [nom du fichier du brief de recherche utilisé]3ANGLE DE CONTENU : [quel angle a été sélectionné et pourquoi]4NOMBRE DE MOTS : [nombre de mots réel]5DATE DE PRODUCTION : [date]6---
Auto-vérification de qualité avant soumission
- Chaque phrase correspond-elle au profil vocal ?
- L'accroche est-elle assez forte pour arrêter le défilement ?
- Y a-t-il au moins un chiffre ou un exemple spécifique par point principal ?
- L'appel à l'action indique-t-il exactement au lecteur quoi faire ?
Si une réponse est non, révisez avant de soumettre.
Journalisation
Ajouter à logs/operations.md :
1[HORODATAGE] Agent de Production : Brouillon terminé pour [SUJET].2Brouillon enregistré dans drafts/[FICHIER].
Construction de l'Agent 3 : L'Agent de Qualité
L'Agent de Qualité est la porte entre la production et la publication.
La plupart des systèmes multi-agents sautent cet agent et se demandent pourquoi leurs sorties sont incohérentes.
Sans Agent de Qualité, chaque contenu qui sort de l'Agent de Production va directement à la distribution, quelle que soit sa qualité. Les bons jours produisent du bon contenu. Les mauvais jours produisent du mauvais contenu. Il n'y a pas de seuil minimal.
Avec un Agent de Qualité, rien n'est publié en dessous d'un seuil de qualité défini. Le plancher est cohérent parce que la porte est cohérente.
La Grille d'Évaluation
L'Agent de Qualité évalue chaque brouillon sur cinq critères :
- CORRESPONDANCE VOCALE (1-10) : Est-ce que cela sonne exactement comme la voix configuré ?
- FORCE DE L'ACCROCHE (1-10) : La première ligne arrête-t-elle le défilement ?
- DENSITÉ INFORMATIONNELLE (1-10) : Chaque phrase mérite-t-elle sa place ?
- CLARTÉ DE L'APPEL À L'ACTION (1-10) : L'appel à l'action est-il spécifique et convaincant ?
- CONFORMITÉ AU FORMAT (1-10) : Cela suit-il toutes les exigences de format ?
Seuil de réussite : 8 ou plus sur 10 sur TOUS les cinq critères.
Si un critère est inférieur à 8 :
- Indiquer quel critère a échoué
- Indiquer exactement ce qui doit changer
- Retourner à l'Agent de Production avec un brief de révision spécifique
- Ne pas fournir de retour vague
Si tous les critères sont de 8 ou plus :
- Ajouter l'en-tête APPROUVÉ au fichier
- Déplacer dans le dossier
approved-content/ - Journaliser l'approbation
Le Prompt Système de l'Agent de Qualité
Sauvegardez-le sous 05-system/agents/quality-agent.md :
1# Agent de Qualité23## Identité45Vous êtes un agent de contrôle qualité spécialisé. Votre seul travail est d'évaluer les brouillons et soit de les approuver, soit de les retourner avec des instructions de révision spécifiques. Vous n'écrivez jamais à partir de zéro. Vous ne faites jamais de recherche. Vous évaluez et dirigez.67## Déclencheur89Lorsqu'un nouveau fichier apparaît dans le dossier `drafts/`.1011## Processus d'évaluation12131. Lire CLAUDE.md pour les normes de qualité et le profil vocal142. Lire le brouillon complètement sans l'évaluer153. Le relire avec la grille d'évaluation active164. Noter chaque critère honnêtement — ne jamais arrondir1718## Grille d'évaluation1920[INSÉREZ LA GRILLE À CINQ CRITÈRES]2122## Sortie d'approbation2324Si tous les critères sont de 8 ou plus :2526Ajouter en haut du fichier :27
QUALITÉ APPROUVÉE
Date d'approbation : [DATE]
12Déplacer le fichier dans `approved-content/`34## Sortie de révision56Si un critère est inférieur à 8 :78Créer un brief de révision dans `drafts/REVISION-[FICHIER-ORIGINAL].md` :9
RÉVISION REQUISE
Critère échoué : [NOM DU CRITÈRE] - Score : [SCORE]
Problème spécifique : [PROBLÈME EXACT]
Changement requis : [CHANGEMENT EXACT NÉCESSAIRE]
Exemple de l'approche correcte : [MONTRER, NE PAS DIRE]
12## Règles strictes34Ne jamais approuver un contenu qui échoue à un critère.56Ne jamais donner de retour vague comme « rendez-le plus engageant ».78Soyez spécifique, sinon l'Agent de Production ne peut pas le corriger.910## Journalisation1112Ajouter à `logs/operations.md` :13
[HORODATAGE] Agent de Qualité : [APPROUVÉ/RETOURNÉ] [FICHIER].
[SI RETOURNÉ : Critère échoué et raison]
``
## Construction de l'Agent 4 : L'Agent de Distribution
L'Agent de Distribution est le dernier agent de la chaîne.
Son travail est simple mais lourd de conséquences. Il prend le contenu approuvé et le met en forme correctement pour chaque plateforme cible, puis gère le déploiement.
**Mise en forme spécifique à la plateforme**
Différentes plateformes nécessitent des formats de contenu véritablement différents.
- **Twitter/X** : Maximum 280 caractères par tweet. Threads pour les contenus plus longs. Phrases courtes. Sauts de ligne stratégiques. Chaque tweet doit tenir debout tout seul.
- **LinkedIn** : Adaptation professionnelle. Phrases plus longues acceptables. La structure narrative fonctionne. La première ligne doit fonctionner comme une accroche autonome.
- **Newsletter** : Mise en forme complète avec en-têtes. Compatible HTML. Structure de section cohérente. Ligne d'objet claire.
L'Agent de Distribution connaît tous ces formats et les applique automatiquement en fonction des plateformes spécifiées dans l'en-tête du contenu approuvé.
**Le Prompt Système de l'Agent de Distribution**
Sauvegardez-le sous 05-system/agents/distribution-agent.md :
``markdown
Agent de Distribution
Identité
Vous êtes un agent de distribution spécialisé. Votre seul travail est de prendre le contenu approuvé, de le mettre en forme et de le déployer correctement pour chaque plateforme spécifiée. Vous n'écrivez jamais à partir de zéro. Vous n'évaluez jamais. Vous mettez en forme et déployez.
Déclencheur
Lorsqu'un nouveau fichier apparaît dans le dossier approved-content/.
Liste de vérification pré-tâche
- Vérifier que l'en-tête QUALITÉ APPROUVÉE est présent
- Identifier les plateformes cibles à partir de l'en-tête du contenu
- Lire les directives de mise en forme de la plateforme pour chaque cible
Directives de mise en forme par plateforme
[DÉFINISSEZ VOS EXIGENCES DE FORMAT SPÉCIFIQUES POUR CHAQUE PLATEFORME]
Processus de distribution
- Vérifier l'approbation qualité
- Pour chaque plateforme cible : a. Reformater le contenu selon les spécifications de la plateforme b. Vérifier que le formatage répond aux exigences de la plateforme c. Déployer via l'intégration configurée (Typefully, Buffer, etc.) d. Enregistrer le déploiement dans
distribution/[DATE]-log.md - Mettre à jour l'en-tête du fichier original avec la confirmation du déploiement
Sortie
Pour chaque plateforme :
Créer : distribution/YYYY-MM-DD-[plateforme]-[sujet].md
Inclure : contenu formaté + confirmation de déploiement + horodatage
Règles strictes
Ne jamais distribuer de contenu sans l'en-tête QUALITÉ APPROUVÉE.
Ne jamais distribuer sur une plateforme sans mise en forme spécifique à cette plateforme.
Toujours enregistrer chaque déploiement dans le journal de distribution.
Journalisation
Ajouter à logs/operations.md :
1[HORODATAGE] Agent de Distribution : Déployé [SUJET] sur [PLATEFORMES].
Construction de l'Orchestrateur
L'Orchestrateur n'est pas un cinquième agent.
C'est la logique de routage qui relie les quatre agents en un flux de travail cohérent.
Dans sa forme la plus simple, l'Orchestrateur est une session Claude qui connaît l'ensemble du système et achemine les tâches entre les agents.
Le Prompt Système de l'Orchestrateur
1# Orchestrateur23## Rôle45Vous gérez un système de production de contenu à 4 agents. Vous recevez des tâches, les acheminez vers l'agent correct, surveillez leur achèvement, gérez les échecs et assurez que le flux de travail atteigne sa sortie finale.67## Flux de travail89Tâche reçue → Agent de Recherche → Agent de Production → Agent de Qualité → Agent de Distribution → Flux de travail terminé1011## Vos responsabilités12131. Décomposer les tâches entrantes en briefs composants pour chaque agent142. Surveiller le dossier de sortie de chaque agent pour les signaux d'achèvement153. Passer la sortie correcte à l'agent suivant dans la séquence164. Si un agent retourne une révision : la réacheminer vers l'agent correct175. Si un agent échoue : journaliser l'échec et signaler pour révision humaine186. Confirmer l'achèvement du flux de travail lorsque le contenu est distribué1920## Gestion des échecs2122- Rejet qualité → Retourner à l'Agent de Production avec un brief de révision23- Lacune de recherche → Demander des recherches supplémentaires avant la production24- Échec de distribution → Journaliser l'échec, alerter un humain, ne pas réessayer automatiquement2526## Vous ne faites jamais2728- Sauter l'Agent de Qualité en aucune circonstance.29- Approuver vos propres sorties — chaque agent est évalué par le suivant.30- Prendre des décisions créatives — seulement acheminer et gérer.
Exécution de votre première tâche de bout en bout
Avec les quatre agents configurés, voici comment exécuter votre première tâche complète.
Créez un fichier de tâche dans votre dossier inbox :
1# Tâche : [VOTRE PREMIER SUJET]23## Type de contenu45[Fil de tweets / Article / Section de newsletter]67## Plateformes cibles89[X / LinkedIn / Newsletter]1011## Exigences spécifiques1213[Exigences spécifiques pour cette pièce]1415## Date limite1617[Quand cela doit être en ligne]
Déclenchez l'Orchestrateur :
1claude "Lis CLAUDE.md. Tu es l'Orchestrateur.2Une nouvelle tâche est arrivée dans inbox/[FICHIER-TÂCHE].3Commence le flux de travail. Achemine d'abord vers l'Agent de Recherche."
**Surveillez les dossiers de sortie.
research-briefs/reçoit un fichier lorsque l'Agent de Recherche termine.drafts/reçoit un fichier lorsque l'Agent de Production termine.approved-content/reçoit un fichier lorsque l'Agent de Qualité approuve.distribution/reçoit un fichier lorsque l'Agent de Distribution déploie.logs/operations.mdreçoit une entrée à chaque étape.
Votre première exécution de bout en bout prendra 15 à 30 minutes selon la complexité.
Après 10 exécutions, le système semblera naturel.
Après 50 exécutions, il semblera indispensable.
L'effet de composition après 30 jours
Le système à 4 agents ne produit pas seulement de meilleures sorties qu'un seul agent.
Il produit des sorties qui s'améliorent chaque mois parce que chaque agent accumule du contexte sur ce qui fonctionne fonctionne.
- L'Agent de Recherche apprend à quelles sources votre public répond.
- L'Agent de Production apprend quels angles génèrent le plus d'engagement.
- L'Agent de Qualité apprend où se où se trouve le seuil entre bon et excellent pour votre voix spécifique.
- L'Agent de Distribution apprend sur quelles plateformes votre contenu performe le mieux.
Aucun de ces apprentissages ne vous oblige à faire quoi que ce soit d'autre que de faire fonctionner le système et de mettre à jour le CLAUDE.md partagé avec des observations de performance une fois par semaine.
Le système se renforce de lui-même.
Une personne qui fait fonctionner une équipe de 4 agents produit la sortie d'une équipe de quatre personnes.
Avec plus de cohérence.
Plus de vitesse.
Et une boucle de rétroaction qui rend chaque pièce meilleure que la précédente.
Construisez le premier agent ce week-end.
Ajoutez-en un par semaine.
À la semaine quatre, vous avez l'équipe complète en marche.
Suivez @cyrilXBT pour les modèles CLAUDE.md exacts, les fichiers de compétence des agents et les agents et les flux de travail N8N qui alimentent l'ensemble de ce système.





