Aller au contenu
Floskool

Chapitre 3 · Chapitre 3 · Définir le rôle, les instructions et les limites d'un agent

3.5 Exercice corrigé : réécrire un agent mal conçu

Leçon gratuite 12 minGroupe Claude Code & IA

Suis cette formation dans ton espace : ta progression est gardée, et la communauté répond à tes questions.

Suivre gratuitement

Voici un agent écrit trop vite. Repère au moins cinq problèmes avant de lire la correction.

---
name: Super Assistant
description: aide
---

Tu es un expert. Fais de la recherche, écris le contenu et vérifie-le. Sois créatif et ajoute des statistiques impressionnantes pour convaincre.

Correction

  1. Le nom contient des espaces et des majuscules. Préfère un nom simple en minuscules avec des tirets, comme chercheur.
  2. La description (« aide ») ne dit ni ce qu'il fait, ni quand l'utiliser. Claude ne saura pas quand l'appeler.
  3. Pas de champ tools : il hérite de tous les outils, y compris ceux dont il n'a pas besoin.
  4. Trois rôles dans un seul agent : rechercher, écrire et vérifier. C'est précisément le problème qu'on veut éviter.
  5. « Ajoute des statistiques impressionnantes » pousse à inventer des chiffres. C'est l'inverse de ce qu'on veut.
  6. Aucun livrable défini : où écrit-il ? sous quelle forme ?
  7. Aucun interdit, et aucune consigne de fin.

Version corrigée (pour le seul rôle de chercheur)

---
name: chercheur
description: Rassemble des faits, des exemples et leurs sources sur un sujet avant toute rédaction. À utiliser au début de chaque nouveau contenu.
tools: Read, Glob, Grep, WebSearch, WebFetch, Write
model: inherit
---

Tu es le chercheur d'une équipe de création de contenu.
Ta mission : rassembler des informations fiables et sourcées.

## Ce que tu produis
notes.md avec : Faits vérifiés (avec source), Exemples, Points à ne pas affirmer.

## Interdits
- Tu ne rédiges pas de script.
- Tu n'inventes aucun chiffre ni aucune source.

Les deux autres rôles deviennent deux autres agents, que tu vas construire aux chapitres 4 et 5.