Plugins

Le système d'extensions de Hexabot vous permet d'ajouter de nouvelles fonctionnalités et des intégrations personnalisées. Le Hexabot Bibliothèque d'Extensions propose une collection croissante de plugins, canaux et aides créés par la communauté, prêts à être installés et utilisés dans vos propres projets. Les plugins vous permettent d'ajouter "Blocs de Construction" que vous pouvez utiliser au sein du Éditeur Visuel pour construire vos flux. Chaque fois que vous installez ou développez un nouveau plugin personnalisé, un nouveau bloc apparaîtra dans le panneau de gauche de l'éditeur visuel sous la section "Blocs Personnalisés". Ces plugins peuvent aller d'améliorations utilitaires simples à des intégrations tierces avec des applications ou systèmes externes. Cette page explique comment installer et utiliser des plugins existants au sein de votre projet Hexabot, vous permettant d'améliorer votre IA conversationnelle avec un minimum d'effort.

Installer des Plugins

Les plugins sont des paquets publiés via NPM (Node Package Manager) et peuvent être installés en utilisant la ligne de commande. Le CLI Hexabot rend l'installation de n'importe quel plugin disponible très simple et directe.

Processus d'Installation

Pour installer un plugin, vous utiliserez le modèle de commande général suivant dans le répertoire racine de votre projet Hexabot :

npm install hexabot-plugin-[nom-du-plugin]

Convention de Nomination des Plugins :

Par convention, tous les plugins officiels Hexabot et la plupart des plugins publiés par la communauté sur le registre NPM auront des noms de paquets qui commencent par le préfixe hexabot-plugin-. Cela rend les plugins plus faciles à identifier, rechercher et installer.

Exemple : Installer le Plugin Google Gemini pour le RAG

À titre d'exemple concret, considérons le Plugin Google Gemini, qui vous permet de générer des réponses textuelles ainsi que des capacités RAG (Retrieval-Augmented Generation) en utilisant l'API Gemini de Google. Ce plugin permet à votre chatbot / agent de tirer parti de la Base de Connaissances lors de la génération des réponses. Pour installer ce plugin :

1. Ouvrez votre terminal : Naviguez vers le répertoire racine de votre projet Hexabot en utilisant votre terminal.

2. Exécutez la commande d'installation :

npm install hexabot-plugin-gemini

Cette commande téléchargera et installera le plugin Gemini ainsi que toutes les dépendances associées.

1. Activation du Plugin : Après l'installation d'un plugin, vous devrez peut-être redémarrer Hexabot pour que le bloc personnalisé du plugin soit détecté et disponible dans l'éditeur visuel. Des étapes d'activation supplémentaires peuvent également être requises, selon le plugin spécifique. Assurez-vous de consulter les instructions d'installation du plugin dans sa documentation et son dépôt pour toute consigne particulière.

Remarques Importantes :

• Gestion des Dépendances : Lors du processus d'installation, npm gérera automatiquement toutes les dépendances du plugin (autres paquets dont dépend le plugin), rendant la configuration transparente.

• Activation du Plugin: Aucune étape d'activation supplémentaire n'est nécessaire, une fois que vous installez le plugin, le bloc personnalisé correspondant sera automatiquement ajouté à l'Éditeur Visuel. Reportez-vous au README de chaque plugin pour d'éventuelles étapes post-installation.

• Signaler des Problèmes : Si vous rencontrez des problèmes lors de l'installation, veuillez les signaler au dépôt du plugin ou à la communauté Hexabot. Cela est important pour améliorer la stabilité et la disponibilité du plugin pour tous les utilisateurs.

Utiliser le Plugin Installé

Après une installation réussie, un nouveau bloc personnalisé sera automatiquement disponible dans l'Éditeur Visuel Hexabot. Suivez ces étapes pour commencer à utiliser votre plugin récemment installé :

1. Ouvrir l'Éditeur Visuel : Accédez à l'Éditeur Visuel Hexabot via votre navigateur web.

2. Localiser le Bloc du Plugin : Trouvez le bloc personnalisé du plugin dans la section Blocs personnalisés de l'éditeur visuel.

3. Ajouter le bloc à votre flux : Glissez-déposez le bloc dans votre flux de conversation sur la zone de travail.

4. Configurer le Bloc : Cliquez sur le bloc pour configurer ses paramètres, tels que les clés API ou d'autres paramètres spécifiques au plugin.

5. Tester votre flux : Enregistrez votre flux et testez-le dans le Widget de la Console d'Administration qui est la fenêtre de chat affichée en bas à droite de l'écran. Enfin, envoyez le texte qui déclencherait le bloc ajouté pour expérimenter les capacités du plugin que vous avez installé.

Informations Supplémentaires :

• Documentation du Plugin : Consultez toujours le fichier README.md du plugin (souvent disponible sur le dépôt public du plugin ou le repo GitHub) pour plus de détails sur son utilisation.

• Bibliothèque d'Extensions : Visitez la 👉🧩 Bibliothèque d'Extensions Hexabot pour découvrir d'autres plugins qui pourraient améliorer les capacités de vos flux.