Des outils MCP qui disent à l'agent IA ce qu'ils font

Un retour de terrain, tiré d'une vraie heure de travail : sur un compte où la génération IA n'était pas facturée du tout, l'agent ne l'a utilisée aucune fois. Notre outil de compte ouvrait son paragraphe IA par c'est facturé à l'usage. L'agent y a vu une alerte budgétaire et s'est tenu à l'écart. La bonne nouvelle, rien ne serait facturé, n'arrivait que plus tard, une fois le storyboard déjà envoyé.

L'outil de compte commence maintenant par ce à quoi le compte a droit, et indique dans un champ simple si la génération est facturée. Gratuit se lit comme une invitation ; facturé se lit d'abord comme une possibilité, puis comme un budget, avec le réglage qui plafonne la dépense plutôt qu'un appel à s'abstenir. Sa description commence aussi par dire de l'appeler en premier et nomme les étapes suivantes. Beaucoup de clients cachent désormais les outils derrière une recherche : être trouvé et compris d'emblée, c'est ce qui compte.

Un agent pouvait lancer un film, lire le plan, constater qu'il ne convenait pas, puis devait attendre la fin. Il existe maintenant un outil d'annulation. Il rend tout ce que le film avait dépensé, visuels IA compris, par le même chemin que tout rendu qui s'arrête en route.

Rendre l'annulation définitive a demandé plus de soin que le bouton lui-même. Le statut d'un film n'avance plus que depuis l'état où il a été vu pour la dernière fois. Une fois un film annulé, aucune partie du pipeline ne peut le renvoyer en tournage, et un rendu qui se termine à l'instant même d'une annulation aboutit proprement à une seule issue. Pour un agent, annuler devient une promesse, pas une demande.

Certaines valeurs correctes nous étaient régulièrement signalées comme des bugs : un lien vide vers des visuels générés sur un film qui n'en avait pas, un plafond de clips qui était en fait celui de l'appel, une narration plus courte que son film. Chacune avait son explication, rangée dans un commentaire de code qu'aucun agent ne voit.

Les explications vivent maintenant dans le schéma de sortie, champ par champ, et un test lit ce schéma exactement tel qu'il voyage jusqu'au client. D'autres petits correctifs ont suivi la même règle :

• L'inspection de page renvoyait jusqu'à 40 candidats classés pour un film qui en utilise quatre ou cinq. Elle renvoie désormais une sélection courte par défaut, et dit toujours ce que la page contient d'autre.
• La liste des pages qu'un film peut visiter est maintenant montrée à l'agent, depuis la source même à laquelle le planificateur est tenu, pour que personne n'ait à se demander d'où vient une page.
• L'outil de statut liste ses états dans l'ordre du pipeline, et le storyboard précise si chaque durée a été rendue ou seulement prévue.

Nous avions écrit comment réussir une pub, un film vertical, une démo et une réparation, mais dans un format qu'un seul client savait lire. La plupart des agents tournent sur d'autres clients et d'autres modèles. Nous avons donc publié quatre prompts MCP : make_an_ad, make_a_vertical, make_a_demo et fix_this_film. N'importe quel client MCP peut lister et récupérer un prompt à la demande, quel que soit le modèle derrière.

Chaque chiffre d'un prompt est une affirmation sur les outils : des tests confrontent donc chacun aux vrais schémas, tailles d'image, limites de durée, valeurs par défaut. Si un outil change, le prompt qui le décrit ne peut pas se périmer en silence.

Tout cela a ajouté des mots, et un agent charge la liste complète des outils dans son contexte au début de chaque session. Nous l'avons donc pesée. Un test fait passer la liste par le même transport qu'un client et affiche sa taille, la part de texte et de structure, et les outils les plus lourds.

Notre premier objectif s'est révélé irréaliste : la structure seule, sans aucune description, faisait déjà deux fois cette taille. À la place, un plafond juste au-dessus du total mesuré aujourd'hui est imposé. La liste peut encore grandir, mais seulement exprès, et chaque hausse donne sa raison.

Si vous construisez avec des assistants, commencez par notre page assistants ou la documentation développeurs.