Discourse AI - Argomenti correlati

[Discourse]

Questa guida spiega come abilitare e configurare la funzione Argomenti correlati del plugin Discourse AI.

Livello utente richiesto: Amministratore

Argomenti correlati aiuta gli utenti a scoprire contenuti pertinenti suggerendo argomenti semanticamente simili a quello che stanno leggendo attualmente. Ciò migliora l’esplorazione dei contenuti e aumenta il coinvolgimento degli utenti.

Funzionalità

• Somiglianza testuale semantica: Va oltre la corrispondenza delle parole chiave per trovare contenuti veramente correlati
• Alterna tra argomenti “Suggeriti” e “Correlati”
• Disponibile sia per utenti anonimi che per utenti registrati

Abilitazione di Argomenti correlati

Argomenti correlati è attivato di default per tutti i clienti ospitati su Discourse con il plugin Discourse AI abilitato

Prerequisiti

Argomenti correlati richiede Embeddings per funzionare.

Se si utilizza il nostro hosting, Embeddings viene fornito utilizzando un modello open-source. Non è necessaria alcuna configurazione aggiuntiva.

Le istanze self-hosted dovranno configurare un modello di embedding tramite un provider supportato.

Configurazione

1. Vai su Amministrazione → Plugin → Discourse AI → Funzionalità AI
2. Trova il modulo Embeddings e configurarlo:
   • Imposta ai_embeddings_selected_model su una definizione di embedding che hai configurato
   • Abilita ai_embeddings_enabled per attivare Embeddings
3. Abilita ai_embeddings_semantic_related_topics_enabled per attivare la funzione Argomenti correlati

Impostazione di un modello di embedding

Prima di abilitare gli embedding, è necessario configurare un modello di embedding. Vai su Amministrazione → Plugin → Discourse AI → Embeddings per creare una nuova definizione di embedding. Puoi scegliere tra diverse preimpostazioni:

• Open AI: text-embedding-3-small o text-embedding-3-large (consigliato per la maggior parte dei siti)
• Google: gemini-embedding-001
• Hugging Face (inferenza self-hosted): multilingual-e5-large (consigliato per siti non inglesi o multilingue), bge-large-en, o bge-m3

Dovrai fornire una chiave API (o collegare un AI Secret) e un URL dell’endpoint per il provider scelto.

Impostazioni aggiuntive

Le seguenti impostazioni consentono di ottimizzare la funzione Argomenti correlati:

• ai_embeddings_semantic_related_topics: Numero massimo di argomenti da mostrare nella sezione argomenti correlati (default: 5)
• ai_embeddings_semantic_related_include_closed_topics: Se includere argomenti chiusi nei risultati correlati (default: true)
• ai_embeddings_semantic_related_age_penalty: Applica una penalità agli argomenti più vecchi in modo che i contenuti più recenti abbiano la priorità (default: 0.0, intervallo: 0.0–2.0)
• ai_embeddings_semantic_related_age_time_scale: Scala temporale in giorni per la penalità di età (default: 365)

FAQ Tecniche

Espandi per visualizzare un diagramma dell'architettura di Argomenti correlati

La panoramica è che quando un argomento viene creato/aggiornato, accade questo:

sequenceDiagram
    User->>Discourse: Crea argomento
    Discourse-->>Embedding Microservice: Genera embedding
    Embedding Microservice-->>Discourse: 
    Discourse-->>PostgreSQL: Memorizza Embedding 

E durante la visita dell’argomento:

sequenceDiagram
    User->>Discourse: Visita argomento
    Discourse-->>PostgreSQL: Interroga argomenti più vicini
    PostgreSQL-->>Discourse: 
    Discourse->>User: Presenta argomenti correlati 

Come funziona Argomenti correlati?

• Quando un utente visita un argomento, Discourse interroga il database per trovare 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 di argomenti/post?

• Per i siti ospitati su Discourse, i dati vengono elaborati all’interno del nostro sicuro data center virtuale privato. Per i siti self-hosted, l’elaborazione dei dati dipende dal provider di terze parti scelto.

Dove vengono memorizzati i dati degli embedding?

• I dati degli embedding sono memorizzati nel tuo database Discourse, insieme ad altri dati del forum come argomenti, post e utenti.

Quali modelli di embedding sono disponibili?

• Discourse AI supporta modelli di OpenAI (text-embedding-3-small, text-embedding-3-large), Google (gemini-embedding-001), endpoint compatibili con Hugging Face (bge-large-en, bge-m3, multilingual-e5-large) e Cloudflare Workers AI. È inoltre possibile configurare modelli di embedding personalizzati tramite l’interfaccia di amministrazione.