OpenAPI pour les agents IA
Un document OpenAPI décrit une API HTTP sous une forme lisible par une machine : ses points de terminaison, les paramètres de chacun, la structure de chaque réponse et le mode d’authentification. Un agent peut le lire pour apprendre à appeler une API qu’il n’a jamais vue.
- Services répertoriés avec une description OpenAPI
- 23
- Sites servant un vrai fichier ai-plugin.json
- 75 sur 1 504
D’une description d’API à des outils
Les frameworks d’agents et plusieurs plateformes d’assistants peuvent transformer les opérations d’un document OpenAPI en outils : l’identifiant de l’opération devient le nom de l’outil, son résumé et sa description indiquent au modèle quand l’utiliser, et le schéma de ses paramètres devient l’entrée de l’outil. Le modèle renseigne alors les paramètres, et la plateforme effectue la requête HTTP.
Le manifeste de plugin
Le manifeste /.well-known/ai-plugin.json a été introduit avec le système de plugins de ChatGPT en 2023 : il nommait le service, le décrivait pour le modèle et pointait vers un document OpenAPI. Ce système de plugins a depuis été remplacé, mais certains sites servent encore le fichier, qui indique toujours où se trouve la description de leur API.
OpenAPI et MCP
OpenAPI décrit n’importe quelle API HTTP, quel que soit son appelant. MCP est un protocole conçu pour les assistants : le serveur liste ses outils lorsque le client se connecte, et le client les appelle. De nombreux serveurs MCP ne sont qu’une fine couche au-dessus d’une API qui dispose aussi d’une description OpenAPI, et il existe des outils pour générer l’un à partir de l’autre.
Ce qui rend une description adaptée aux agents
Des identifiants d’opération et des descriptions clairs, écrits pour quelqu’un qui n’a jamais vu l’API ; des exemples ; des énumérations pour les valeurs autorisées ; des erreurs documentées ; le schéma d’authentification déclaré, et pas seulement expliqué en prose ; et de petites opérations qui font chacune une seule chose. Une URL publiée et stable pour le document permet aux agents et aux annuaires de le trouver.
Services avec une description OpenAPI · Services avec une API publique · Parcourir l’annuaire →
Voir aussi : Qu’est-ce qu’un serveur MCP ? · Qu’est-ce que le fichier llms.txt ? · Comment les assistants IA trouvent et réservent des voyages · Comment les fiches sont vérifiées · Transports MCP : stdio, Streamable HTTP et SSE · Serveur MCP distant ou local : lequel choisir · Comment ajouter un serveur MCP à un assistant IA · Qu’est-ce que le MCP Registry officiel ? · Que mettre dans un fichier llms.txt · Comment les assistants IA trouvent les disponibilités · Avant de connecter un serveur MCP : liste de vérification