Aller au contenu
Floskool

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

3.2 Écrire une description qui déclenche au bon moment

Leçon gratuite 8 minGroupe Claude Code & IA

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

Suivre gratuitement

La description est le champ le plus sous-estimé. C'est elle que Claude lit pour décider s'il doit confier une tâche à ton agent.

Une mauvaise description

description: Agent de recherche.

Trop vague : recherche de quoi ? Quand ? Claude risque de l'appeler pour n'importe quoi, ou jamais.

Une bonne description

description: Rassemble des faits, des exemples et leurs sources sur un sujet avant toute rédaction. À utiliser au début de chaque nouveau contenu ou quand une information doit être vérifiée.

Elle répond à trois questions :

  1. Que fait l'agent ? Il rassemble des faits, des exemples et leurs sources.
  2. Quand l'utiliser ? Au début d'un nouveau contenu, ou pour vérifier une information.
  3. Qu'est-ce qu'il ne fait pas ? (implicite ici : il ne rédige pas, puisqu'il intervient « avant toute rédaction »).

Garder les descriptions courtes

Les descriptions de tous tes agents sont lues par Claude pour choisir. La documentation recommande des descriptions précises et brèves : deux phrases suffisent largement.

Exercice

Réécris cette description : « Écrit des trucs. »

Correction proposée :

description: Rédige un script de vidéo courte à partir des notes du chercheur, pour l'audience décrite dans CLAUDE.md. À utiliser après la recherche, jamais sans notes.