Discourse AI - Tópicos relacionados

[Discourse]

Este guia explica como habilitar e configurar o recurso Tópicos relacionados do plugin Discourse AI.

Nível de usuário necessário: Administrador

Tópicos relacionados ajuda os usuários a descobrir conteúdo relevante, sugerindo tópicos semanticamente semelhantes com base no que eles estão lendo no momento. Isso aprimora a exploração de conteúdo e aumenta o engajamento do usuário.

Funcionalidades

• Similaridade textual semântica: Vai além da correspondência de palavras-chave para encontrar conteúdo verdadeiramente relacionado
• Alternar entre tópicos “Sugeridos” e “Relacionados”
• Disponível para usuários anônimos e logados

Habilitando Tópicos relacionados

Tópicos relacionados está ativado por padrão para todos os clientes hospedados do Discourse com o plugin Discourse AI habilitado

Pré-requisitos

Tópicos relacionados requer Embeddings para funcionar.

Se você estiver em nossa hospedagem, Embeddings é fornecido usando um modelo de código aberto. Nenhuma configuração adicional é necessária.

Instâncias auto-hospedadas precisarão fornecer seus próprios Embeddings através de um provedor terceirizado.

Configuração

1. Vá para Admin → Configurações → Plugins
2. Procure por “discourse-ai” e certifique-se de que está habilitado
3. Habilite ai_embeddings_enabled para ativar Embeddings
4. Habilite ai_embeddings_semantic_related_topics_enabled para ativar o recurso Tópicos Relacionados

Configuração adicional

Dependendo da sua configuração, você pode precisar ajustar as seguintes configurações:

• Para sites não ingleses (hospedados pelo Discourse ou auto-hospedados com modelo próprio):
  Defina ai embeddings model para multilingual-e5-large
• Para Cloudflare Workers AI:
  Defina ai embeddings model para bge-large-en
• Para OpenAI ou Azure OpenAI:
  Defina ai embeddings model para text-embedding-ada-002

FAQ Técnico

Expandir para ver um diagrama da arquitetura de Tópicos relacionados

A visão geral é que, quando um tópico é criado / atualizado, isso acontece:

sequenceDiagram
    User->>Discourse: Cria tópico
    Discourse-->>Embedding Microservice: Gera embeddings
    Embedding Microservice-->>Discourse:
    Discourse-->>PostgreSQL:Armazena Embeddings

E durante a visita ao tópico:

sequenceDiagram
    User->>Discourse: Visita tópico
    Discourse-->>PostgreSQL: Consulta tópicos mais próximos
    PostgreSQL-->>Discourse:
    Discourse->>User: Apresenta tópicos relacionados

Como funcionam os Tópicos relacionados?

• Quando um usuário visita um tópico, o Discourse consulta o banco de dados em busca dos tópicos semanticamente mais semelhantes com base em suas representações incorporadas. Esses tópicos relacionados são então apresentados ao usuário, incentivando uma maior exploração do conteúdo da comunidade.

Como os dados do tópico/postagem são processados?

• Para sites hospedados pelo Discourse, os dados são processados dentro de nosso data center virtual privado seguro. Para sites auto-hospedados, o processamento de dados depende do provedor terceirizado escolhido.

Onde os dados de embeddings são armazenados?

• Os dados de embeddings são armazenados em seu banco de dados Discourse, juntamente com outros dados do fórum, como tópicos, postagens e usuários.

Qual modelo semântico é usado e como ele foi treinado?

• Sites hospedados pelo Discourse usam o modelo all-mpnet-base-v2 por padrão. Este modelo tem bom desempenho tanto para comunidades de nicho quanto gerais. Sites auto-hospedados podem usar modelos diferentes dependendo do provedor escolhido.