Rédiger des fiches outils que le modèle utilise bien
Un agent ne vaut que par les outils qu'on lui donne, et un outil mal nommé ou mal décrit l'amène à se tromper sans bruit. Cette leçon vous apprend à concevoir l'outillage d'un agent et à documenter chaque outil pour que le modèle l'utilise à bon escient et que l'application garde la main sur les actions risquées.
Mis à jour le 29 septembre 2026.
En bref
Un outil d'agent est une fonction que le modèle peut appeler, décrite par un nom, une description, des paramètres et un format de retour. C'est sur cette description que le modèle s'appuie pour choisir le bon outil au bon moment. Un outil mal nommé ou ambigu provoque des erreurs silencieuses, d'où l'importance pour le PM d'en cadrer le périmètre et les risques.
Objectif de la leçon
À la fin de cette leçon, vous serez capable de concevoir l'ensemble d'outils d'un agent (regroupés par tâche, nommés sans ambiguïté) et de rédiger pour chacun une fiche complète : description, paramètres, retour, niveau de risque et contrôles de l'application.
Les questions auxquelles cette leçon répond
Comment décrire un outil pour qu'un agent IA l'utilise correctement ?
Donnez-lui un nom explicite, une description qui dit quand l'utiliser et quand l'éviter, des paramètres clairs avec leurs valeurs possibles et un retour facile à exploiter pour le modèle.
Combien d'outils donner à un agent IA, et comment les nommer ?
Le moins possible : regroupez les outils par tâche plutôt que de calquer chaque appel d'API, et choisissez des noms qui ne laissent aucun doute sur ce que fait chacun.
Comment garder le contrôle sur les actions risquées d'un agent ?
En classant chaque outil par niveau de risque et en faisant vérifier par l'application, pas par le modèle, les droits, les limites et les confirmations avant toute action sensible.
Thèmes abordés
- tool calling
- outils d'un agent
- function calling
- spécification d'outil
- agents IA
Dans le glossaire
Guides sur ce thème
- Écrire une spec pour agent IA
Les sections d’une spec qu’un agent de code exécute sans deviner, avec un modèle SPEC.md.
- MCP pour Product Manager
Connecter l’IA à vos outils et cadrer un serveur MCP : outils, permissions, sécurité, avec un modèle de spec.
Dans quel module
Concevoir des outils que le modèle utilise bien
Quels outils donner à l'agent, comment les décrire, et que se passe-t-il quand ils échouent ?
Leçons du module
- Rédiger des fiches outils que le modèle utilise bien (cette leçon)
- Spécifier les erreurs et l'idempotence des outils
Ce que vous apprendrez dans ce module
Cette leçon fait partie de la formation Concevoir des agents et du tool calling fiables
- Rédiger des fiches outils que le modèle utilise bien (nom, description, paramètres, retour, erreurs, idempotence, niveau de risque).
Formations liées
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Créer un assistant IA pour votre produit
3 h
- IA & ProduitExpertNiveau avancé : pour approfondir et aller plus loin.
Mettre en production et monitorer une fonctionnalité IA
3 h
- IA & ProduitConfirméPratique régulière : vous utilisez déjà l’outil ou êtes confronté à la thématique.
Obtenir des sorties IA fiables et exploitables par le produit (JSON, schémas, appels de fonction)
2 h 30 min