- La carte Exécuter du code dans Botpress vous permet d’exécuter du JavaScript personnalisé dans les flux de votre bot, pour des appels API dynamiques, du traitement de données et une logique personnalisée allant au-delà des actions intégrées standard.
- Les principaux cas d’usage incluent les requêtes API dynamiques, le post-traitement des réponses LLM, la limitation de débit, la gestion des permissions et l’enchaînement d’appels API multiples, permettant à vos agents IA de gérer des flux complexes avec précision.
- Les bonnes pratiques consistent à sécuriser les clés API dans les variables d’environnement, à gérer les erreurs et les délais d’attente proprement, et à construire une logique conditionnelle pour des bots robustes et sécurisés — garantissant des intégrations API fluides et évolutives.
Les agents IA sont limités par les données auxquelles ils ont accès. Même si les grands modèles de langage (LLM) génèrent des réponses à partir de leurs données d’entraînement, ils ne peuvent pas obtenir les cours boursiers en temps réel, traiter des paiements ou accéder aux informations CRM — sauf s’ils sont connectés à des API.
Les API permettent aux agents IA d’accéder à des données en temps réel, d’exécuter de la logique et de déclencher des actions. Pour en tirer pleinement parti, les agents ont besoin de code personnalisé.
La carte « Exécuter du code » dans Botpress Studio vous permet d’écrire et d’exécuter du JavaScript directement dans le flux de votre bot — pour gérer facilement les appels API, le traitement des données et la personnalisation du comportement du bot.
Qu’est-ce que la carte Exécuter du code ?
La carte Exécuter du code dans Botpress permet aux développeurs d’exécuter du JavaScript personnalisé dans le flux du bot. Elle permet notamment de :
- Mise en œuvre de logique personnalisée : vous pouvez effectuer des calculs complexes ou transformer des données de façon non couverte par les actions standard.
- Interactions dynamiques : adaptez les réponses selon les données utilisateur ou des calculs en temps réel.
- Intégrations de données : connectez-vous facilement à des services tiers pour récupérer ou envoyer des données.
- Gestion d’état : accédez à l’état du bot et modifiez-le pour conserver le contexte et personnaliser les échanges.
- Gestion des erreurs : mettez en place une gestion personnalisée des erreurs pour garantir la robustesse de vos opérations.
La carte Exécuter du code propose des suggestions de code généré par IA. Saisissez une demande — comme récupérer des données d’API — et le système génère instantanément du JavaScript. Vous pouvez ensuite relire, modifier et affiner le code selon vos besoins, ce qui accélère le développement.
Pourquoi les agents IA ont-ils besoin d’API externes ?
Les agents IA ne sont utiles que s’ils accèdent à des données et services pertinents. Même s’ils traitent des entrées et génèrent des réponses, ils n’ont pas de connaissances en temps réel, de capacités transactionnelles ni d’intégrations avancées sans API externes.
Que vous intégriez des données en temps réel, automatisiez des flux ou renforciez la sécurité, les API rendent votre bot plus intelligent, réactif et connecté.
5 façons d’utiliser la carte Exécuter du code
La carte Exécuter du code dans Botpress Studio simplifie les opérations des agents IA. L’ajouter à votre flux est facile — suivez ce tutoriel rapide :
Une fois ajouté, voici les principales façons de l’intégrer dans votre flux de travail agentique.
1. Appels API dynamiques
Au lieu d’utiliser des appels API statiques, la carte Exécuter du code permet de modifier dynamiquement les requêtes selon l’intention de l’utilisateur, le contexte du bot ou les conversations précédentes.
Exemple : récupérer des données personnalisées selon les préférences utilisateur.
Demande : Un chatbot de voyage doit obtenir les prix des hôtels selon la destination de l’utilisateur, ses dates de voyage et son budget.
.webp)
Remarque :La carte Execute Code peut générer du code à partir du langage naturel. Cependant, vérifiez toujours les variables utilisées dans votre code généré avant de déployer le workflow en production.
2. Post-traitement des réponses LLM
Même si Botpress propose des actions IA intégrées, il est parfois nécessaire d’ajuster les réponses avant de les afficher — par exemple pour formater les résultats, filtrer certains mots ou structurer les données plus clairement.
Exemple : Reformuler des réponses non structurées du LLM dans un tableau ou un format défini.
Prompt : L’IA récupère des recommandations de restaurants via une API, et je veux que tu les formates dans un tableau clair avant de les afficher.
.webp)
3. Limitation de débit et exécution conditionnelle
Certaines API, comme les portefeuilles numériques, imposent des limites d’utilisation. Avec la carte Exécuter du code, vous pouvez contrôler les interactions en imposant des limites, en prévoyant des alternatives et en ajoutant une logique conditionnelle selon la disponibilité de l’API.
Exemple : Vérifier l’utilisation d’une API avant de l’appeler
Prompt : Vérifiez le quota d’API sur https://api.monitoring.com/usage?apikey=${workflow.userApiKey} avant d’effectuer une requête. S’il reste moins de 5 requêtes, retournez une erreur ; sinon, poursuivez. Gérez correctement les erreurs en cas d’échec.
.webp)
4. Gestion des permissions
Si votre bot doit vérifier les utilisateurs avant d’accorder l’accès à certaines fonctionnalités, la carte permet de créer des flux d’authentification personnalisés allant au-delà des options par défaut de Botpress.
Exemple : Vérifier le statut d’abonnement de l’utilisateur avant de fournir une réponse IA
Prompt : Vérifiez l’abonnement d’un utilisateur via https://billing.example.com/user/{userId}. Si l’utilisateur est sur l’offre gratuite, proposez une mise à niveau ; sinon, autorisez l’accès. Gérez les erreurs.
.webp)
5. Chaînage multi-étapes d’API
Parfois, un bot doit combiner des données issues de plusieurs API avant de fournir une réponse finale. La carte permet de créer des flux complexes en plusieurs étapes, en récupérant, transformant et transmettant dynamiquement les données.
Exemple : Obtenir la météo + Réservation de restaurant pour recommander le meilleur moment pour partir
Invite de commande : Récupérez les données météo et trafic pour workflow.city en utilisant workflow.userApiKey. Selon les conditions, retournez le meilleur temps de trajet. Gérez les échecs.
.webp)
Intégrations API fluides pour agents IA
Les agents IA sont plus efficaces lorsqu’ils accèdent à des données en temps réel, automatisent des flux et se connectent à des services externes.
Botpress Hub facilite cela grâce à des intégrations API prêtes à l’emploi, des outils d’automatisation et des connecteurs prêts à l’emploi — concentrez-vous sur la création, pas la configuration.
Commencez à intégrer des API puissantes dans les workflows de votre bot dès aujourd’hui — c’est gratuit.
FAQ
1. Dois-je connaître JavaScript pour bien utiliser la carte Exécuter du code ?
Vous n’avez pas besoin de connaissances approfondies en JavaScript pour utiliser efficacement la carte Exécuter du code. Botpress propose des suggestions de code alimentées par l’IA : décrivez ce que vous souhaitez, et le système génère un code de base que vous pouvez facilement adapter.
2. Existe-t-il des modèles ou des extraits de code pour les intégrations API courantes ?
Oui, Botpress propose des exemples intégrés et des extraits de code pour les intégrations API courantes comme les CRM ou les paiements. Vous pouvez aussi consulter les forums de la communauté pour des modèles prêts à l’emploi.
3. Puis-je utiliser la carte Exécuter du code sans expérience préalable en intégration d’API ?
Oui, vous pouvez utiliser la carte Exécuter du code sans expérience préalable en intégration d’API. L’interface est accessible aux débutants, et l’assistant IA de Botpress peut générer du code et l’expliquer, ce qui rend l’apprentissage abordable même pour les non-développeurs.
4. Comment la carte gère-t-elle les requêtes API longues ou les délais d’attente ?
La carte Exécuter du code prend en charge le JavaScript asynchrone avec async/await, mais vous devez gérer manuellement les délais d’attente et les échecs. Il est recommandé d’encapsuler les appels API dans des blocs try/catch et de prévoir des flux de secours si une réponse est retardée ou échoue.
5. Quelles sont les bonnes pratiques pour mettre en place l’authentification et l’autorisation avec cette carte 0 ?
Pour gérer l’authentification et l’autorisation dans la carte Exécuter du code, stockez les clés API ou tokens dans les variables d’environnement Botpress, transmettez-les via des en-têtes sécurisés et ajoutez une logique pour vérifier les rôles ou permissions des utilisateurs avant d’exécuter des actions sensibles.
.webp)
