Outils

L’onglet Outils dans l’Agent Builder vous permet d’ajouter des outils et workflows personnalisés à vos agents. Contrairement aux Toolkits (intégrations préconstruites), les Outils sont des outils personnalisés et des workflows créés par l’utilisateur qui étendent les capacités de votre agent avec des fonctionnalités spécifiques adaptées à vos besoins.

​

Aperçu

Outils vous permettent de :

• Ajouter des outils personnalisés : Joindre des outils personnalisés que vous avez créés dans votre projet
• Ajouter des workflows : Inclure des workflows/actions qui exécutent des processus en plusieurs étapes
• Créer de nouveaux outils : Construire de nouveaux outils personnalisés directement depuis l’Agent Builder
• Gérer la configuration des outils : Configurer comment les outils sont utilisés par l’agent
• Parcourir la bibliothèque d’outils : Accéder à des milliers d’outils préconstruits depuis la bibliothèque publique

​

Outils vs. Toolkits

Comprendre la différence vous aide à choisir la bonne approche : Quand utiliser les outils :

• Vous avez besoin d’une logique métier personnalisée
• Vous voulez créer des workflows réutilisables
• Vous avez besoin d’intégrer des API personnalisées
• Vous voulez combiner plusieurs opérations en un seul outil

Quand utiliser les toolkits :

• Vous avez besoin d’intégrations standard (Gmail, Slack, etc.)
• Vous voulez une authentification préconfigurée
• Vous avez besoin d’opérations courantes (envoyer un e-mail, créer une tâche, etc.)

​

Accéder à l’onglet Outils

1. Ouvrir l’Agent Builder
   • Naviguez vers Agents dans la barre latérale
   • Cliquez sur Modifier sur un agent existant ou Créer un agent
   • L’Agent Builder s’ouvrira
2. Naviguer vers l’onglet Outils
   • Dans la barre latérale gauche, cliquez sur Outils
   • L’onglet Outils s’affichera avec vos outils sélectionnés et les options pour en ajouter

​

Ajouter des outils à votre agent

​

Ajouter des outils personnalisés existants

1. Ouvrir le sélecteur d’outils
   • Cliquez sur le bouton + Ajouter un outil dans l’onglet Outils
   • Le modal du sélecteur d’outils s’ouvrira
2. Parcourir les outils disponibles
   • Outils personnalisés : Outils que vous avez créés dans votre projet
   • Outils publics : Outils de la bibliothèque publique (9 000+ disponibles)
   • Workflows : Workflows existants de votre projet
3. Rechercher et filtrer
   • Utilisez la barre de recherche pour trouver des outils spécifiques
   • Filtrez par catégorie ou type
   • Parcourez par popularité ou ajouts récents
4. Sélectionner un outil
   • Cliquez sur un outil pour voir ses détails
   • Consultez la description et les entrées de l’outil
   • Cliquez sur Ajouter pour l’attacher à votre agent

​

Créer un nouvel outil personnalisé

1. Depuis le sélecteur d’outils
   • Cliquez sur + Ajouter un outil dans l’onglet Outils
   • Cliquez sur Créer un outil personnalisé dans le modal
   • Vous serez redirigé vers le constructeur d’outils
2. Depuis l’état vide
   • Si vous n’avez pas d’outils, cliquez sur Créer votre premier outil
   • Cela ouvre le constructeur d’outils pour un nouvel outil
3. Configurer votre outil
   • Nom : Donnez à votre outil un nom descriptif
   • Description : Expliquez ce que fait l’outil
   • Entrées : Définissez les paramètres d’entrée
   • Étapes : Configurez les étapes d’exécution de l’outil
   • Enregistrer : Enregistrez en brouillon ou publiez
4. Retourner à l’agent
   • Après la création, l’outil sera disponible dans votre projet
   • Retournez à l’Agent Builder et ajoutez-le via le sélecteur d’outils

