Outils

A quoi servent les outils

Les outils permettent a Kitemesh d’executer des appels HTTP vers des applications ou API externes. Ils sont utiles pour connecter un CRM, un systeme de ticketing, une API metier ou une autre action HTTP.

Les outils servent aux actions. Pour les lectures GET, utilisez plutot les Ressources API.

Ce qu’on configure dans un outil

Un outil repose generalement sur les elements suivants:

• un nom
• une description
• une methode HTTP
• une URL
• un schema d’arguments
• des champs d’authentification
• des tags
• un indicateur d’approbation utilisateur

Les methodes prises en charge sont POST, PATCH, PUT et DELETE.

Creer un outil

1. Ouvrez Configuration.
2. Selectionnez l’onglet Outils.
3. Cliquez sur Creer un outil.
4. Renseignez Nom, Description, Methode HTTP et Modele d'URL.
5. Ajoutez un Schema d'arguments (JSON).
6. Selectionnez des secrets dans Authentification si l’API cible demande des identifiants.
7. Choisissez les portees dans Partage avec.
8. Gardez Requiert validation utilisateur actif pour les actions sensibles.
9. Enregistrez l’outil.

Apres l’enregistrement, l’outil apparait dans la liste et peut etre utilise par les chats qui correspondent a son partage.

Authentification

Les outils peuvent reutiliser des secrets stockes dans le Coffre fort. C’est le bon choix pour:

• les cles d’API
• les jetons bearer
• les en-tetes personnalises sensibles

Evitez de mettre des secrets en clair dans la configuration d’un outil.

Schema d’arguments

Le schema d’arguments sert a decrire les parametres que l’outil attend. Plus ce schema est clair, plus l’assistant peut utiliser l’outil de facon fiable.

Un bon schema:

• nomme explicitement les champs
• distingue les champs obligatoires
• limite les ambiguities
• reflete la structure attendue par l’API cible

Validation utilisateur

Quand l’option de validation est activee, l’assistant demandera votre accord avant l’execution. Activez-la pour:

• les actions irreversibles
• les operations qui ecrivent dans un systeme externe
• les appels sensibles ou couteux

Si la validation est desactivee, l’outil peut s’executer sans confirmation manuelle quand l’assistant estime qu’il en a besoin.

Conseils de configuration

• Commencez par un outil simple et facile a tester.
• Utilisez des noms d’outils parlants.
• Rattachez l’outil au bon contexte de partage.
• Ajoutez des tags si vous avez plusieurs outils proches.

Quand creer plusieurs outils

Creez des outils distincts quand:

• les actions ont des risques differents
• les parametres attendus changent beaucoup
• les droits ou secrets ne sont pas les memes
• les usages metier sont separes