Discourse AI - Sujets liés

[Discourse]

Ce guide explique comment activer et configurer la fonctionnalité de sujets connexes du plugin Discourse AI.

Niveau d’utilisateur requis : Administrateur

Les sujets connexes aident les utilisateurs à découvrir du contenu pertinent en suggérant des sujets sémantiquement similaires à celui qu’ils lisent actuellement. Cela améliore l’exploration du contenu et augmente l’engagement des utilisateurs.

Fonctionnalités

• Similarité sémantique textuelle : Va au-delà de la correspondance par mots-clés pour trouver du contenu véritablement connexe
• Basculer entre les sujets « Suggérés » et « Connexes »
• Disponible pour les utilisateurs anonymes et connectés

Activation des sujets connexes

Les sujets connexes sont activés par défaut pour tous les clients hébergés par Discourse avec le plugin Discourse AI activé.

Prérequis

Les sujets connexes nécessitent des Embeddings pour fonctionner.

Si vous êtes sur notre hébergement, les Embeddings sont fournis à l’aide d’un modèle open-source. Aucune configuration supplémentaire n’est requise.

Les instances auto-hébergées devront fournir leurs propres Embeddings via un fournisseur tiers.

Configuration

1. Accédez à Admin → Paramètres → Plugins
2. Recherchez « discourse-ai » et assurez-vous qu’il est activé
3. Activez ai_embeddings_enabled pour activer les Embeddings
4. Activez ai_embeddings_semantic_related_topics_enabled pour activer la fonctionnalité Sujets connexes

Configuration supplémentaire

Selon votre configuration, vous devrez peut-être ajuster les paramètres suivants :

• Pour les sites non anglais (hébergés par Discourse ou auto-hébergés avec leur propre modèle) :
  Définissez ai embeddings model sur multilingual-e5-large
• Pour Cloudflare Workers AI :
  Définissez ai embeddings model sur bge-large-en
• Pour OpenAI ou Azure OpenAI :
  Définissez ai embeddings model sur text-embedding-ada-002

FAQ technique

Développer pour voir un diagramme de l'architecture des sujets connexes

L’aperçu est que lorsqu’un sujet est créé / mis à jour, voici ce qui se passe :

sequenceDiagram
    User->>Discourse: Crée un sujet
    Discourse-->>Embedding Microservice: Génère des embeddings
    Embedding Microservice-->>Discourse: 
    Discourse-->>PostgreSQL: Stocke les embeddings 

Et lors de la visite d’un sujet :

sequenceDiagram
    User->>Discourse: Visite un sujet
    Discourse-->>PostgreSQL: Interroge les sujets les plus proches
    PostgreSQL-->>Discourse: 
    Discourse->>User: Présente les sujets connexes 

Comment fonctionnent les sujets connexes ?

• Lorsqu’un utilisateur visite un sujet, Discourse interroge la base de données pour trouver les sujets sémantiquement les plus similaires en fonction de leurs représentations embarquées. Ces sujets connexes sont ensuite présentés à l’utilisateur, encourageant une exploration plus approfondie du contenu de la communauté.

Comment les données des sujets/messages sont-elles traitées ?

• Pour les sites hébergés par Discourse, les données sont traitées dans notre centre de données virtuel privé sécurisé. Pour les sites auto-hébergés, le traitement des données dépend du fournisseur tiers que vous avez choisi.

Où sont stockées les données d’embeddings ?

• Les données d’embeddings sont stockées dans votre base de données Discourse, aux côtés d’autres données du forum telles que les sujets, les messages et les utilisateurs.

Quel modèle sémantique est utilisé et comment a-t-il été entraîné ?

• Les sites hébergés par Discourse utilisent par défaut le modèle all-mpnet-base-v2. Ce modèle fonctionne bien pour les communautés de niche et générales. Les sites auto-hébergés peuvent utiliser différents modèles en fonction du fournisseur choisi.