Discourse AI - Verwandte Themen

[Discourse]

Diese Anleitung erklärt, wie die Funktion „Verwandte Themen“ des Plugins Discourse AI aktiviert und konfiguriert wird.

Erforderliches Benutzerniveau: Administrator

Verwandte Themen hilft Benutzern, relevante Inhalte zu entdecken, indem semantisch ähnliche Themen basierend auf dem aktuell gelesenen Thema vorgeschlagen werden. Dies verbessert die Inhaltserkundung und steigert das Benutzerengagement.

Funktionen

• Semantische Textähnlichkeit: Geht über die Schlüsselwortsuche hinaus, um wirklich verwandte Inhalte zu finden
• Umschalten zwischen „Vorgeschlagenen“ und „Verwandten“ Themen
• Verfügbar für anonyme und eingeloggte Benutzer

Verwandte Themen aktivieren

Verwandte Themen ist standardmäßig für alle Discourse-gehosteten Kunden aktiviert, bei denen das Discourse AI Plugin aktiviert ist.

Voraussetzungen

Verwandte Themen erfordert Embeddings, um zu funktionieren.

Wenn Sie bei uns hosten, werden Embeddings mithilfe eines Open-Source-Modells bereitgestellt. Es ist keine zusätzliche Einrichtung erforderlich.

Selbst gehostete Instanzen müssen ein Embedding-Modell über einen unterstützten Anbieter konfigurieren.

Konfiguration

1. Gehen Sie zu Admin → Plugins → Discourse AI → AI Features
2. Suchen Sie das Modul Embeddings und konfigurieren Sie es:
   • Setzen Sie ai_embeddings_selected_model auf eine von Ihnen konfigurierte Embedding-Definition
   • Aktivieren Sie ai_embeddings_enabled, um Embeddings zu aktivieren
3. Aktivieren Sie ai_embeddings_semantic_related_topics_enabled, um die Funktion Verwandte Themen zu aktivieren

Einrichten eines Embedding-Modells

Bevor Sie Embeddings aktivieren, müssen Sie ein Embedding-Modell konfigurieren. Gehen Sie zu Admin → Plugins → Discourse AI → Embeddings, um eine neue Embedding-Definition zu erstellen. Sie können aus mehreren Voreinstellungen wählen:

• Open AI: text-embedding-3-small oder text-embedding-3-large (empfohlen für die meisten Websites)
• Google: gemini-embedding-001
• Hugging Face (Self-hosted Inference): multilingual-e5-large (empfohlen für nicht-englische oder mehrsprachige Websites), bge-large-en oder bge-m3

Sie müssen einen API-Schlüssel (oder einen AI Secret) und eine Endpunkt-URL für den gewählten Anbieter angeben.

Zusätzliche Einstellungen

Die folgenden Einstellungen ermöglichen es Ihnen, die Funktion Verwandte Themen fein abzustimmen:

• ai_embeddings_semantic_related_topics: Maximale Anzahl von Themen, die im Abschnitt „Verwandte Themen“ angezeigt werden sollen (Standard: 5)
• ai_embeddings_semantic_related_include_closed_topics: Ob geschlossene Themen in den verwandten Ergebnissen enthalten sein sollen (Standard: true)
• ai_embeddings_semantic_related_age_penalty: Wenden Sie eine Strafe auf ältere Themen an, sodass neueren Inhalten der Vorzug gegeben wird (Standard: 0.0, Bereich: 0.0–2.0)
• ai_embeddings_semantic_related_age_time_scale: Zeitskala in Tagen für die Altersstrafe (Standard: 365)

Technisches FAQ

Zum Anzeigen eines Diagramms der Architektur von Verwandte Themen erweitern

Die Übersicht ist, dass bei der Erstellung/Aktualisierung eines Themas Folgendes geschieht:

sequenceDiagram
    User->>Discourse: Erstellt Thema
    Discourse-->>Embedding Microservice: Generiert Embeddings
    Embedding Microservice-->>Discourse: 
    Discourse-->>PostgreSQL: Speichert Embeddings 

Und beim Besuch eines Themas:

sequenceDiagram
    User->>Discourse: Besucht Thema
    Discourse-->>PostgreSQL: Fragt nach den ähnlichsten Themen
    PostgreSQL-->>Discourse: 
    Discourse->>User: Präsentiert verwandte Themen 

Wie funktioniert Verwandte Themen?

• Wenn ein Benutzer ein Thema besucht, fragt Discourse die Datenbank nach den semantisch ähnlichsten Themen, basierend auf deren eingebetteten Darstellungen. Diese verwandten Themen werden dem Benutzer dann präsentiert, was zur weiteren Erkundung der Inhalte der Community anregt.

Wie werden Themen-/Beitragsdaten verarbeitet?

• Bei Discourse-gehosteten Websites werden Daten in unserem sicheren virtuellen privaten Rechenzentrum verarbeitet. Bei selbst gehosteten Websites hängt die Datenverarbeitung von dem von Ihnen gewählten Drittanbieter ab.

Wo werden die Embedding-Daten gespeichert?

• Die Embedding-Daten werden in Ihrer Discourse-Datenbank gespeichert, zusammen mit anderen Forendaten wie Themen, Beiträgen und Benutzern.

Welche Embedding-Modelle sind verfügbar?

• Discourse AI unterstützt Modelle von OpenAI (text-embedding-3-small, text-embedding-3-large), Google (gemini-embedding-001), Hugging Face-kompatiblen Endpunkten (bge-large-en, bge-m3, multilingual-e5-large) und Cloudflare Workers AI. Sie können auch benutzerdefinierte Embedding-Modelle über die Admin-Oberfläche konfigurieren.