Discourse Chatbot 🤖

[merefield (Robert)]

	Résumé	Le premier bot IA pour Discourse
	Lien du dépôt	GitHub - merefield/discourse-chatbot: An AI bot with RAG capability for Topics, Chat & Customer Support in Discourse, currently powered by OpenAI · GitHub
	Guide d’installation	Comment installer des plugins dans Discourse
	Parrainage	Veuillez envisager de devenir un parrain régulier de mon travail open source à un niveau adapté aux ressources et aux besoins de votre organisation ou aux vôtres, afin de garantir que ce plugin reçoive la maintenance qu’il mérite et continue de fonctionner pour votre site à l’avenir.

Vous appréciez ce plugin ? Veuillez lui mettre une sur GitHub !

Étant donné qu’il s’agit d’un plugin contribué de manière indépendante, veuillez soumettre vos demandes de support, de correction de bugs, de retour d’expérience (UX) et de fonctionnalités ici, dans ce sujet. NB Ce plugin n’est pas disponible sur l’hébergement Discourse.org. Vous pouvez l’installer si vous êtes en auto-hébergement et possiblement si vous êtes sur un hébergement tiers (mais vérifiez auprès de votre fournisseur).

Le premier bot IA pour Discourse

Chatbot apporte des conversations IA configurables aux Sujets, Messages Personnels, canaux de Chat et fils de Chat. Donnez au bot un personnage qui convient à votre communauté, décidez quels groupes peuvent l’utiliser et choisissez différents modèles et outils pour les utilisateurs à faible, moyen et haut niveau de confiance.

Il peut :

• répondre normalement à partir de la conversation actuelle ;
• rechercher dans le contenu du forum sélectionné avec une recherche sémantique ou hybride ;
• rechercher sur Wikipédia, les actualités actuelles et le web ;
• parcourir des pages distantes et récupérer les données de marché de fin de journée ;
• effectuer des calculs fiables basés sur des expressions ;
• voir les images téléversées et lire optionnellement des PDF ;
• générer et modifier des images ;
• collecter les Champs Utilisateur modifiables en suspens dans les conversations privées ;
• escalader les conversations de Chat privées vers des groupes de personnel configurés ;
• répondre automatiquement aux nouveaux Sujets dans des Catégories sélectionnées ; et
• accepter des outils supplémentaires fournis par d’autres plugins.

Pour un flux de travail de support pratique, voir Créer un bot de chat de support technique.

Avec la recherche locale du forum activée, le bot peut ancrer les réponses dans le contenu de votre communauté :

Pour des conversations plus simples, exposez moins d’outils ou aucun pour réduire les appels, la latence et le coût :

Support des fournisseurs

Choisissez les fournisseurs indépendamment pour les réponses, les embeddings, la vision et la génération d’images. Chaque capacité réutilise la clé API appartenant au fournisseur sélectionné.

Capacité	OpenAI	Anthropic	Google Gemini	xAI
Réponses LLM et outils
Embeddings		—
Vision
Génération d’images		—
Édition d’images	Modèles GPT Image	—	—
Entrée de conversation PDF		—	—	—

Si aucune URL personnalisée n’est définie, Chatbot utilise son point de terminaison officiel intégré pour le fournisseur sélectionné. Les noms de modèles et les URL personnalisés prennent en charge Azure OpenAI, Ollama, les proxys et d’autres services qui implémentent la forme d’API d’un fournisseur pris en charge.

Les listes déroulantes de modèles spécifiques au fournisseur ne sont affichées que lorsque ce fournisseur est actif. Le modèle de réponse peut différer selon le niveau de confiance, tandis que les embeddings, la vision et la génération d’images ont chacun leur propre sélecteur de fournisseur et de modèle.

Lisez le guide complet des fournisseurs et des points de terminaison personnalisés.

Accès, quotas et outils

Personne n’a accès tant que vous n’avez pas assigné de groupes aux paramètres de groupe à faible, moyen ou haut niveau de confiance de Chatbot. Les utilisateurs héritent du quota, du modèle et de la liste blanche d’outils de leur niveau de confiance Chatbot le plus élevé correspondant. Les quotas peuvent être mesurés en requêtes ou en jetons.

