Ressources API

A quoi servent les ressources API

Les ressources API rendent des donnees externes disponibles comme contexte de lecture. Elles sont utiles quand un agent doit consulter une API metier sans executer d’action d’ecriture.

Contrairement aux outils, les ressources API sont limitees a GET. Utilisez-les pour lire ou rechercher une information. Utilisez les Outils pour les actions qui creent, modifient ou suppriment des donnees.

Creer une ressource API

1. Ouvrez Configuration.
2. Selectionnez l’onglet Ressources API.
3. Cliquez sur Creer une ressource API.
4. Renseignez Nom, Description, Modele d'URL et Schema d'arguments (JSON).
5. Reglez TTL du cache (secondes) si la reponse peut etre reutilisee pendant un court moment.
6. Choisissez les bonnes portees dans Partage avec.
7. Enregistrez la ressource.

La ressource apparait dans la liste avec la methode GET.

Authentification

Les ressources API peuvent utiliser des secrets du Coffre fort. Selectionnez des secrets du coffre fort plutot que d’ecrire une valeur sensible dans la configuration.

Lors de la modification, un secret existant peut rester masque. Selectionnez un nouveau secret uniquement si vous voulez le remplacer.

Utiliser les ressources API dans le chat

Quand une ressource est partagee avec le groupe ou le modele selectionne, elle peut etre utilisee pendant le chat. Depuis Parametres du chat, utilisez Exclure les ressources API pour ne garder que les ressources utiles a la conversation en cours.

TTL du cache

TTL du cache (secondes) indique combien de temps une reponse GET reussie peut etre reutilisee. Utilisez 0 si la reponse doit toujours etre fraiche.

Que verifier

• L’equipe active est la bonne.
• La ressource est partagee avec la bonne equipe, le bon modele personnalise ou le bon groupe de modeles.
• Le schema d’arguments JSON est valide.
• Les secrets requis existent dans le coffre fort.
• L’API cible repond bien a une requete GET.
• Un TTL non nul ne masque pas une modification recente.