Este guia explica como habilitar e configurar o recurso de bot de IA do plugin Discourse AI.
Nível de usuário necessário: Administrador
O chatbot inteligente pode responder a todas as perguntas sobre sua comunidade Discourse e muito mais. O Bot de IA tem o poder de pesquisar em sua instância Discourse atual e além com suporte a agentes para responder a qualquer tipo de pergunta que você possa ter.
Funcionalidades
- Capacidade de escolher o agente de Bot de IA específico com o qual você deseja interagir
- Flexibilidade para selecionar o provedor de Modelo de Linguagem Grande (LLM)
- Várias pessoas podem interagir com o Bot de IA ao mesmo tempo dentro da mesma mensagem
- Títulos gerados por IA para mensagens privadas (MP) com o Bot de IA
- Respostas geradas continuamente através de streaming e podem ser interrompidas
- Habilite o bot para um subconjunto específico de usuários ou grupos
- Acesso rápido ao bot de IA através do ícone

- Visualizar interações para fins de depuração
- Copiar e compartilhar conversas do bot de IA
Agentes
Um bot de IA que tenta fazer tudo acabará falhando devido ao esquecimento de contexto e limitações do LLM. É por isso que implementamos agentes para ajudá-lo a ter uma experiência melhor, fornecendo as melhores respostas possíveis.
Guia completo para agentes de IA disponível aqui. Você pode criar agentes de IA personalizados para o bot que são adaptados às suas necessidades.
Dependendo da ajuda de que você precisa, existem vários agentes padrão pré-definidos para escolher:
- Auxiliar do Fórum: Bot de IA de propósito geral capaz de realizar várias tarefas. Pode pesquisar em sua instância Discourse atual e usar essas informações para construir respostas
- Ex: Quais são as principais publicações sobre IA?
- Auxiliar de SQL: Bot de IA especializado em ajudar a elaborar consultas SQL nesta instância Discourse (ciente do seu esquema de banco de dados atual)
- Ex: Escreva uma consulta para encontrar todas as mensagens do bot de IA de um cliente/usuário específico
- Artista: Bot de IA especializado em gerar imagens. Requer uma ferramenta de geração de imagens configurada
- Ex: Desenhe uma imagem de um gato para mim
- Designer: Bot de IA especializado em gerar e editar imagens
- Explorador de Configurações: Bot de IA especializado em ajudar a explorar as configurações do site Discourse. (ciente do código-fonte do Discourse)
- Ex: Como eu habilito o Discourse AI no meu site Discourse?
- Pesquisador da Web: Bot de IA com acesso ao Google e a capacidade de navegar em páginas da web para pesquisar informações para você. Precisa de uma chave de API do Google Custom Search.
- Ex: Quantas pernas tem um dinossauro?
- Criativo: Bot de IA sem quaisquer integrações externas
- Ex: Crie 5 ideias para melhorar o engajamento da comunidade
- Auxiliar do GitHub: Bot de IA especializado em pesquisar repositórios do GitHub
- Ex: O que o LINK_TO_PR faz?
- Auxiliar do Discourse: Bot de IA especializado em ajudar com tarefas relacionadas ao Discourse, pesquisa em meta.discourse.org
- Pesquisador do Fórum: Bot de IA especializado em pesquisa aprofundada para o fórum
- Criador de Artefatos Web: Bot de IA especializado em criar artefatos web interativos
Habilitando o Bot de IA
Pré-requisitos
Você deve configurar pelo menos um Modelo de Linguagem Grande (LLM) de um provedor.
Para começar, você pode configurá-los através da página de configurações do Large Language Model (LLM) do Discourse AI.
- OpenAI
- Anthropic
- Azure OpenAI
- AWS Bedrock com acesso Anthropic
- Endpoints HuggingFace com modelo semelhante ao Llama2
- Auto-hospedagem de um LLM de Código Aberto
- Google Gemini
- Cohere
Opcionalmente, configure o seguinte para obter recursos extras:
- Ferramenta de geração de imagens → Gerar imagens (usada pelos agentes Artista e Designer)
- Google Custom Search → Pesquisar na internet por respostas através do Google
Configuração
- Vá para as configurações
Admin→Plugins→AI→ guiaSettings(Configurações) e certifique-se de que esteja habilitado (discourse ai enabled) - Marque
ai bot enabledpara habilitar o Bot de IA - Marque
ai bot add to headerpara habilitar acesso rápido através do ícone
no canto superior direito - Recomendamos selecionar o grupo de usuários através de
ai bot allowed groupspara permitir acesso específico ao Bot de IA. - Use a configuração
ai bot enabled llmspara selecionar quais LLMs devem estar disponíveis para conversas do Bot de IA.
Monitorando discussões
Em alguns casos, você pode querer monitorar as discussões do bot para melhorar o desempenho de seus bots.
Se você planeja fazer isso, recomendamos habilitar o ai_bot_enable_chat_warning, que mostrará um aviso aos usuários explicando que as conversas estão sendo monitoradas.
Em seguida, como administrador, adicione um link à sua barra lateral:
https://discourse.example.com/u/NOME_DO_BOT/messages
NOME_DO_BOT é o nome de usuário do bot que você deseja monitorar.
FAQ Técnico
Por que estou vendo usuários bot sendo adicionados ao meu site?
- Esses usuários são necessários para o Bot de IA funcionar. Eles não fazem nada em segundo plano e são usados apenas ao interagir com o bot.
Onde eu edito os agentes?
- Acesse
discourse.example.com/admin/plugins/discourse-ai/ai-agents, onde você pode controlar quais agentes estão habilitados e quem tem acesso a cada um.
O Bot de IA é treinado com os dados da minha comunidade?
- O Bot de IA não é treinado com nenhum dado. Ele usa a técnica de geração aumentada por recuperação (RAG) para obter resultados.
Ressalvas
- O bot de IA é uma área de muita experimentação e está mudando rapidamente
- O bot de IA nem sempre fornece resultados 100% precisos, portanto, certifique-se de verificar cuidadosamente qualquer resultado
- Recomendamos habilitar o bot para grupos de usuários específicos para ajudar a controlar os custos, pois os provedores terceirizados cobram por uso