Aller au contenu

Choisir et décrire les outils

Mis à jour le 24 octobre 2026

Les outils sont ce que votre IA voit et peut appeler. Bien les choisir et les décrire améliore nettement la qualité des réponses.

Activer ou désactiver un outil

Dans l'onglet « Outils », utilisez la colonne « Activé » pour choisir ce que l'IA peut appeler, puis cliquez sur « Enregistrer ». Tant que vous n'avez pas enregistré, le message « Modifications non enregistrées » s'affiche ; « Annuler » abandonne vos changements. La zone « Rechercher un outil » aide à filtrer les longues listes. Un outil désactivé n'est pas visible de l'IA.

Limite d'outils actifs

Le nombre d'outils pouvant être actifs par serveur est fixé par votre offre (le compteur « N / limite actifs » est en haut de l'onglet). À l'import, les premiers outils dans l'ordre de la spec sont activés et les suivants désactivés, avec l'avertissement TOOLS_DISABLED_OVER_LIMIT. Activer un outil au-delà de la limite est refusé (PLAN_LIMIT_REACHED) : désactivez-en un autre d'abord. Voir Quotas et offres.

Renommer un outil

Cliquez sur « Modifier » sur la ligne de l'outil, changez le champ « Nom », puis « Appliquer » et « Enregistrer ». Règles :

  • lettres, chiffres, _ et - uniquement, 64 caractères au plus ;
  • le nom est unique dans le serveur, sans distinction de majuscules ;
  • search_documents et read_document sont réservés.

Un outil personnalisé affiche « Modifié ».

Réécrire la description

La description est ce que l'IA lit pour décider d'appeler l'outil. Elle est générée à partir du résumé (summary) puis de la description (description) de l'opération, sinon de METHOD /chemin. Vous pouvez la réécrire (1 000 caractères maximum). « Rétablir la valeur générée » revient au texte issu de la spec. Vos modifications survivent à une mise à jour de la spec.

Nature d'un outil

La colonne « Nature » classe chaque outil :

NatureMéthodes HTTP
Lecture seuleGET, HEAD, OPTIONS
Écritureles autres méthodes (POST, PUT, PATCH)
SuppressionDELETE

Ces indications sont transmises à l'IA (annotations MCP readOnlyHint et destructiveHint) : les outils d'écriture et de suppression sont signalés comme modifiant des données, ce qui incite les clients à demander une confirmation. Désactivez les outils d'écriture ou de suppression dont votre IA n'a pas besoin.

Outils des documents

Quand le serveur contient des documents, les outils search_documents et read_document sont ajoutés automatiquement (« Toujours actif »). Ils ne comptent pas dans la limite de 50. Voir Documents et recherche.

Bonnes pratiques

  • Nommez avec un verbe et un objet : list_orders, create_invoice.
  • Dites quand utiliser l'outil, et quand ne pas l'utiliser.
  • Précisez les unités et formats des paramètres (« montant en centimes », « date au format AAAA-MM-JJ »).
  • Gardez peu d'outils actifs : une IA choisit mieux parmi dix outils clairs que parmi cinquante.

Exemple

L'opération générée s'appelle get_orders_id, avec la description GET /orders/{id}. Vous la renommez get_order et la décrivez ainsi :

Lit une commande par son identifiant (paramètre id, texte). À utiliser quand
l'utilisateur donne un numéro de commande. Renvoie le statut et les lignes.

Après « Appliquer » puis « Enregistrer », l'IA voit get_order avec ce texte.

Commencer