​

Ajouter des workflows

1. Ouvrir le sélecteur d’outils
   • Cliquez sur + Ajouter un outil dans l’onglet Outils
   • Cliquez sur Créer un workflow dans le modal
2. Sélectionner le déclencheur du workflow
   • Choisissez le type de déclencheur :
     • Saisie de formulaire : L’utilisateur remplit un formulaire
     • Téléversement de fichier : L’utilisateur téléverse des fichiers
     • Manuel : Exécuter à la demande
3. Configurer le workflow
   • Configurez les étapes du workflow
   • Définissez les entrées et sorties
   • Configurez les paramètres du déclencheur
4. Ajouter à l’agent
   • Une fois créé, le workflow apparaît dans votre liste d’outils
   • Il peut être exécuté par l’agent lorsque nécessaire

​

Gestion des outils

​

Voir les outils ajoutés

L’onglet Outils affiche :

• Barre latérale : Affiche tous les outils ajoutés à l’agent
  • Outils personnalisés
  • Workflows
  • Actions de votre projet
• Zone principale : Affiche les détails de l’outil et les options de gestion

​

Statut des outils

Les outils peuvent avoir différents statuts :

• Actif : L’outil est prêt à être utilisé
• Brouillon : L’outil est en cours de modification (pas encore publié)
• Publié : L’outil a été publié et est disponible

​

Configurer les outils

1. Modifier la configuration de l’outil
   • Cliquez sur Configurer sur un outil ajouté
   • Ajustez les paramètres spécifiques à l’outil
   • Définissez les exigences d’approbation (si nécessaire)
2. Paramètres d’approbation des outils
   • Exécution automatique : L’outil s’exécute automatiquement lorsque déclenché
   • Nécessite une approbation : L’agent demande une confirmation avant d’exécuter
3. Valeurs par défaut des entrées
   • Définissez les valeurs par défaut pour les entrées de l’outil
   • Configurez les entrées obligatoires vs. optionnelles

​

Supprimer des outils

1. Retirer de l’agent
   • Cliquez sur le bouton X sur un outil dans la barre latérale
   • Ou cliquez sur Retirer dans les détails de l’outil
   • Confirmez la suppression
2. Supprimer un outil personnalisé
   • Pour les outils personnalisés, vous pouvez les supprimer entièrement
   • Cliquez sur le menu à trois points sur un outil personnalisé
   • Sélectionnez Supprimer
   • Note : Cela supprime définitivement l’outil de votre projet

​

Types d’outils

​

Outils personnalisés

Les outils personnalisés sont des outils que vous créez avec :

• Logique personnalisée : Vos propres règles et processus métier
• Intégrations API : Connectez-vous à vos propres API
• Opérations multi-étapes : Combinez plusieurs actions
• Traitement de données : Transformez et manipulez les données

Créer des outils personnalisés :

1. Définissez les entrées (paramètres acceptés par l’outil)
2. Configurez les étapes (ce que fait l’outil)
3. Mettez en place la gestion des erreurs
4. Testez l’outil
5. Publiez lorsque c’est prêt

​

Workflows

Les workflows sont des processus en plusieurs étapes qui peuvent :

• Exécuter des séquences : Exécuter plusieurs opérations dans l’ordre
• Gérer les déclencheurs : Répondre aux saisies de formulaire ou téléversements de fichiers
• Traitement de données : Transformer les données en plusieurs étapes
• Intégrer des services : Connecter plusieurs services ensemble

Déclencheurs de workflow :

• Saisie de formulaire : L’utilisateur fournit des informations via un formulaire
• Téléversement de fichier : L’utilisateur téléverse des fichiers pour traitement
• Manuel : Exécuter à la demande par l’agent

​

Outils publics

La bibliothèque d’outils publics comprend :

