Discourse AI - Assistente

[Discourse]

Este guia explica como configurar e usar o recurso Helper do plugin Discourse AI, incluindo suas capacidades e opções de configuração.

Nível de usuário necessário: Administrador

O Helper auxilia os usuários na interação com a comunidade, como criar tópicos, escrever posts e ler conteúdo. Ele foi projetado para aumentar a produtividade do usuário e melhorar a qualidade geral das contribuições.

Resumo

Este guia abrange:

• Uma visão geral dos recursos do AI Helper
• Demonstrações visuais do AI Helper em ação
• Como habilitar e configurar o Helper
• Configurações disponíveis e suas funções
• Detalhes técnicos e perguntas frequentes

Recursos

Dentro do composer

Observação: Nesta demonstração, já havia conteúdo escrito no composer.

O Helper oferece vários recursos ao criar novos tópicos ou respostas:

• Gerar títulos de tópicos, tags e categorias com base no conteúdo
• Revisar texto - incluindo verificações de gramática e ortografia
  • Atalho de teclado do Windows: CTRLALTP
  • Atalho de teclado do MacOS: ⌘⌥ P
• Traduzir texto selecionado para o idioma padrão do fórum
• Criar tabelas Markdown
• Prompts personalizados para várias transformações de texto
• Visualizar e gerenciar alterações sugeridas pela IA
• Legendas com IA para quaisquer imagens enviadas
• Transformar quaisquer datas escritas em datas inteligentes compatíveis com markdown

Ao ler tópicos e posts

Ao navegar no fórum, o Helper pode:

• Traduzir texto selecionado para o idioma da interface do usuário
• Explicar o significado do texto selecionado no contexto do tópico
• Revisar texto - incluindo verificações de gramática e ortografia
• Prompts personalizados para várias transformações de texto
• Helper - Títulos automáticos de threads de chat

Habilitando o Helper

Pré-requisitos

Você deve configurar pelo menos um Modelo de Linguagem Grande (LLM) de um provedor.

Se o seu site for hospedado pelo Discourse

Você pode selecionar nosso LLM Pequeno Hospedado pela CDCK na lista de LLMs.

Para começar, você pode configurá-los através da página de configurações do Discourse AI - Large Language Model (LLM).

• OpenAI
• Anthropic
• Azure OpenAI
• AWS Bedrock com acesso Anthropic
• Endpoints HuggingFace com modelo semelhante a Llama2
• Auto-hospedagem de um LLM OpenSource
• Google Gemini
• Cohere

Configuração

1. Navegue até Admin → Configurações → Discourse AI
2. Certifique-se de que a configuração discourse ai enabled esteja marcada
3. Clique na aba “Recursos” no painel de administração de IA
4. Selecione o filtro de recursos “Não configurado” e encontre a seção para Helper
5. Clique em Editar na seção Helper
6. Habilite o recurso Helper marcando ai helper enabled
7. Configure quaisquer outras configurações relacionadas ao Helper enquanto estiver aqui ^[1]

O recurso Helper é composto por vários subconjuntos, incluindo revisão, sugestões de título, explicação, ilustrador de posts e muito mais. Nas configurações do Helper, você pode usar as personas padrão atribuídas a cada recurso ou configurar personas alternativas.

Para gerenciar personas e os modelos LLM associados a elas, vá para Admin → Configurações → Discourse AI → Personas.

Personalizando recursos do Helper

Você pode habilitar ou desabilitar seletivamente recursos específicos do Helper usando a configuração ai helper enabled features encontrada na página de recursos do Helper. As opções disponíveis incluem:

• suggestions: Controla os botões de sugestão para títulos, categorias e tags
• context_menu: Gerencia o menu para prompts personalizados, tradução e revisão
• image_caption: Ativa legendas de imagem com IA através de legendas automáticas ou do botão “Legendar com IA”

FAQ Técnico

Não consigo ver o botão de IA ao lado do título, tag ou categoria?

