Instalar y configurar Discourse AI con OpenAI (Metodo directo)

Soporte
1

Manual de Instalación de Discourse AI - Método Directo con OpenAI

Fase 1: Instalación Directa del Plugin (En las versiones más nuevas este plugin ya viene precargado, solo se necesita activar desde la sección de “Plugins”, en ese caso se omite esta fase)

Paso 1: Accede a tu servidor

# Conéctate por SSH y ve a tu carpeta de instalación 
cd /var/foro-kontrolya

Paso 2: Entra al contenedor de Discourse

./launcher enter app
Verás que el prompt cambia a algo como `root@falcon945-foro-kontrolya:/var/www/discourse#`

Paso 3: Instala el plugin de IA

# Ve a la carpeta de plugins
cd plugins

# Clona el repositorio del plugin
git clone https://github.com/discourse/discourse-ai

# Verifica que se instaló correctamente
ls -la | grep discourse-ai

Deberías ver `discourse-ai` en la lista.

Paso 4: Sal del contenedor y reinicia

# Sal del contenedor
exit

# Reinicia Discourse desde tu carpeta principal
cd /var/foro-kontrolya
./launcher restart app

Fase 2: Obtener API Key de OpenAI

Paso 5: Consigue tu API key de OpenAI

  1. Ve a https://platform.openai.com/api-keys
  2. Inicia sesión en tu cuenta de OpenAI (si no tienes, créala)
  3. Haz clic en “Create new secret key”
  4. Dale un nombre (ej. “Discourse AI”)
  5. Copia la API key y guárdala en un lugar seguro (comienza con “sk-…”)
  6. Asegúrate de tener saldo en tu cuenta (OpenAI es de pago por uso)

Fase 3: Configuración del Plugin en el Panel Admin

Paso 6: Accede al panel de administración

  1. Abre tu navegador y ve a: tudominio.com/admin
  2. En el menú izquierdo, haz clic en Plugins
  3. Busca Discourse AI en la lista y haz clic en Settings

Paso 7: Configurar el modelo de lenguaje (LLM) con OpenAI

  1. Dentro de Settings, ve a la pestaña LLM
  2. Haz clic en + New Model (o busca “Custom (manual configuration)” y haz clic en Set )
  3. Completa los campos con los siguientes datos :
Campo Valor
Provider OpenAI
Name to display OpenAI GPT-4o (o el nombre que prefieras)
Model name gpt-4o (o gpt-4 , gpt-3.5-turbo , etc.)
Service hosting the model OpenAI
URL of the service https://api.openai.com/v1/chat/completions
API Key sk-... (tu API key de OpenAI)
Tokenizer OpenAiTokenizer
Number of tokens for the prompt 8192 (para GPT-4o)
  1. Haz clic en Save y luego en Run Test para verificar la conexión

Modelos recomendados de OpenAI :

  • gpt-4o - Mejor equilibrio calidad/velocidad
  • gpt-4o-mini - Más económico, ideal para tareas simples
  • gpt-4 - Alta calidad (más costoso)
  • gpt-3.5-turbo - El más económico

Fase 4: Configuración de Embeddings con OpenAI

Los embeddings son vectores que permiten la búsqueda semántica y temas relacionados .

Paso 8: Configurar modelo de embeddings

  1. Ve a la pestaña Embeddings
  2. Haz clic en + New Embedding
  3. Configura los siguientes campos :
Campo Valor
Provider OpenAI
Display Name OpenAI Embeddings
Endpoint URL https://api.openai.com/v1/embeddings
API Key sk-... (tu API key de OpenAI)
Model name text-embedding-3-small (nombre interno)
Model ID text-embedding-3-small (o text-embedding-3-large )
Tokenizer OpenAiTokenizer
Max Sequence Length 8191
Embedding Type Selecciona Document y Query
  1. Haz clic en Save y luego en Run Test para verificar

Modelos de embedding de OpenAI :

  • text-embedding-3-small - Más económico, buen rendimiento
  • text-embedding-3-large - Mayor precisión, más costoso

Fase 5: Activar las Funciones de IA

Paso 9: Configuración general del plugin

  1. En el panel de administración, ve a Settings (configuración general del sitio)
  2. En el buscador de settings, escribe ai para filtrar

Paso 10: Activar los embeddings

Configura:

  • ai embeddings enabled : :white_check_mark: ACTIVADO
  • ai embeddings selected model : Selecciona OpenAI Embeddings (el que creaste)

Paso 11: Activar temas relacionados

