Data Actions : votre propre API comme outil
Transformez un endpoint existant en outil que l'assistant peut appeler.
Data Actions sert pour ce que vos clients demandent et qu'aucun document ne peut dire : « où en est ma commande ? », « combien en reste-t-il en stock ? », « mon abonnement est-il toujours actif ? ». La réponse se trouve dans votre propre système, derrière une API. Une Data Action, c'est cet endpoint, décrit une fois pour toutes, pour que l'assistant puisse l'appeler en pleine conversation et répondre avec le vrai chiffre.
Astuce: Vous n'avez pas d'API ? Passez cette page. L'assistant est complet sans elle — elle s'adresse aux équipes dont les systèmes parlent déjà HTTP.
La différence avec API Connections#
Les deux donnent des outils à l'assistant ; la différence tient à qui fait tourner le serveur. API Connections connecte un serveur MCP qui existe déjà et expose ses propres outils. Data Actions sert quand un tel serveur n'existe pas : vous décrivez vos endpoints ici et Pommy les présente à l'assistant comme des outils. Si votre API dispose d'un document OpenAPI, rien à décrire à la main — importez-le et les endpoints arrivent sous forme de groupe.
Groupes et actions#
Les actions sont rangées dans des groupes. Un groupe correspond à un système — « API Commandes », « Entrepôt » — avec sa propre adresse de base et, si besoin, sa propre authentification. À l'intérieur, chaque action est un endpoint : un nom que voit l'assistant, une description de quand l'utiliser, la méthode et le chemin, et les paramètres. Rédigez la description pour l'assistant, pas pour un développeur : c'est la seule chose qui lui indique *quand* cette action est la bonne.
En ajouter une#
- Créez un groupe
Ouvrez Data Actions dans le menu de gauche et créez un groupe pour le système que vous connectez. Indiquez l'adresse de base et, si l'API demande des identifiants, ajoutez-les ici — ils sont enregistrés avec le groupe, pas répétés pour chaque action.
- Ajoutez des actions, ou importez-les
Ajoutez les endpoints un par un, ou utilisez Import from OpenAPI et laissez Pommy lire le document. Les actions importées arrivent désactivées pour que vous puissiez les vérifier avant toute mise en ligne.
- Activez ce que l'assistant peut utiliser
Chaque action a son propre interrupteur, tout comme le groupe. N'activez que ce dont cet assistant a réellement besoin — une action désactivée lui est invisible.
Les actions qui doivent savoir qui demande#
Certaines réponses sont personnelles — une commande appartient à un seul client. Un groupe peut être marqué comme exigeant une identité : ses actions ne s'exécutent alors que si la conversation a un visiteur vérifié. C'est ce qui empêche un inconnu de se renseigner sur la commande de quelqu'un d'autre.
Attention: Une Data Action s'exécute sur votre système en production avec les identifiants que vous avez fournis au groupe. Commencez par des endpoints en lecture seule ; n'ajoutez ceux qui écrivent qu'après avoir observé le bon comportement des premiers.
La tester#
Après avoir activé une action, posez la question qu'un client poserait — dans le widget, avec ses mots, pas le nom de l'endpoint. Si l'assistant répond à partir de votre système, la description fait son travail. S'il ignore l'action, la description en est généralement la cause : dites clairement à quoi répond l'action et quand y recourir.