Tester dans le bac à sable

Le bac à sable permet d'exécuter un outil de votre serveur depuis l'application, sans IA, pour vérifier qu'il fait ce que vous attendez.

Choisir un outil

Ouvrez l'onglet « Test » du serveur et saisissez une partie du nom ou de la description d'un outil dans le champ « Outil ». Plusieurs mots fonctionnent dans n'importe quel ordre, sans tenir compte des majuscules ni des accents. Les outils dont le nom correspond apparaissent en premier. Si rien ne correspond, « Aucun outil trouvé » s'affiche et l'outil courant ne change pas. Au clavier, utilisez les flèches haut et bas pour vous déplacer, Entrée pour choisir, Échap pour fermer la liste (un second appui efface le champ) et Tab pour quitter sans choisir. Seuls les outils actifs sont proposés. Les outils en lecture seule portent la mention « Lecture seule » ; les autres peuvent modifier ou supprimer des données de votre API cible : testez-les avec précaution. Si la liste est vide, importez une spec OpenAPI ou ajoutez des documents dans l'onglet « Sources ».

Saisir les arguments avec le formulaire

Le mode « Formulaire » affiche un champ par paramètre, avec un contrôle adapté (nombre, entier, booléen « Non défini » / true / false). Les champs obligatoires sont signalés : « Obligatoire. ».

Saisir les arguments en JSON

Le mode « JSON » ouvre un éditeur « Arguments (JSON) ». Les arguments doivent être un objet JSON, par exemple {"city": "Paris"}. Un JSON invalide ou qui n'est pas un objet est signalé avant l'envoi.

Lire le résultat

Cliquez sur « Exécuter ». Le bloc « Résultat » indique :

• « Réussi » ou « Erreur de l'outil » (réponse de l'API cible avec un statut d'erreur, ou échec de l'appel) ;
• la « Durée » de l'appel ;
• le « Code HTTP » renvoyé par l'API cible, quand il y en a un ;
• la réponse, telle que l'IA la recevrait (voir API cible).

Quota

Chaque exécution compte dans votre quota mensuel, comme un appel de l'IA, et apparaît dans le journal. Seuls les arguments invalides (rejetés avant l'appel) ne sont ni comptés ni journalisés. Quand le quota est atteint, le bac à sable renvoie l'erreur QUOTA_EXCEEDED (détail) et n'appelle pas votre API. Voir Quotas et offres.

Serveur inactif

Le bac à sable fonctionne même si le serveur n'est pas « active » : pratique pour tester avant de connecter une IA. Les IA connectées, elles, sont refusées (403) tant que le serveur n'est pas actif.

Serveurs en OAuth

Sur un serveur dont l'API cible utilise OAuth 2.0, les outils de l'API ont besoin du jeton d'une personne connectée chez le fournisseur, que seule une IA connectée en OAuth possède. L'onglet « Test » les liste, mais « Exécuter » est désactivé ; un appel fait malgré tout est refusé avec OAUTH_REQUIRED, sans compter dans le quota. Les outils documents (search_documents, read_document) restent testables ici. Pour essayer un outil de l'API, connectez votre IA et demandez-lui d'appeler l'outil.

Identifiant transmis

Sur un serveur dont l'API cible utilise « Transmis par l'appelant », l'onglet « Test » affiche un champ masqué « Identifiant transmis » pour les outils de l'API. Saisissez la valeur attendue par votre API ; elle est envoyée pour cette exécution seulement et jamais stockée. Voir Identifiants par utilisateur avec une passerelle OAuth.

Exemple

Votre serveur « Météo » est encore en « draft ». Dans « Test », vous choisissez l'outil get_forecast, passez en mode « JSON » et saisissez {"city": "Paris"}. Après « Exécuter », le résultat affiche « Réussi », une durée de 340 ms et le code HTTP 200 avec la prévision. Vous savez que l'outil est prêt avant de connecter votre IA.