• O AI Helper dentro do composer requer um mínimo de 10 palavras no composer para aparecer e funcionar.

Como funciona o recurso “Explicar”?

• O recurso Explicar usa o título do tópico, o conteúdo do post e o texto selecionado como contexto para o LLM gerar a saída.

Quais são alguns usos de prompts personalizados?

• Prompts personalizados podem ser usados para vários propósitos, como mudar o tom ou traduzir para idiomas específicos.

Qual a precisão das traduções do Helper?

• Embora geralmente confiáveis, as traduções podem ser menos precisas para idiomas incomuns.

Ressalvas

• Recomendamos limitar o acesso ao Helper a grupos de usuários específicos para ajudar a controlar os custos associados a provedores de LLM de terceiros.

---

1. Por exemplo:

   • Restrinja o uso do Composer Helper com composer ai helper allowed groups

   • Limite o acesso ao recurso Post Helper com post ai helper allowed groups

   ↩︎

[EricGT]

Desculpe, não posso dar um like neste tópico no momento. Não entenda isso como se eu não gostasse do que a IA está fazendo, acho essa parte ótima.

O vídeo começou a partir de um Draft e a maioria dos usuários começará a partir de New Topic, então foi um pouco confuso para mim quando tentei isso no fórum da OpenAI, onde isso está ativo, pensando que deveria funcionar.

Quando comecei com New Topic, tive que inserir o título, selecionar uma categoria, pulei a adição de tags e adicionei duas linhas na postagem antes que as opções mágicas de IA aparecessem.

Então, depois de adicionar mais texto, os botões de IA apareceram.

---

Acho a postagem bastante útil e você fez um bom trabalho, só precisa de alguma clarificação para usuários não acostumados com essa tecnologia.

[EricGT]

Nota lateral:

Nos primórdios da IA do Discourse, havia a capacidade de a IA gerar um novo título para o tópico com base no texto existente. Eu usava isso com frequência como moderador de categoria quando os títulos ficavam longos, pense em quebras de linha ao visualizar em uma lista. Então, a maneira de fazer isso desapareceu; posso ter perdido como deveria ser feito, mas agora voltou com isso.

Como moderador de categoria, não é possível editar uma postagem e a opção de IA fica ao lado do título para alteração.

Estava procurando por isso no anúncio, pode valer a pena mencionar.

---

A postagem a seguir contém algumas capturas de tela.

Suggestion to add for Chat GPT

[Saif (Saif Murtaza)]

@EricGT

O vídeo começou a partir de um Rascunho e a maioria dos usuários começará a partir de Novo Tópico, então foi um pouco confuso para mim quando tentei isso no fórum da OpenAI, onde isso está ativo, pensando que deveria funcionar.

Quando comecei com Novo Tópico, tive que inserir o título, selecionar uma categoria, pular a adição de tags e adicionar duas linhas na postagem antes que as opções mágicas de IA aparecessem.

Olá @EricGT, então o vídeo que coloquei em uma nota diz que o conteúdo já está lá. Estava tentando tornar o vídeo de demonstração o mais curto e conciso possível.

@EricGT

Então, depois de adicionar mais texto, os botões de IA apareceram.

Eu tenho o seguinte documentado por esse motivo!

@Saif

FAQ Técnica

• Como o AI Helper funciona dentro do Composer? Por que não estou vendo o ícone ?
  • O AI Helper usa conteúdo de texto (mínimo de 10 palavras) dentro do Composer e passa esse contexto para um Modelo de Linguagem Grande (LLM) para gerar títulos/tags/categorias de tópicos, etc.

[JammyDodger]

Pequena atualização sobre isso…

Agora você pode selecionar/desmarcar recursos de ajuda de IA usando a configuração ai_helper_enabled_features:

DEV: Add granular control for AI composer helper features

[bekircem]

 ai_helper_model: Não foi possível obter uma resposta deste modelo. Verifique suas configurações primeiro.

