Créez la définition d'un outil qu'un modèle d'IA peut appeler, avec son nom, sa description et ses paramètres. Exportez-la en JSON Schema simple ou dans les formats qu'attendent les API d'appel d'outils courantes et les serveurs MCP, et voyez les problèmes avant qu'un modèle ne trébuche dessus. S'exécute dans votre navigateur, gratuit et privé.
Comment créer une définition d'outil
- Donnez le Nom de l'outil et une Description claire.
- Appuyez sur Ajouter un paramètre pour chaque entrée, et réglez son nom, son type, sa description et s'il est obligatoire.
- Appuyez sur Ajouter un autre outil pour en avoir plusieurs, ou Retirer cet outil pour en supprimer un. Recommencer efface tout.
- Choisissez la sortie : JSON Schema, l'un des formats de fournisseur, ou MCP. Activez le Mode strict (sorties structurées) si besoin.
- Appuyez sur Copier le JSON ou Télécharger. Copier des exemples d'arguments donne un appel d'exemple.
Vous avez déjà une définition ? Collez-la dans JSON à importer et appuyez sur Importer.
Écrire des outils que les modèles utilisent bien
Les modèles choisissent un outil en lisant son nom et sa description : dites donc clairement ce qu'il fait et quand l'utiliser, par exemple « Cherche dans le centre d'aide. À utiliser quand l'utilisateur demande comment faire quelque chose dans l'appli. » Décrivez chaque paramètre, y compris les unités et formats, comme « Date ISO, AAAA-MM-JJ ». Utilisez une liste fixe de valeurs autorisées dès que le choix est limité, et ne marquez comme obligatoires que les champs vraiment nécessaires.
En quoi les formats diffèrent
Le schéma des paramètres est le même JSON Schema partout ; ce qui change, c'est l'enveloppe. Un fournisseur l'imbrique sous function.parameters, un autre l'appelle input_schema, un autre liste des déclarations de fonctions, et les serveurs MCP renvoient inputSchema. Les modes stricts ajoutent des règles : chaque propriété doit être listée comme obligatoire et les propriétés supplémentaires doivent être refusées : les champs facultatifs sont donc écrits comme acceptant null à la place.
Ce que détectent les contrôles
Les noms qui enfreignent les règles de l'API, comme les espaces ou plus de 64 caractères, les noms d'outils ou de paramètres en double, les valeurs autorisées qui ne correspondent pas au type, les objets sans propriétés et les descriptions manquantes. Les erreurs bloquent un appel d'API ; les avertissements signalent ce qui tend à faire choisir au modèle le mauvais outil ou remplir la mauvaise valeur.
Conseils
- Utilisez des noms courts à base de verbe comme search_orders ou get_weather, avec uniquement des lettres, des chiffres et des tirets bas.
- Gardez un petit nombre d'outils. Les modèles choisissent mieux dans une liste courte.
- Donnez à chaque paramètre un exemple dans sa description quand le format n'est pas évident.
- Testez le schéma sur de vraies réponses avec le vérificateur de schéma de réponse IA.
Qui l'utilise
Développeurs, freelances qui créent des assistants pour des clients, et étudiants qui apprennent comment fonctionne l'appel d'outils. Pour transformer un objet JSON d'exemple en types pour votre code, voir JSON en types.
Questions
Qu'est-ce que le mode strict ?
Il oblige le modèle à suivre exactement le schéma. Il faut que chaque propriété soit listée comme obligatoire et que les propriétés supplémentaires soient refusées.
Ma définition est-elle envoyée ?
Non. Elle est créée dans votre navigateur.
Puis-je modifier une définition existante ?
Oui. Collez-la dans la zone d'importation, modifiez-la, puis exportez à nouveau.