Busca semantic related y configura:

  • ai embeddings semantic related topics enabled : :white_check_mark: ACTIVADO
  • ai embeddings semantic related topics : 5 (número de temas a mostrar)

Paso 12: Activar búsqueda semántica

  1. Busca semantic search en settings
  2. Configura:
  • ai embeddings semantic search hyde model : Selecciona OpenAI GPT-4o (tu LLM)
  • ai embeddings semantic search enabled : :white_check_mark: ACTIVADO

Paso 13: (Opcional) Activar otras funciones útiles

  • AI Helper :
    • ai helper enabled : :white_check_mark: ACTIVADO
    • ai helper allowed groups : Selecciona los grupos que pueden usarlo (staff, trust level 3 y 4, etc.)
    • Esta función añade un asistente en el editor para: revisar ortografía, traducir, generar tablas, sugerir títulos
  • Resumen automático de temas :
    • ai summarization enabled : :white_check_mark: ACTIVADO
  • Traducción automática :
    • ai translation enabled : :white_check_mark: ACTIVADO (traduce automáticamente el contenido)
  • Detección de spam :
    • ai spam detection enabled : :white_check_mark: ACTIVADO

Fase 6: Generar Embeddings para Contenido Existente

Paso 14: Procesar mensajes antiguos

Este paso es crucial para que la búsqueda semántica y temas relacionados funcionen con TODO el contenido de tu foro .

# Desde tu servidor, entra al contenedor
cd /var/foro-kontrolya
./launcher enter app

# Ejecuta el comando para generar embeddings de TODO el contenido
rake ai:embeddings:backfill

# Verás un progreso en pantalla
# Puede tardar minutos u horas según el tamaño de tu foro
# Cuando termine, sal del contenedor
exit

Paso 15: Reinicio final

cd /var/foro-kontrolya
./launcher restart app

Fase 7: Verificación y Pruebas

Paso 16: Verifica en tu foro

  1. Temas relacionados : Abre cualquier tema antiguo y ve al final - deberías ver una sección “Temas relacionados”
  2. Búsqueda semántica :
  • Ve a la página de búsqueda avanzada
  • Busca algo como “problemas con instalación” (no solo palabras clave exactas)
  • Los resultados con IA se marcan con un icono especial
  1. AI Helper :
  • Crea un nuevo tema o respuesta
  • Selecciona texto y busca el icono de IA en el editor
  • Prueba las opciones: “Proofread”, “Translate”, etc.

Resumen Rápido de Configuración

Función Dónde encontrarlo Qué poner/Valor
API Key OpenAI Platform sk-... (tu clave)
LLM Plugins → Discourse AI → LLM → +New Provider: OpenAI, Model: gpt-4o , URL: https://api.openai.com/v1/chat/completions
Embeddings Plugins → Discourse AI → Embeddings → +New Provider: OpenAI, Model: text-embedding-3-small , URL: https://api.openai.com/v1/embeddings
Activar IA Admin → Settings → “ai embeddings enabled” :white_check_mark: ACTIVADO + seleccionar modelo
Temas relacionados Admin → Settings → “semantic related” :white_check_mark: ACTIVADO
Búsqueda IA Admin → Settings → “semantic search” :white_check_mark: ACTIVADO + seleccionar LLM
AI Helper Admin → Settings → “ai helper enabled” :white_check_mark: ACTIVADO + seleccionar grupos

Costos Aproximados (OpenAI)

OpenAI es de pago por uso. Para un foro pequeño-mediano:

  • Embeddings : ~$0.00013 por 1K tokens (modelo text-embedding-3-small )
  • LLM (gpt-4o-mini) : ~$0.15 por 1M tokens de entrada
  • LLM (gpt-4o) : ~$2.50 por 1M tokens de entrada

Puedes establecer límites en tu cuenta de OpenAI para controlar costos .

Solución de Problemas Comunes

El plugin no aparece después de instalar:

bash

cd /var/foro-kontrolya
./launcher rebuild app

Error de API Key:

  • Verifica que la API key sea correcta
  • Asegúrate de tener saldo en tu cuenta OpenAI

Embeddings no funcionan:

  • Ejecuta rake ai:embeddings:backfill nuevamente
  • Verifica que el modelo esté seleccionado en ai embeddings selected model

AI Helper no aparece en el editor:

  • Verifica que tu usuario pertenezca a los grupos permitidos en ai helper allowed groups

¿Listo! Tu foro ahora tiene capacidades de IA con OpenAI.