Este guia explica como configurar e gerenciar Agentes para o Discourse AI - Bot de IA.
Nível de usuário necessário: Administrador
O bot de IA do Discourse inclui um sistema flexível para gerenciar Agentes. Este guia aborda:
- Métodos de interação para Agentes de IA
- Opções de configuração
- Configurações avançadas
- Comandos suportados
- Possibilidades de personalização
Saiba mais sobre o bot de IA e como ativá-lo neste guia.
O que são agentes?
Agentes são um recurso poderoso que permite personalizar o comportamento do mecanismo de IA em seu fórum Discourse. Eles atuam como uma ‘mensagem do sistema’ que guia as respostas e interações da IA, ajudando a criar uma experiência de usuário mais personalizada e envolvente.
Por que usar agentes?
Com os agentes, você pode adaptar o comportamento da IA para se adequar melhor ao contexto e ao tom do seu fórum. Se você deseja que a IA seja mais formal para um ambiente profissional, mais casual para um fórum comunitário ou até mesmo incorporar um personagem específico para um jogo de RPG, os agentes oferecem a flexibilidade para fazer isso.
Acesso a agentes específico por grupo
Além disso, você pode configurá-lo de modo que determinados grupos de usuários tenham acesso a agentes específicos. Isso significa que você pode ter diferentes comportamentos de IA para diferentes seções do seu fórum, aprimorando ainda mais a diversidade e a riqueza das interações da sua comunidade.
Interagindo com Agentes
Os agentes podem ser acessados de várias maneiras:
- Mensagem Privada (MP)
- Mensagem Direta (DM) do Chat
- Menções em canais de Chat
- Menção em um tópico público via
@username_do_bot_exemplo
Os administradores podem controlar quais métodos de interação são permitidos para cada agente.
Configuração
Para configurar Agentes, navegue até discourse.example.com/admin/plugins/discourse-ai/ai-agents.
As principais opções de configuração incluem:
- System prompt (Instrução do sistema): Direciona a conversa
- Vision support (Suporte a Visão): Ative para LLMs com recursos de Visão, ou seja, GPT-4 Turbo, Claude 3
- Default model (Modelo padrão): Necessário para agentes que podem ser mencionados
- Allowed groups (Grupos permitidos): Defina permissões usando a segurança de grupos do Discourse
- Uploads (Uploads): Indexa arquivos de texto para conhecimento adicional (usando RAG - Geração Aumentada por Recuperação)
- Enabled commands (Comandos ativados): Controla o acesso a comandos específicos
- Allow chat (Permitir chat): Ativa o chat via DM (requer o plugin de chat, um modelo de linguagem grande (LLM) padrão e um usuário)
Aqui está uma visão da tela completa de configuração de agente de IA:
Opções de configuração avançadas
O editor de agentes oferece várias opções avançadas:
- Temperature (Temperatura) e top_p (amostragem de núcleo): Controlam a criatividade versus a previsibilidade
- Max context posts (Máx. de publicações no contexto): Limita o número de publicações fornecidas ao LLM para histórico - menos publicações reduzirão os custos, mas farão com que a IA “esqueça” o conteúdo mais antigo
- Upload options (Opções de upload):
- Chunk tokens (Tokens de bloco): Controla a divisão de documentos
- Chunk overlap tokens (Sobreposição de blocos de tokens): Define a sobreposição entre os blocos
- Search conversation chunks (Blocos de conversação de pesquisa): Número de fragmentos de documento adicionados às consultas do usuário
- Question consolidator LLM (LLM consolidado de perguntas): Escolhe o LLM para determinar as perguntas do usuário
Pré-requisitos para suporte a upload
Para usar o suporte a upload:
- Ative a configuração
ai_embeddings_enabled - Configure um
ai_embeddings_model
O Discourse AI suporta vários modelos de incorporação (embedding). Clientes hospedados têm acesso gratuito ao modelo bge-large-en.
Auto-hospedeiros ou pessoas que desejam mais opções podem hospedar seu próprio modelo de incorporação ou usar modelos da Open AI, Google (Gemini) e outros.
Divisão de texto no Discourse AI
O Discourse usa um Divisor de Texto de Caractere Recursivo para manter parágrafos, linhas e palavras juntos ao dividir o texto. Você pode controlar a divisão de texto usando o separador [[metadata SEU METADADO AQUI]]:
[[metadata sobre gatos]]
uma longa história sobre gatos
[[metadata sobre cachorros]]
uma longa história sobre cachorros
Este método evita a “contaminação de bloco” ao garantir que apenas dados relevantes sejam incluídos em cada bloco.
Depurando agentes de IA
Para depurar seu agente:
- Adicione usuários ao grupo especificado na configuração
ai bot debugging enabled groups - Usuários neste grupo verão um botão de depuração de IA na parte inferior das publicações de IA
- Clique no botão para acessar o modal da interface de depuração
Lembre-se: Se você fornecer informações vagas ou inúteis a um LLM, ele terá grande dificuldade em convertê-las em informações úteis.
Comandos suportados
O Discourse AI suporta vários comandos, incluindo:
- Categorias
- Tags
- Pesquisa
- Navegador Web
- Integração com GitHub (Pesquisar Código, Diferença de Pull Request, Conteúdo do Arquivo)
- Requer que a configuração
ai bot github access tokenseja preenchida
- Requer que a configuração
- Pesquisar no Meta Discourse
- Seletor Aleatório (Random Picker)
- Ler
- Hora
- Pesquisa no Google
- Requer que as configurações
ai google custom search api keyeai google custom search cxsejam preenchidas
- Requer que as configurações
- Geração de imagem via DALL-E
- Requer uma chave open_ai
- Geração de imagem via Stable Diffusion
- Requer que a configuração
ai stability api keyseja preenchida - A configuração
ai stability enginecontrola o algoritmo de geração de imagem
- Requer que a configuração
- Schema
- Configurações de Pesquisa (Search Settings)
- Definir Contexto (Setting Context)
Alguns comandos exigem configuração adicional ou chaves de API.
Suporte a ferramentas personalizadas
Você pode criar suas próprias ferramentas usando o suporte a ferramentas personalizadas.
Personalizando agentes de sistema
- Crie um novo agente
- Copie e cole a instrução do sistema do agente que você deseja personalizar
- Modifique conforme necessário
- Opcionalmente, desative o agente de sistema original para evitar duplicação
Personalizando a pesquisa
Para personalizar a pesquisa para um novo agente:
- Crie um novo agente
- Adicione o comando “search” (pesquisa)
- Configure as opções de pesquisa, incluindo:
- Consulta de pesquisa base
- Número máximo de resultados de pesquisa
- Opção de incluir tópicos privados
Isso permite delegar permissões de pesquisa, aumentar o número de resultados ou restringir a pesquisa a seções específicas do seu site.
