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
- Gehen Sie zu Admin → Plugins → Discourse AI → AI Features
- Suchen Sie das Modul Embeddings und konfigurieren Sie es:
- Setzen Sie
ai_embeddings_selected_modelauf eine von Ihnen konfigurierte Embedding-Definition - Aktivieren Sie
ai_embeddings_enabled, um Embeddings zu aktivieren
- Setzen Sie
- 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-smallodertext-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-enoderbge-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.