Les outils intégrés sont sélectionnés indépendamment pour chaque niveau de confiance. Les identifiants et les paramètres d’assistance contrôlent toujours la disponibilité au moment de l’exécution, donc sélectionner un outil web sans sa clé API ne l’expose pas.

Lisez à propos de l’accès et des quotas et des outils par niveau de confiance.

Recherche locale du forum et confidentialité

Veuillez comprendre la portée des embeddings avant d’activer la recherche locale du forum.

La stratégie par défaut benchmark_user crée des embeddings du contenu visible pour un utilisateur approprié au niveau de confiance configuré. La stratégie categories crée des embeddings du contenu des Catégories explicitement sélectionnées. La recherche sémantique est optimisée pour la vitesse et ne répète pas une vérification de visibilité pour chaque personne demandant au bot, donc le contenu correspondant peut être partagé en dehors de son audience d’origine si la portée inclut du contenu restreint.

Les Messages Personnels ne sont jamais incorporés en embeddings. Gardez le niveau de confiance de référence bas, évitez les Catégories privées sauf si leur contenu peut être divulgué à chaque utilisateur de Chatbot, et retirez local_forum_search des niveaux de confiance qui ne devraient pas l’utiliser.

Les fournisseurs sélectionnés peuvent recevoir le contenu des conversations, les téléversements, les correspondances de recherche incorporées et les résultats des outils. Examinez leurs conditions de rétention et d’utilisation des données, et divulguez ce traitement dans les conditions et l’avis de confidentialité de votre forum.

Lisez le guide complet des embeddings, de la portée et de la confidentialité.

Démarrage rapide

1. Installez le plugin en utilisant la procédure normale de plugin auto-hébergé.
2. Sélectionnez chatbot_llm_provider, entrez la clé API de ce fournisseur et choisissez des modèles pour chaque niveau de confiance.
3. Ajoutez des groupes aux paramètres d’accès à faible, moyen ou haut niveau de confiance et configurez les quotas.
4. Choisissez les outils intégrés disponibles pour chaque niveau de confiance.
5. Si vous activez local_forum_search, configurez son fournisseur d’embeddings et examinez soigneusement sa portée.
6. Mentionnez le bot, répondez-lui, utilisez le bouton d’accès rapide ou configurez un prompt de réponse automatique de Catégorie.

Exemple rapide OpenAI

1. Créez une clé API OpenAI et assurez-vous que la facturation API est activée.
2. Définissez chatbot_llm_provider sur OpenAI et collez la clé dans chatbot_open_ai_token.
3. Laissez l’URL personnalisée vide, choisissez un modèle OpenAI pour chaque niveau de confiance que vous avez l’intention d’utiliser et ajoutez votre groupe de test au paramètre d’accès Chatbot correspondant.
4. Mentionnez le bot dans un Sujet, Message Personnel ou Chat autorisé pour le tester.

Le README du dépôt est la source de vérité pour les prérequis, chaque groupe de paramètres majeur, le comportement spécifique au fournisseur, les points de terminaison personnalisés, la maintenance des embeddings, la personnalisation des prompts, le débogage, le développement d’extensions et le désinstallation :

Ouvrir le README complet

Fonctionnalités UI sélectionnées

Les Catégories peuvent accueillir un nouveau Sujet et demander au bot de rechercher un contenu communautaire pertinent :

Le bouton d’accès rapide optionnel peut ouvrir un Chat ou un Message Personnel direct avec le bot :

L’outil Champs Utilisateur peut collecter en privé les champs vides pris en charge :

Support et parrainage

Veuillez signaler les demandes de support, les bugs, les retours UX et les idées de fonctionnalités dans ce sujet Meta. Incluez le fournisseur, le nom du modèle, les paramètres pertinents, le statut HTTP et le corps de la réponse du fournisseur, tout en supprimant les clés API et le contenu privé.

Ce travail dépend du support de la communauté. Si le plugin est précieux pour votre site, veuillez parrainer sa maintenance en cours.

Parrains du projet

Parrain	Niveau	Site web
Surety	Silver Plus	suretyhome.com

Avertissement

Les LLM peuvent produire des sorties convaincantes mais incorrectes. Testez le plugin par rapport aux besoins de votre communauté, comprenez les implications en matière de confidentialité et de coût, et appliquez une modération appropriée. Les conditions des sorties générées varient selon le fournisseur et la juridiction ; examinez les conditions de chaque fournisseur que vous activez.