- La carte Execute Code de Botpress vous permet d'exécuter du JavaScript personnalisé à l'intérieur des workflows du bot, permettant des appels API dynamiques, le traitement de données et une logique personnalisée au-delà des actions standard intégrées.
- Les principaux cas d'utilisation comprennent les demandes d'API dynamiques, le post-traitement des sorties LLM , la limitation du débit, les contrôles d'autorisation et l'enchaînement d'appels d'API à plusieurs étapes, permettant aux agents d'IA de gérer des flux de travail complexes avec précision.
- Les meilleures pratiques consistent à sécuriser les clés d'API dans les variables d'environnement, à gérer les erreurs et les dépassements de délai avec élégance et à élaborer une logique conditionnelle pour des opérations de robot robustes et sécurisées, garantissant ainsi des intégrations d'API fluides et évolutives.
La puissance des agents d'IA dépend des données auxquelles ils ont accès. Si les grands modèles de langageLLMs génèrent des réponses à partir de données d'apprentissage, ils ne peuvent pas récupérer les cours de la bourse en temps réel, traiter les paiements ou accéder aux détails de la gestion de la relation client (CRM), à moins d'être intégrés à des API.
Les API permettent aux agents d'IA d'accéder à des données en temps réel, d'exécuter une logique et de déclencher des actions. Pour les exploiter pleinement, les agents ont besoin d'un code personnalisé.
La carte 'Execute Code' dans Botpress Studio vous permet d'écrire et d'exécuter du JavaScript à l'intérieur du flux de travail d'un bot - en gérant de manière transparente les appels API, le traitement des données et la personnalisation du comportement du bot.
Qu'est-ce que la carte Execute Code ?
La carte Execute Code de Botpress permet aux développeurs d'exécuter du JavaScript personnalisé dans le flux du bot. Elle permet les fonctions suivantes :
- Mise en œuvre d'une logique personnalisée : Vous pouvez exécuter des calculs complexes ou transformer des données d'une manière qui n'est pas couverte par les actions standard.
- Interactions dynamiques : Ajuster les réponses en fonction des données de l'utilisateur ou des calculs en temps réel.
- Intégrations de données : Connexion transparente avec des services tiers pour récupérer ou envoyer des données.
- Gestion de l'état : Accédez à l'état du robot et modifiez-le pour maintenir le contexte et personnaliser les interactions.
- Gestion des erreurs : Mettre en œuvre une gestion personnalisée des erreurs afin de garantir la robustesse des opérations.
Lacarte Execute Code Card propose des suggestions de code générées par l'IA. Saisissez une invite, par exemple l'extraction de données d'API, et le système génère instantanément du code JavaScript. Vous pouvez ensuite le revoir, le modifier et l'affiner si nécessaire, ce qui accélère le développement.
Pourquoi les agents d'intelligence artificielle ont-ils besoin d'API externes ?
L'utilité des agents d'IA dépend des données et des services auxquels ils ont accès. Bien qu'ils puissent traiter des entrées et générer des réponses, ils manquent de connaissances en temps réel, de capacités transactionnelles et d'intégrations approfondies sans API externes.
Qu'il s'agisse d'intégrer des données en temps réel, d'automatiser des flux de travail ou de renforcer la sécurité, les API rendent votre robot plus intelligent, plus réactif et plus intégré.
5 façons d'utiliser la carte Execute Code
La carte Execute Code dans Botpress Studio rationalise les opérations des agents d'intelligence artificielle. L'ajouter à votre workflow est simple - suivez ce tutoriel rapide :
Onceadded, here are key ways to leverage it in your agentic workflow.
1. Appels dynamiques de l'API
Au lieu d'utiliser des appels API statiques, l'Execute Card vous permet de modifier dynamiquement les demandes en fonction de l'intention de l'utilisateur, du contexte du robot ou des conversations précédentes.
Exemple : Récupération de données personnalisées en fonction des préférences de l'utilisateur.
Invitation : Un chatbot de voyage doit retrouver les prix des hôtels en fonction de la destination, des dates de voyage et du budget de l'utilisateur.
.webp)
Note : La carte Execute Code peut générer du code à partir d'un langage naturel : La carte Execute Code peut générer du code à partir d'un langage naturel. Cependant, il faut toujours vérifier les variables utilisées dans le code généré avant de déployer le flux de travail en production.
2. Post-traitement des réponses LLM
Bien que Botpress propose des actions d'IA intégrées, il est parfois nécessaire d'affiner les réponses avant de les montrer aux utilisateurs - qu'il s'agisse de formater les sorties, de filtrer certains mots ou de structurer les données plus clairement.
Exemple: Réécriture des réponses LLM non structurées dans un tableau/format défini.
Prompt: L'IA récupère des recommandations de restaurants à partir d'une API, et je veux que vous les mettiez en forme dans un tableau propre avant de les afficher.
.webp)
3. Limitation du taux d'exécution et exécution conditionnelle
Certaines API, notamment les portefeuilles numériques, sont soumises à des limites d'utilisation. Avec la carte Execute Code Card, vous pouvez contrôler les interactions des utilisateurs en appliquant des limites de taux, en définissant des solutions de repli et en ajoutant une logique conditionnelle basée sur la disponibilité de l'API.
Exemple: Vérifier l'utilisation de l'API avant de l'appeler
Prompt: Check API quota from https://api.monitoring.com/usage?apikey=${workflow.userApiKey} before making a request. If fewer than 5 requests remain, return an error; otherwise, proceed. Ensure proper error handling in case of failures.
.webp)
4. Gestion des autorisations
Si votre bot a besoin de vérifier les utilisateurs avant de leur donner accès à certaines fonctionnalités, la carte permet de personnaliser les flux d'authentification au-delà des options par défaut de Botpress.
Exemple: Vérification de l'état de l'abonnement de l'utilisateur avant de fournir des réponses AI
Prompt: Check a user's subscription via https://billing.example.com/user/{userId}. If on a free plan, prompt an upgrade; otherwise, allow access. Handle errors.
.webp)
5. Enchaînement d'API en plusieurs étapes
Parfois, un robot doit combiner des données provenant de plusieurs API avant d'envoyer une réponse finale. La carte permet des flux de travail complexes en plusieurs étapes en récupérant, transformant et transmettant des données de manière dynamique.
Exemple: Recherche de la météo + réservation de restaurant pour recommander le meilleur moment pour partir
Prompt: Récupérer les données météorologiques et routières pour workflow.city en utilisant workflow.userApiKey. En fonction des conditions, renvoyer le meilleur temps de trajet. Gérer les échecs.
.webp)
Intégrations d'API transparentes pour les agents d'IA
Les agents d'IA fonctionnent mieux lorsqu'ils peuvent exploiter des données en temps réel, automatiser des flux de travail et se connecter à des services externes.
Botpress Hub rend cela possible grâce à des intégrations API, des outils d'automatisation et des connecteurs prêts à l'emploi, afin que vous puissiez vous concentrer sur la construction et non sur la configuration.
Startintegrating powerful APIs into your bot's workflows today-it is free.
FAQ
1. Dois-je connaître le langage JavaScript pour utiliser efficacement la carte Execute Code ?
You don’t need deep JavaScript knowledge to use the Execute Code Card effectively. Botpress provides AI-powered code suggestions, so you describe what you want, and it generates starter code that you can adjust with minimal effort.
2. Existe-t-il des modèles ou des extraits de code standard pour les intégrations API courantes ?
Yes, Botpress offers built-in examples and boilerplate code snippets for common API integrations like CRMs and payment gateways. You can also browse community forums for ready-to-use code patterns.
3. Puis-je utiliser l'Execute Code Card sans avoir d'expérience préalable en matière d'intégration d'API ?
Yes, you can use the Execute Code Card without prior API integration experience. The interface is beginner-friendly, and Botpress's AI helper can generate code and explain it, making the learning curve manageable even for non-developers.
4. Comment la carte gère-t-elle les demandes d'API de longue durée ou les dépassements de délai ?
The Execute Code Card supports asynchronous JavaScript using async/await
, but you need to manually handle timeouts and failures. Best practice includes wrapping API calls in try/catch
blocks and defining fallback flows if a response is delayed or fails.
5. Quelles sont les meilleures pratiques pour mettre en œuvre l'authentification et l'autorisation à l'aide de la carte ?
When implementing authentication and authorization in the Execute Code Card, you should store API keys or tokens in Botpress environment variables, send them via secure headers, and include logic to validate user roles or permissions before executing sensitive actions.