Qual poderia ser o problema? Eu identifiquei a chave da OpenAI.

[Falco]

@bekircem

Qual poderia ser o problema? Eu identifiquei a chave da OpenAI.

Sua chave de API da OpenAI está funcionando? Você consegue emitir uma solicitação para o mesmo modelo do seu PC?

[bekircem]

Parece que está aparecendo como não utilizado no painel da OpenAI. Mas pode ser porque a configuração não foi concluída? Como posso verificar isso na minha máquina local?

[mattdm (Matthew Miller)]

@JammyDodger

Agora você pode selecionar/desmarcar recursos de auxílio de IA usando a configuração ai_helper_enabled_features:

Quais recursos estão disponíveis e o que cada um faz?

[Saif (Saif Murtaza)]

@mattdm

Quais recursos estão disponíveis e o que cada um faz?

O assistente de IA no composer abrange três recursos principais, incluindo sugestões, menu_contextual e legenda_imagem.

A configuração nos permite ter controle granular do assistente de IA, podendo habilitar/desabilitar esses recursos principais.

1. sugestões refere-se aos botões de sugestão que aparecem no composer ao lado do título/categoria/tags. Clicar no botão de sugestão pode sugerir títulos de tópicos, categorias, tags, etc.
2. menu_contextual refere-se ao menu que aparece quando você seleciona uma parte do texto no composer, ou seja, o menu que aparece com o prompt personalizado/traduzir/revisar/etc.
3. legenda_imagem refere-se ao botão “Legendar com IA” que aparece quando você passa o mouse sobre uma imagem carregada na visualização do composer. Isso permite gerar uma legenda com base no conteúdo da imagem.

[mattdm (Matthew Miller)]

Em vez de uma configuração para quais recursos estão habilitados, que tal uma configuração para cada um, para quais grupos cada um está habilitado (se houver)?

[mattdm (Matthew Miller)]

E, na verdade, também… os itens do menu de contexto poderiam ser separados? Idealmente a mesma sugestão — lista de grupos para cada um.

[Saif (Saif Murtaza)]

@mattdm

E, na verdade, também… os itens do menu de contexto poderiam ser separados? Idealmente a mesma sugestão — lista de grupos para cada um.

Acho que, eventualmente, gostaríamos de migrar para um sistema para fornecer controle mais granular de recursos dentro do AI Helper e em outros recursos de IA, algo no radar para o futuro.

[Moin]

@Discourse

Ao escrever, você pode selecionar texto em qualquer lugar e pedir ao AI Helper para revisar, gerar uma tabela markdown ou traduzir para o inglês.

Acho que “traduzir para o inglês” está desatualizado.

@Discourse

Ao ler tópicos/posts

• Apenas para usuários logados
• Traduzir texto selecionado para o inglês

Agora é traduzir para o idioma da interface do usuário

@Discourse

Dentro do Composer

• Apenas para usuários logados, pode ser usado ao criar um novo tópico ou responder
• Gerar títulos/tags/categorias de tópicos, com base no conteúdo do texto dentro do Composer
• Revisar texto selecionado
• Traduzir texto selecionado para o inglês

Agora é traduzir para o idioma padrão do fórum

[jrgong]

Existe alguma forma de adicionar um prompt ou instruções adicionais ao prompt de tradução?

No nosso caso, queremos oferecer traduções EN->DE e adicionar a instrução de usar o pronome informal “você” (Du) em vez do formal (Sie) por padrão.

[EricGT]

@EricGT

Desculpe, não posso dar um like neste tópico no momento. Não entenda isso como se eu não gostasse do que a IA está fazendo, acho essa parte ótima.

Realmente queria usar o tachado no texto, mas não consigo editar a postagem.

A primeira postagem é muito boa e bastante útil, então dei um joinha. Eu realmente aprecio o esforço extra em sua postagem e aguardo ansiosamente para ler mais.