Chapter 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
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeLa 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 :
- Que fait l'agent ? Il rassemble des faits, des exemples et leurs sources.
- Quand l'utiliser ? Au début d'un nouveau contenu, ou pour vérifier une information.
- 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.