Discourse AI - Temas relacionados

[Discourse]

Esta guía explica cómo habilitar y configurar la función de Temas relacionados del plugin Discourse AI.

Nivel de usuario requerido: Administrador

Temas relacionados ayuda a los usuarios a descubrir contenido relevante sugiriendo temas semánticamente similares basados en el que están leyendo actualmente. Esto mejora la exploración de contenido y aumenta la participación del usuario.

Características

• Similitud textual semántica: Va más allá de la coincidencia de palabras clave para encontrar contenido verdaderamente relacionado
• Alternar entre temas “Sugeridos” y “Relacionados”
• Disponible para usuarios anónimos y registrados

Habilitar Temas relacionados

Temas relacionados está activado por defecto para todos los clientes alojados en Discourse con el plugin Discourse AI activado.

Prerrequisitos

Temas relacionados requiere Embeddings para funcionar.

Si estás en nuestro hosting, Embeddings se proporciona utilizando un modelo de código abierto. No se requiere configuración adicional.

Las instancias autohospedadas necesitarán configurar un modelo de incrustación a través de un proveedor compatible.

Configuración

1. Ve a Admin → Plugins → Discourse AI → AI Features
2. Encuentra el módulo Embeddings y configúralo:
   • Establece ai_embeddings_selected_model en una definición de incrustación que hayas configurado
   • Habilita ai_embeddings_enabled para activar Embeddings
3. Habilita ai_embeddings_semantic_related_topics_enabled para activar la función Temas relacionados

Configuración de un modelo de incrustación

Antes de habilitar las incrustaciones, debes configurar un modelo de incrustación. Ve a Admin → Plugins → Discourse AI → Embeddings para crear una nueva definición de incrustación. Puedes elegir entre varias configuraciones preestablecidas:

• Open AI: text-embedding-3-small o text-embedding-3-large (recomendado para la mayoría de los sitios)
• Google: gemini-embedding-001
• Hugging Face (inferencia autohospedada): multilingual-e5-large (recomendado para sitios no ingleses o multilingües), bge-large-en, o bge-m3

Deberás proporcionar una clave de API (o vincular un Secreto de IA) y la URL del endpoint para el proveedor elegido.

Configuración adicional

La siguiente configuración te permite ajustar la función Temas relacionados:

• ai_embeddings_semantic_related_topics: Número máximo de temas a mostrar en la sección de temas relacionados (predeterminado: 5)
• ai_embeddings_semantic_related_include_closed_topics: Si incluir temas cerrados en los resultados relacionados (predeterminado: true)
• ai_embeddings_semantic_related_age_penalty: Aplicar una penalización a los temas más antiguos para priorizar el contenido más nuevo (predeterminado: 0.0, rango: 0.0–2.0)
• ai_embeddings_semantic_related_age_time_scale: Escala de tiempo en días para la penalización por antigüedad (predeterminado: 365)

FAQ Técnico

Expandir para ver un diagrama de la arquitectura de Temas relacionados

El resumen es que cuando se crea/actualiza un tema, sucede esto:

sequenceDiagram
    User->>Discourse: Crea tema
    Discourse-->>Embedding Microservice: Genera incrustaciones
    Embedding Microservice-->>Discourse: 
    Discourse-->>PostgreSQL: Almacena incrustaciones 

Y durante la visita al tema:

sequenceDiagram
    User->>Discourse: Visita tema
    Discourse-->>PostgreSQL: Consulta temas más cercanos
    PostgreSQL-->>Discourse: 
    Discourse->>User: Presenta temas relacionados 

¿Cómo funciona Temas relacionados?

• Cuando un usuario visita un tema, Discourse consulta la base de datos para encontrar los temas semánticamente más similares basándose en sus representaciones incrustadas. Estos temas relacionados se presentan luego al usuario, fomentando una mayor exploración del contenido de la comunidad.

¿Cómo se procesan los datos de temas/publicaciones?

• Para los sitios alojados en Discourse, los datos se procesan dentro de nuestro centro de datos de red privada virtual segura. Para los sitios autohospedados, el procesamiento de datos depende del proveedor de terceros que hayas elegido.

¿Dónde se almacenan los datos de incrustaciones?

• Los datos de incrustaciones se almacenan en tu base de datos de Discourse, junto con otros datos del foro como temas, publicaciones y usuarios.

¿Qué modelos de incrustación están disponibles?

• Discourse AI admite modelos de OpenAI (text-embedding-3-small, text-embedding-3-large), Google (gemini-embedding-001), endpoints compatibles con Hugging Face (bge-large-en, bge-m3, multilingual-e5-large) y Cloudflare Workers AI. También puedes configurar modelos de incrustación personalizados a través de la interfaz de administración.