Que sont les Outils du Capitão et comment les utiliser ?

Q: Dois-je savoir programmer pour utiliser les Outils ?

Pour les Outils Natifs, comme l'intégration avec Google Agenda, aucune connaissance en programmation n'est nécessaire. La configuration se fait via une interface simple. Pour les Outils Personnalisés (HTTP), il est nécessaire d'avoir des connaissances techniques sur le fonctionnement des API, y compris les méthodes HTTP, l'authentification et le format JSON.

Q: Comment l'IA sait-elle quel Outil utiliser ?

L'IA décide quel outil utiliser en se basant sur la description que vous fournissez lors de sa configuration. Une description claire et détaillée, qui explique le but de l'outil et les informations dont il a besoin, est fondamentale. Le Capitão analyse l'intention du client et la compare aux descriptions de tous les outils disponibles pour choisir le plus approprié.

Les Outils du Capitão sont des actions que l'assistant d'intelligence artificielle de Papo (https://papo.global/) peut exécuter pour automatiser des tâches et interagir avec d'autres systèmes. Ils permettent à l'IA d'aller au-delà de la simple réponse aux questions, en pouvant effectuer des actions pratiques comme planifier des réunions, consulter le statut d'une commande dans un système externe ou créer une nouvelle opportunité dans votre CRM, le tout directement depuis la conversation avec le client.

Avec les Outils, vous transformez votre assistant Capitão d'un informateur passif en un agent proactif. Il peut comprendre l'intention du client et utiliser un outil spécifique pour résoudre la demande sur-le-champ, sans nécessiter d'intervention humaine. Cela ouvre un éventail de possibilités pour des automatisations complexes et efficaces.

Type d'Outil	Description	Exemple d'Utilisation	Connaissances Techniques
Natif	Intégrations préconfigurées et prêtes à l'emploi, disponibles sur la plateforme Papo.	Planifier une démonstration dans Google Agenda pour un vendeur.	Faible (juste activer et connecter le compte).
Personnalisé (HTTP)	Actions personnalisées qui se connectent à des systèmes externes (ERP, CRM) ou à l'API de Papo elle-même.	Consulter le statut d'une commande dans le système e-commerce de l'entreprise.	Avancé (nécessite des connaissances en API et requêtes HTTP).

Comment fonctionnent les Outils du Capitão ?

Le processus de fonctionnement d'un Outil est un cycle intelligent qui connecte la conversation du client à une action concrète :

Interprétation de l'Intention : Le client envoie un message comme "J'aimerais savoir où en est ma commande 12345" ou "Je veux prendre rendez-vous avec un consultant".
Sélection de l'Outil : Le Capitão analyse le message et, en se basant sur les instructions et les descriptions des outils que vous avez configurés, identifie celui qui est le plus approprié pour résoudre la demande.
Exécution de l'Action : L'IA active l'outil sélectionné. S'il s'agit d'un outil pour consulter une commande, il enverra le numéro "12345" à votre système externe. S'il s'agit de planifier, il consultera les créneaux horaires disponibles dans l'agenda.
Retour de la Réponse : Le système externe ou l'outil natif renvoie un résultat (ex : "Commande en transit" ou "Horaires disponibles : 14h et 15h").
Communication au Client : Le Capitão utilise cette information pour formuler une réponse naturelle et complète au client, finalisant la demande de manière autonome.

Ce flux transforme le service client, permettant à l'IA de résoudre les problèmes de bout en bout, et pas seulement de fournir des informations de base.

Types d'Outils : Natifs vs. Personnalisés

Vous pouvez équiper votre assistant Capitão de deux types d'outils, chacun ayant un objectif différent.

Outils Natifs

Ce sont des intégrations prêtes à l'emploi, développées et maintenues par Papo. L'objectif est de simplifier la connexion avec des services populaires sans que vous ayez à vous soucier des détails techniques.

Le principal exemple est l'intégration avec Google Agenda. En l'activant, vous permettez au Capitão de :

Vérifier la disponibilité en temps réel dans l'agenda d'un ou plusieurs membres de l'équipe.
Proposer les créneaux horaires disponibles au client pendant la conversation.
Créer automatiquement l'événement dans l'agenda dès que le client confirme l'heure souhaitée.

La configuration implique généralement seulement d'autoriser Papo à accéder à votre compte sur le service externe et d'activer l'outil pour votre assistant.

Outils Personnalisés (HTTP)

Les outils personnalisés offrent une flexibilité totale, permettant au Capitão de communiquer avec pratiquement n'importe quel système possédant une API (Application Programming Interface). Cela inclut votre ERP, CRM, plateforme d'e-commerce ou même d'autres modules de Papo.

Pour configurer un outil personnalisé, vous devez fournir les détails de la requête HTTP que l'IA doit effectuer :

URL du Point de Terminaison (Endpoint) : L'adresse de l'API qui sera appelée (ex : https://api.meusistema.com/v1/pedidos).
Méthode HTTP : L'action à réaliser (GET pour récupérer des données, POST pour créer, PUT pour mettre à jour, etc.).
Headers (En-têtes) : Informations additionnelles, comme les clés d'authentification (Authorization: Bearer sk_sua_chave_secreta) pour garantir que la requête est sécurisée et autorisée.
Body (Corps de la Requête) : Les données à envoyer, généralement au format JSON. Vous pouvez utiliser des variables de la conversation pour rendre l'action dynamique (ex : {"id_pedido": "{variavel_numero_pedido}"}).

Avec cela, vous pouvez créer des automatisations comme "consulter le solde de points de fidélité", "créer un lead dans le CRM de Papo" ou "ouvrir un ticket de support dans votre système interne".

Étape par Étape : Comment Configurer un Outil dans le Capitão

Bien que les noms exacts des menus puissent varier, le processus conceptuel pour activer un outil pour votre assistant suit une logique claire :

Accédez aux Paramètres de l'Assistant : Dans le panneau de Papo, naviguez jusqu'à la zone de configuration du Capitão que vous souhaitez améliorer.
Localisez la Section des Outils : Dans les options de configuration de l'assistant, trouvez la zone dédiée aux "Outils" (Tools).
Ajoutez un Nouvel Outil : Choisissez entre ajouter un outil "Natif" ou "Personnalisé (HTTP)".
Pour les Outils Natifs : Sélectionnez le service souhaité (comme Google Agenda) dans la liste des intégrations disponibles. Suivez les instructions à l'écran pour connecter et autoriser votre compte.
Pour les Outils Personnalisés :
- Donnez un Nom et une Description : Créez un nom clair (ex : "Consulter le Statut de la Commande") et une description détaillée pour l'IA. La description est cruciale, car elle enseigne au Capitão quand et comment utiliser l'outil (ex : "Utilisez cet outil pour vérifier le statut d'une commande d'un client lorsqu'il fournit le numéro de commande").
- Configurez la Requête HTTP : Remplissez les champs de l'URL du point de terminaison, de la méthode HTTP, des en-têtes (pour l'authentification) et du corps de la requête, si nécessaire.
Activez et Testez : Après la configuration, activez l'outil pour que le Capitão puisse commencer à l'utiliser. Effectuez des tests en envoyant des messages qui devraient déclencher le nouvel outil pour vous assurer que tout fonctionne comme prévu.

Foire Aux Questions (FAQ)

Quelle est la différence entre les Outils (Tools) et les Scénarios ?

Les Outils (Tools) sont conçus pour exécuter des actions dans des systèmes externes ou d'autres parties de l'API de Papo, comme consulter une base de données ou planifier un événement. Les Scénarios sont des instructions pour le Capitão afin d'exécuter une action interne sur la plateforme, comme transférer la conversation à un agent humain (débordement) dans des situations spécifiques.

Dois-je savoir programmer pour utiliser les Outils ?

Pour les Outils Natifs, comme l'intégration avec Google Agenda, aucune connaissance en programmation n'est nécessaire. La configuration se fait via une interface simple. Pour les Outils Personnalisés (HTTP), il est nécessaire d'avoir des connaissances techniques sur le fonctionnement des API, y compris les méthodes HTTP, l'authentification et le format JSON.

Comment l'IA sait-elle quel Outil utiliser ?

L'IA décide quel outil utiliser en se basant sur la description que vous fournissez lors de sa configuration. Une description claire et détaillée, qui explique le but de l'outil et les informations dont il a besoin, est fondamentale. Le Capitão analyse l'intention du client et la compare aux descriptions de tous les outils disponibles pour choisir le plus approprié.

Puis-je utiliser les Outils pour interagir avec l'API de Papo elle-même ?

Oui. Vous pouvez configurer un Outil Personnalisé (HTTP) pour effectuer des appels à l'API de Papo. Cela permet de créer des automatisations avancées, comme utiliser l'IA pour créer un nouveau contact dans le CRM, envoyer un message via un autre canal ou mettre à jour un attribut d'un client, le tout à partir d'une instruction dans la conversation.

Est-il sûr d'utiliser des Outils Personnalisés avec mes clés API ?

Oui. Les informations d'authentification, comme les clés API (tokens), sont stockées de manière sécurisée sur la plateforme Papo et utilisées dans des communications de serveur à serveur, qui sont plus sûres. C'est une bonne pratique de sécurité de créer des clés API avec des permissions limitées spécifiquement pour cette intégration, plutôt que d'utiliser des clés avec un accès total.

Lisez aussi

Commencez gratuitement et automatisez vos tâches →

Le premier utilisateur est gratuit et vous pouvez déjà commencer à configurer votre IA pour exécuter des actions réelles.