Comment rédiger une bonne consigne pour un agent IA
La différence entre une proposition utile et du temps perdu tient souvent à la consigne. Cinq éléments que contient toute bonne consigne.
Deux développeurs confient la même tâche à un agent. Le premier écrit : « Corrige l'export. » Le second écrit cinq phrases. Le second reçoit une proposition qu'il approuve en dix minutes. Le premier reçoit quelque chose qui l'occupe pendant une heure.
Un agent n'est pas un collègue qui travaille dans votre entreprise depuis des années. Il ne sait que ce qui se trouve dans le code et ce que vous lui dites.
Les cinq éléments d'une bonne consigne
1. Ce qui ne va pas ou ce qui doit être fait
Décrivez le résultat attendu, pas uniquement le problème. « Dans l'export PDF, la date affiche le mois et le jour inversés. Elle doit être au format jour/mois/année. »
2. Où cela se trouve
Indiquez le fichier, le module ou l'écran si vous le connaissez. L'agent perd moins de temps à chercher et ne commence pas au mauvais endroit.
3. Comment savoir que c'est terminé
C'est l'élément le plus important. « Il y a un test qui exporte une facture du 3 février et vérifie qu'elle affiche 03/02. » Un point d'arrivée clair fait toute la différence.
4. Ce qui ne doit pas changer
« Ne modifie pas la mise en page du PDF. » « Ne touche pas à la base de données. » Les limites évitent les surprises.
5. Le contexte qui ne figure pas dans le code
« Les clients aux Pays-Bas utilisent le même export. » Ce que vous savez et que le code ne dit pas doit figurer dans la consigne.
Un exemple
La date de l'export PDF des factures est au format mois/jour/année. Elle doit être au format jour/mois/année, comme partout dans l'application. L'export se trouve dans le module de facturation. Ajoute un test qui exporte une facture du 3 février 2026 et vérifie que 03/02/2026 figure dans le PDF. Ne modifie pas la mise en page du PDF.
Cinq phrases. Deux minutes de rédaction. La différence entre une proposition utile et une heure perdue.
Apprendre à rédiger
Rédiger de bonnes consignes est une compétence que votre équipe acquiert vite. Elle fait partie intégrante de nos ateliers en ligne et de chaque implémentation.