Que sont les Outils (Tools) du Capitão et comment les utiliser pour automatiser des tâches ?

Q: Dois-je savoir programmer pour utiliser les Outils du Capitão ?

Pour les outils natifs, non. La configuration est simple et guidée, impliquant des clics et des autorisations de compte. Pour les outils personnalisés (HTTP), oui, il est nécessaire d'avoir une connaissance de base du fonctionnement des API et des requêtes HTTP. C'est une fonctionnalité plus avancée, destinée aux développeurs ou aux équipes disposant d'un support technique.

Les Outils (Tools) 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 réalisant 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 l'Agenda Google du vendeur.	Faible (il suffit d'activer et de connecter le compte).
Personnalisé (HTTP)	Actions personnalisées qui se connectent à des systèmes externes (ERP, CRM) ou à l'API de Papo.	Consulter le statut d'une commande dans le système e-commerce de l'entreprise.	Avancées (nécessite des connaissances en API et requêtes HTTP).

Comment fonctionnent les Outils du Capitão ?

Le processus de fonctionnement d'un Outil (Tool) 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ù 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 libres au client pendant la conversation.
Créer l'événement automatiquement dans l'agenda dès que le client confirme l'heure souhaitée.

La configuration implique généralement uniquement 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 disposant d'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 de l'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".

Pas à pas : 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 Outils (Tools) : Dans les paramètres de l'assistant, recherchez l'option pour gérer ou ajouter de nouveaux outils.
Ajoutez un Nouvel Outil : Choisissez d'utiliser un "Outil Natif" de la liste ou de créer un "Outil Personnalisé".
Pour les Outils Natifs :
- Sélectionnez l'intégration souhaitée (ex : Google Agenda).
- Suivez les instructions à l'écran pour connecter votre compte et accorder les autorisations nécessaires.
- Activez l'outil pour que le Capitão puisse commencer à l'utiliser.
Pour les Outils Personnalisés (HTTP) :
- Donnez un Nom et une Description : C'est une étape cruciale. Le nom doit être clair (ex : "VérifierStatutCommande") et la description doit expliquer en langage naturel ce que l'outil fait et quand il doit être utilisé (ex : "Utilisez cet outil pour obtenir le statut d'une commande lorsque le client fournit le numéro"). L'IA utilisera cette description pour décider quand déclencher l'action.
- Configurez la Requête : Remplissez les champs techniques : URL de l'endpoint, méthode HTTP, en-têtes d'authentification et le corps de la requête, en utilisant des variables si nécessaire.
- Enregistrez et Activez : Après avoir rempli toutes les données, enregistrez la configuration.
Testez l'Outil : Envoyez un message à l'assistant dans un canal de test, en simulant la demande d'un client, pour vous assurer que l'outil est déclenché correctement et que la réponse est celle attendue.

Questions Fréquentes (FAQ)

Qu'est-ce qu'une API et pourquoi en ai-je besoin pour les outils personnalisés ?

Une API (Interface de Programmation d'Applications) est un ensemble de règles et de définitions qui permet à différents systèmes logiciels de communiquer. Pour les outils personnalisés, l'API de votre système (ERP, CRM, etc.) est le "pont" qui permet au Capitão d'envoyer et de recevoir des informations, comme consulter une commande ou créer un client.

Dois-je savoir programmer pour utiliser les Outils du Capitão ?

Pour les outils natifs, non. La configuration est simple et guidée, impliquant des clics et des autorisations de compte. Pour les outils personnalisés (HTTP), oui, il est nécessaire d'avoir une connaissance de base du fonctionnement des API et des requêtes HTTP. C'est une fonctionnalité plus avancée, destinée aux développeurs ou aux équipes disposant d'un support technique.

Le Capitão peut-il utiliser des outils pour exécuter des actions au sein de Papo ?

Oui. Vous pouvez utiliser les outils personnalisés pour interagir avec l'API de Papo. Par exemple, il est possible de créer un outil qui, en identifiant un nouveau lead dans la conversation, effectue un appel à l'API de Papo et crée un nouveau contact dans le CRM ou lui ajoute une étiquette spécifique.

Comment l'IA sait-elle quel outil utiliser dans chaque situation ?

L'IA décide en fonction de deux facteurs principaux : l'intention détectée dans le message de l'utilisateur et la description que vous fournissez lors de la configuration de l'outil. Une description claire et précise, comme "Utilisez cet outil pour planifier une visite technique", est essentielle pour que le Capitão comprenne le contexte et choisisse la bonne action.

Les outils personnalisés sont-ils sécurisés ?

La sécurité des connexions via les outils personnalisés dépend de la bonne implémentation. Papo stocke vos clés API de manière sécurisée, mais il est de votre responsabilité de vous assurer que vous vous connectez à des endpoints sécurisés (HTTPS) et que vous utilisez des clés API qui n'ont que les permissions nécessaires pour exécuter l'action, minimisant ainsi les risques.