Esta guía explica cómo configurar y gestionar Agentes para Discourse AI - Bot de IA.
Nivel de usuario requerido: Administrador
El bot de IA de Discourse incluye un sistema flexible para gestionar Agentes. Esta guía cubre:
- Métodos de interacción para Agentes de IA
- Opciones de configuración
- Configuración avanzada
- Comandos compatibles
- Posibilidades de personalización
Obtenga información sobre el bot de IA y cómo habilitarlo en esta guía.
¿Qué son los agentes?
Los Agentes son una potente característica que le permite personalizar el comportamiento del motor de IA en su foro de Discourse. Actúan como un ‘mensaje del sistema’ que guía las respuestas e interacciones de la IA, ayudando a crear una experiencia de usuario más personalizada y atractiva.
¿Por qué usar agentes?
Con los agentes, puede adaptar el comportamiento de la IA para que se ajuste mejor al contexto y tono de su foro. Ya sea que desee que la IA sea más formal para un entorno profesional, más informal para un foro comunitario, o incluso que encarne un personaje específico para un juego de rol, los agentes le brindan la flexibilidad para hacerlo.
Acceso específico por grupo a los agentes
Además, puede configurarlo para que ciertos grupos de usuarios tengan acceso a agentes específicos. Esto significa que puede tener diferentes comportamientos de IA para diferentes secciones de su foro, mejorando aún más la diversidad y riqueza de las interacciones de su comunidad.
Interactuando con Agentes
Se puede interactuar con los agentes de varias maneras:
- Mensaje privado (MP)
- Mensaje directo de chat (MD)
- Menciones en canales de chat
- Mención en un tema público a través de
@nombre_usuario_bot_ejemplo
Los administradores pueden controlar qué métodos de interacción están permitidos para cada agente.
Configuración
Para configurar Agentes, navegue a discourse.example.com/admin/plugins/discourse-ai/ai-agents.
Las opciones clave de configuración incluyen:
- System prompt (Indicación del sistema): Dirige la conversación
- Vision support (Soporte de Visión): Habilitar para LLMs impulsados por Visión, es decir, GPT-4 Turbo, Claude 3
- Default model (Modelo predeterminado): Requerido para agentes que se pueden mencionar
- Allowed groups (Grupos permitidos): Definir permisos usando la seguridad de grupos de Discourse
- Uploads (Subidas): Indexar archivos de texto para conocimiento adicional (usando RAG - Generación Aumentada por Recuperación)
- Enabled commands (Comandos habilitados): Controlar el acceso a comandos específicos
- Allow chat (Permitir chat): Habilitar chat a través de MD (requiere el plugin de chat, un modelo de lenguaje grande (LLM) predeterminado y un usuario)
Aquí hay un vistazo a una pantalla de configuración completa de agente de IA:
Opciones de configuración avanzada
El editor de agentes ofrece varias opciones avanzadas:
- Temperature (Temperatura) y top_p (muestreo de núcleo): Controlar la creatividad frente a la previsibilidad
- Max context posts (Publicaciones máximas de contexto): Limitar el número de publicaciones suministradas al LLM para el historial; menos publicaciones reducirán los costos, pero harán que la IA “olvide” el contenido más antiguo
- Upload options (Opciones de subida):
- Chunk tokens (Tokens de fragmento): Controlar la división de documentos
- Chunk overlap tokens (Tokens de superposición de fragmentos): Establecer superposición entre fragmentos
- Search conversation chunks (Fragmentos de conversación de búsqueda): Número de fragmentos de documentos agregados a las consultas de usuario
- Question consolidator LLM (LLM consolidado de preguntas): Elegir el LLM para determinar las preguntas del usuario
Prerrequisitos para el soporte de subidas
Para usar el soporte de subidas:
- Habilitar la configuración
ai_embeddings_enabled - Configurar un
ai_embeddings_model
Discourse AI admite varios modelos de incrustación (embeddings). Los clientes alojados obtienen acceso gratuito al modelo bge-large-en.
Los autoalojados o las personas que deseen más opciones pueden autoalojar un modelo de incrustación o utilizar modelos de Open AI, Google (Gemini) y más.
División de texto en Discourse AI
Discourse utiliza un Divisor de Texto de Carácter Recursivo para mantener juntos párrafos, líneas y palabras al dividir texto. Puede controlar la división de texto usando el separador [[metadata SU METADATO AQUÍ]]:
[[metadata sobre gatos]]
una larga historia sobre gatos
[[metadata sobre perros]]
una larga historia sobre perros
Este método evita la “contaminación de fragmentos” al asegurar que solo los datos relevantes se incluyan en cada fragmento.
Depuración de agentes de IA
Para depurar su agente:
- Añadir usuarios al grupo especificado en la configuración
ai bot debugging enabled groups - Los usuarios de este grupo verán un botón de depuración de IA en la parte inferior de las publicaciones de IA
- Haga clic en el botón para acceder a la ventana modal de la interfaz de depuración
Recuerde: Si proporciona información vaga o inútil a un LLM, tendrá grandes dificultades para convertirla en información útil.
Comandos compatibles
Discourse AI admite varios comandos, que incluyen:
- Categorías
- Etiquetas
- Búsqueda
- Navegador web
- Integración de GitHub (Buscar código, Diferencia de solicitud de extracción, Contenido de archivo)
- Requiere que se rellene la configuración
ai bot github access token
- Requiere que se rellene la configuración
- Buscar en Meta Discourse
- Selector aleatorio (Random Picker)
- Leer
- Hora
- Búsqueda de Google
- Requiere que se rellenen las configuraciones
ai google custom search api keyyai google custom search cx
- Requiere que se rellenen las configuraciones
- Generación de imágenes a través de DALL-E
- Requiere una clave de open_ai
- Generación de imágenes a través de Stable Diffusion
- Requiere que se rellene la configuración
ai stability api key - La configuración
ai stability enginecontrola el algoritmo de generación de imágenes
- Requiere que se rellene la configuración
- Esquema (Schema)
- Configuración de búsqueda (Search Settings)
- Establecer contexto (Setting Context)
Algunos comandos requieren configuración adicional o claves de API.
Soporte para herramientas personalizadas
Puede crear sus propias herramientas utilizando soporte para herramientas personalizadas.
Personalización de agentes del sistema
- Crear un nuevo agente
- Copiar y pegar la indicación del sistema del agente que desea personalizar
- Modificar según sea necesario
- Opcionalmente, deshabilitar el agente del sistema original para evitar duplicación
Personalización de la búsqueda
Para personalizar la búsqueda para un nuevo agente:
- Crear un nuevo agente
- Añadir el comando “search” (búsqueda)
- Configurar las opciones de búsqueda, incluyendo:
- Consulta de búsqueda base
- Número máximo de resultados de búsqueda
- Opción de incluir temas privados
Esto le permite delegar permisos de búsqueda, aumentar el número de resultados o restringir la búsqueda a secciones específicas de su sitio.
