A2 · Outils et interface agent-machine (ACI)
Famille : Briques de base
Le modèle reçoit des fonctions qu’il demande d’appeler ; la qualité de cette interface compte autant que l’architecture.
Principe
On décrit au modèle des fonctions : chercher une information, agir sur un système, manipuler des données. Il demande de les appeler, le code les exécute et lui rend le résultat. Pour Anthropic, soigner cette interface agent-machine demande autant d’effort que soigner une interface pour des humains.
Le problème qu'il résout
Des outils trop nombreux, qui se recoupent ou mal décrits, font choisir le mauvais outil au modèle et gonflent son contexte, quelle que soit l’architecture au-dessus.
Quand l'utiliser
- Le modèle doit lire ou modifier un système réel : base de données, API, fichiers, navigateur.
- On veut standardiser l’accès aux outils entre plusieurs agents ou applications (MCP).
Quand l'éviter
- Chaque API est exposée telle quelle, par dizaines : regrouper en peu d’outils ciblés sur des tâches à fort impact.
- Un agent doit enchaîner de nombreux outils sur de gros volumes de données : faire écrire du code (C4).
Pièges fréquents
Les anti-patterns qui détournent ce pattern, les mieux établis d'abord. Chaque fiche décrit les symptômes, les incidents publics et les remèdes.
Outils et interface agent-machine
- AP12 · Trop d’outils chargés d’emblée — Toutes les définitions d’outils sont chargées à chaque tour, y compris celles qui se recoupent.
- AP13 · Sorties d’outils non bornées — Le résultat brut d’un outil entre tel quel dans le contexte, quelle que soit sa taille.
- AP19 · Outil à fonctionnalité excessive — Un outil ouvert (SQL brut, shell, HTTP libre) là où la tâche n’exige que quelques actions bornées.
- AP10 · Outil calqué sur l’API — Chaque point d’accès d’une API pour développeurs devient un outil, sans regroupement par tâche.
- AP11 · MCP par défaut — MCP est choisi par réflexe, là où une CLI documentée ou un appel direct suffisait.
- AP14 · Résultats intermédiaires qui transitent par le contexte — Une grosse donnée traverse le contexte du modèle à seule fin d’être recopiée vers un autre outil.
- AP15 · Erreur d’outil non actionnable — L’outil en échec renvoie un code ou une pile d’appels, et rien sur ce qu’il faut corriger.
- AP16 · Outil piège — Les paramètres de l’outil rendent l’erreur facile : nom ambigu, chemin relatif, argument déjà connu.
- AP20 · Texte vers SQL sans couche sémantique — Le modèle traduit la question en SQL exécuté directement sur la base, sans définitions métier ni revue.
- AP18 · Sur-outillage spécialisé — Une dizaine d’outils sur mesure, là où un accès générique à une documentation propre suffisait.
Sécurité et droits
- AP67 · Chaîne d’approvisionnement d’outils non vérifiée — Serveurs MCP, extensions et skills installés sans vérification ni épinglage, avec toute la confiance de l’agent.
- AP62 · Identité et jetons trop larges — L’agent agit sous une identité commune et puissante, avec des jetons qui couvrent bien plus que sa tâche.
- AP68 · Secrets à portée de l’agent — Les identifiants sont lisibles par l’agent, dans son contexte ou dans ses fichiers, au lieu d’être injectés hors du modèle.
- AP70 · Agent qui navigue dans la session authentifiée de l’utilisateur — Un navigateur agentique lit n’importe quelle page avec les sessions ouvertes de la messagerie et de la banque de l’utilisateur.
Synonymes par éditeur
- Tool use (A. Ng, A. Gulli (ch. 5))
- Function calling (usage courant)
- Tool-based agents (AWS)
- Agent-computer interface (ACI) (Anthropic)
- MCP (standardisation) (Anthropic)
Patterns voisins
Sources
- Building effective agents — Anthropic (E. Schluntz, B. Zhang), 2024-12-19
- SWE-agent: Agent-Computer Interfaces Enable Automated Software Engineering — J. Yang et al., 2024
- SWE-bench: Can Language Models Resolve Real-World GitHub Issues? — C. Jimenez et al. (ICLR 2024), 2024
- A practical guide to building agents — OpenAI, 2025-04-17
- Introducing advanced tool use — Anthropic, 2025-11-24
Contenu relu le 2026-10-02