Questa guida spiega come abilitare e configurare la funzionalitĂ Argomenti correlati del plugin Discourse AI.
Livello utente richiesto: Amministratore
Gli argomenti correlati aiutano gli utenti a scoprire contenuti pertinenti suggerendo argomenti semanticamente simili in base a quello che stanno attualmente leggendo. Ciò migliora l’esplorazione dei contenuti e aumenta il coinvolgimento degli utenti.
FunzionalitĂ
- Similitudine testuale semantica: va oltre il confronto delle parole chiave per trovare contenuti veramente correlati
- Passa da argomenti “Suggeriti” a “Correlati”
- Disponibile sia per utenti anonimi che registrati
Abilitazione degli argomenti correlati
Gli argomenti correlati sono attivati per impostazione predefinita per tutti i clienti ospitati su Discourse con il plugin Discourse AI abilitato.
Prerequisiti
Gli argomenti correlati richiedono Embeddings per funzionare.
Se sei sul nostro hosting, gli Embeddings vengono forniti utilizzando un modello open-source. Non è necessaria alcuna configurazione aggiuntiva.
Le istanze self-hosted dovranno fornire i propri Embeddings tramite un provider di terze parti.
Configurazione
- Vai su Admin → Impostazioni → Plugin
- Cerca “discourse-ai” e assicurati che sia abilitato
- Abilita
ai_embeddings_enabledper attivare gli Embeddings - Abilita
ai_embeddings_semantic_related_topics_enabledper attivare la funzionalitĂ Argomenti correlati
Configurazione aggiuntiva
A seconda della tua configurazione, potrebbe essere necessario regolare le seguenti impostazioni:
- Per siti non in lingua inglese (ospitati su Discourse o self-hosted con modello proprio):
Impostaai embeddings modelsumultilingual-e5-large - Per Cloudflare Workers AI:
Impostaai embeddings modelsubge-large-en - Per OpenAI o Azure OpenAI:
Impostaai embeddings modelsutext-embedding-ada-002
FAQ tecniche
Espandi per visualizzare un diagramma dell'architettura degli Argomenti correlati
La panoramica è che, quando un argomento viene creato/aggiornato, accade questo:
sequenceDiagram
User->>Discourse: Crea argomento
Discourse-->>Embedding Microservice: Genera embeddings
Embedding Microservice-->>Discourse:
Discourse-->>PostgreSQL: Memorizza Embeddings
E durante la visita di un argomento:
sequenceDiagram
User->>Discourse: Visita argomento
Discourse-->>PostgreSQL: Interroga argomenti piĂą vicini
PostgreSQL-->>Discourse:
Discourse->>User: Presenta argomenti correlati
Come funzionano gli Argomenti correlati?
- Quando un utente visita un argomento, Discourse interroga il database per gli argomenti semanticamente più simili in base alle loro rappresentazioni incorporate. Questi argomenti correlati vengono quindi presentati all’utente, incoraggiando un’ulteriore esplorazione dei contenuti della community.
Come vengono elaborati i dati degli argomenti/post?
- Per i siti ospitati su Discourse, i dati vengono elaborati all’interno del nostro data center virtuale privato sicuro. Per i siti self-hosted, l’elaborazione dei dati dipende dal provider di terze parti scelto.
Dove vengono archiviati i dati degli embeddings?
- I dati degli embeddings sono archiviati nel tuo database Discourse, insieme ad altri dati del forum come argomenti, post e utenti.
Quale modello semantico viene utilizzato e come è stato addestrato?
- I siti ospitati su Discourse utilizzano per impostazione predefinita il modello all-mpnet-base-v2. Questo modello funziona bene sia per community di nicchia che generali. I siti self-hosted possono utilizzare modelli diversi a seconda del provider scelto.