• 9 000+ outils : Outils préconstruits par la communauté
• Diverses catégories : Communication, productivité, données, etc.
• Prêts à l’emploi : Clonez et personnalisez selon vos besoins
• Régulièrement mis à jour : Nouveaux outils ajoutés fréquemment

Utiliser des outils publics :

1. Parcourez la bibliothèque publique
2. Trouvez un outil correspondant à vos besoins
3. Clonez-le dans votre projet
4. Personnalisez si nécessaire
5. Ajoutez-le à votre agent

​

Meilleures pratiques

​

Organisation des outils

1. Nommez clairement : Utilisez des noms descriptifs qui expliquent l’objectif de l’outil
2. Documentez bien : Ajoutez des descriptions claires pour chaque outil
3. Groupez les outils similaires : Organisez les outils par fonction ou catégorie
4. Contrôle de version : Utilisez les brouillons pour les tests avant publication

​

Sélection des outils

1. Commencez simplement : Commencez avec des outils de base et ajoutez de la complexité progressivement
2. Testez rigoureusement : Testez les outils avant de les ajouter aux agents de production
3. Considérez les performances : Trop d’outils peuvent ralentir les réponses de l’agent
4. Revoyez régulièrement : Supprimez les outils inutilisés pour maintenir l’efficacité des agents

​

Configuration des outils

1. Définissez des valeurs par défaut appropriées : Configurez des valeurs par défaut judicieuses
2. Utilisez l’approbation si nécessaire : Exigez une approbation pour les opérations sensibles
3. Gérez les erreurs : Assurez-vous que les outils ont une gestion d’erreurs appropriée
4. Documentez les entrées : Documentez clairement ce que fait chaque entrée

​

Cas d’utilisation

​

Agent de support client

Outils nécessaires :

• Outil de création de ticket : Outil personnalisé pour créer des tickets de support
• Recherche dans la base de connaissances : Outil pour rechercher dans la documentation
• Escalade de problème : Workflow pour escalader vers un agent humain

​

Agent d’analyse de données

Outils nécessaires :

• Outil de traitement de données : Outil personnalisé pour la transformation de données
• Génération de rapports : Workflow pour générer des rapports
• Exportation de données : Outil pour exporter les résultats

​

Agent de création de contenu

Outils nécessaires :

• Générateur de contenu : Outil personnalisé pour la création de contenu
• Génération d’images : Outil pour créer des images
• Workflow de publication : Workflow pour publier du contenu

​

Dépannage

​

L’outil n’apparaît pas

Problème : L’outil ne s’affiche pas dans le sélecteur Solutions :

• Vérifiez que l’outil est publié (les brouillons peuvent ne pas apparaître)
• Vérifiez que vous êtes dans le bon projet
• Actualisez la liste des outils
• Vérifiez les permissions de l’outil

​

L’outil ne s’exécute pas

Problème : L’agent n’utilise pas l’outil Solutions :

• Vérifiez que l’outil est ajouté à l’agent
• Vérifiez la configuration de l’outil
• Consultez le prompt système de l’agent (il peut être nécessaire de mentionner l’outil)
• Testez l’outil indépendamment

​

Erreurs d’exécution de l’outil

Problème : L’outil échoue lors de l’exécution Solutions :

• Vérifiez que les entrées de l’outil sont correctes
• Vérifiez la configuration de l’outil
• Consultez les messages d’erreur dans les journaux d’exécution de l’outil
• Testez l’outil avec des entrées d’exemple

​

L’approbation ne fonctionne pas

Problème : L’outil s’exécute sans approbation alors qu’il devrait en nécessiter Solutions :

• Vérifiez les paramètres d’approbation dans la configuration de l’outil
• Vérifiez que l’agent a la permission de demander une approbation
• Consultez la configuration d’approbation de l’outil

​

Documentation connexe

• Workflows - En savoir plus sur la création de workflows
• Toolkits - Comprendre les intégrations préconstruites
• Agent Builder - Guide général de configuration des agents