Personalizando o Discobot para o seu site

:bookmark: Este guia explica como personalizar o Discobot, o assistente robô integrado ao Discourse, para melhor se adequar à persona e às necessidades da sua comunidade.

:person_raising_hand: Nível de usuário exigido: Administrador

O Discobot é um usuário especial na sua comunidade Discourse que ajuda novos membros a aprenderem sobre a plataforma. Como administrador, você pode personalizar vários aspectos do Discobot para melhor se adequar ao estilo e aos requisitos da sua comunidade.

Configurando as configurações do site do Discobot

O comportamento do Discobot é controlado por várias configurações do site encontradas na categoria de configurações Plugins (procure por “narrative bot” em Admin > Configurações). As configurações principais incluem:

  • discourse_narrative_bot_enabled: Ativa ou desativa o plugin Discobot completamente. Padrão: true.
  • disable_discourse_narrative_bot_welcome_post: Quando ativado, impede que o Discobot envie uma postagem de boas-vindas para novos usuários. Padrão: true (a postagem de boas-vindas é desativada em novas instalações).
  • discourse_narrative_bot_welcome_post_type: Controla o tipo de postagem de boas-vindas. As opções são “New user track” (inicia o tutorial interativo) ou “Welcome message” (envia uma mensagem de boas-vindas simples). Padrão: new_user_track.
  • discourse_narrative_bot_welcome_post_delay: Número de segundos a serem aguardados antes de enviar a postagem de boas-vindas. Padrão: 0.
  • discourse_narrative_bot_ignored_usernames: Uma lista de nomes de usuário com os quais o Discobot não deve interagir. Padrão: discourse.
  • discourse_narrative_bot_disable_public_replies: Quando ativado, impede que o Discobot responda em tópicos públicos. Padrão: false.

:warning: Em novas instalações, disable_discourse_narrative_bot_welcome_post é definido como true por padrão, o que significa que o Discobot não enviará mensagens automaticamente para novos usuários. Para ativar a postagem de boas-vindas do Discobot, defina esta opção como false.

Modificando o perfil do usuário do Discobot

Para personalizar o perfil do Discobot:

  1. Vá para Admin > Usuários e selecione o usuário Discobot.
  2. Selecione “Preferências” ou clique em “Visitar a página de preferências deste usuário para editar o perfil dele”:

Uma vez na seção Preferências, você pode modificar as seguintes configurações:

Configurações da conta

  • Nome: Clique no botão “Editar” para mudar o nome do Discobot.
  • Imagem: Clique no botão “Editar” para carregar uma nova imagem de avatar.
  • Após fazer as alterações, clique no botão “Salvar Alterações”.

:bulb: Se você mudar o nome do Discobot, lembre-se de também atualizar a sua biografia “Sobre mim” na seção Perfil. A biografia padrão faz referência ao Discobot pela descrição em vez do nome de usuário, mas você pode querer revisá-la para garantir que ainda faça sentido com o novo nome.

Configurações de perfil

Personalize as informações de perfil do Discobot conforme a necessidade.

Configurações de e-mail

Ajuste as configurações relacionadas a e-mail conforme a necessidade.

Atualizando a mensagem de boas-vindas do Discobot

Todo o texto do Discobot — incluindo a mensagem de boas-vindas, as etapas do tutorial e outras respostas — pode ser personalizado via Aparência > Textos do Site no painel de administração (/admin/customize/site_texts).

Para encontrar e editar uma mensagem específica:

  1. Vá para o perfil do Discobot (https://example.discourse.com/u/discobot/summary) e selecione “Mensagens”.

  2. Clique em “Enviadas”.

  3. Encontre uma mensagem de saudação que você deseja modificar.

  4. Copie uma parte exclusiva da mensagem, como “Eu sou apenas um robô”.

  5. Navegue até a Interface de Administração (https://example.discourse.com/admin)

  6. Vá para Aparência > Textos do Site (https://example.discourse.com/admin/customize/site_texts)

  7. Cole o texto copiado na janela de pesquisa. Quando a mensagem de saudação aparecer, clique em “Editar”.

  8. Atualize a mensagem de saudação e clique em “Salvar Alterações”.

:bulb: Você também pode pesquisar por discourse_narrative_bot em Textos do Site para navegar por todas as strings de texto personalizáveis do Discobot diretamente.

Limitações e informações adicionais

  • Você pode reutilizar variáveis existentes nas mensagens (como %{username} ou %{discobot_username}), mas não pode adicionar novas.
  • O Discobot deve permanecer como administrador; essa função não pode ser removida.
  • Você pode personalizar o conteúdo do corpo das etapas do tutorial, mas não pode adicionar, remover ou reordenar as etapas.

Para necessidades de personalização adicionais ou solicitações de recursos, considere postar na categoria #feature.

38 curtidas

Is it possible to make a new conversation discobot with With members and make a new certificate for them ?

I am admin to an educational forum and I want to make a new conversation with a new certificate :slight_smile:

3 curtidas

No, you cannot currently customise the full experience.

3 curtidas

Is it possible to know the codes for messages such as %{title}

Excuse me for my many questions :slight_smile:

1 curtida

Questions are fine. :slight_smile:

You can reuse any existing variables in the message but you cannot add new ones.

5 curtidas

many thanks @HAWK
Is it possible to define the existing variables if possible? :slight_smile:

1 curtida

I suggest adding that either

  1. People need to update the Discobot’s profile About me because it’ll still say message or mention @discobot even after you change its name

or

  1. Maybe Discourse could remove the username from the default message? I went ahead and edited our About me to just say

Hi, I’m not a real person. I’m a bot that can teach you about this site. To interact with me, send me a message or mention me anywhere.

Just in case we have to change it again, we don’t need to remember to also change the About me.

4 curtidas

Is this something that’s going to be possible in the future? The current question/answer format of fortune and quote is sufficient for what I have in mind.

1 curtida

@codinghorror is extending the discobot functionality on our roadmap at all?

2 curtidas

That’s a good point we should make that copyedit, @tshenry can you take it? No need to deal with it retroactively just for new ones. Say “mention me by name” so editing the name doesn’t require editing the “about me”.

@hawk we don’t plan on extending discobot at the moment.

7 curtidas

Should be done with the following!

8 curtidas

Does Discobot have to be a Moderator or can I take this role away from him? I mean, will he still work then?

2 curtidas

As far as I can tell from looking at the code and the UI, Discobot should never be able to become a moderator.

If you meant an admin, then no, unfortunately there is no way to take the admin role away from DIscobot at this time.

7 curtidas

Obrigado por responder. Desde as últimas postagens, é possível personalizar o treinamento de usuários do discobot e o treinamento de usuários avançados ou isso ainda é padrão? Recebemos muito tráfego de pesquisa com a palavra “capivara”, mas talvez gostaríamos de tentar outro termo?

1 curtida

Na verdade, acredito que o que estou mencionando pode estar aqui: Customizing Discobot for your site - #7

2 curtidas

Existe alguma maneira de um administrador ativar ou desativar uma parte específica do tutorial?

Por exemplo, o tutorial de Bandeira (Flag) exige que o usuário selecione a Bandeira “Inapropriada”. Essa Bandeira está oculta em nossa instância porque não se adequa ao nosso caso de uso. Consequentemente, nossos usuários não conseguem completar o Tutorial. Se eu pudesse apenas desabilitar/pular esta seção, poderíamos reativar o tutorial.

2 curtidas

Você poderia alterar as instruções da etapa, de forma semelhante a como curtir uma postagem pode ser ignorado quando as curtidas são desativadas. Desativar curtidas - atualizar tutorial do discobot

3 curtidas

Você não pode remover ou adicionar etapas, mas pode personalizar o conteúdo do corpo das etapas existentes (mas não os gatilhos).

4 curtidas

Adoraria fornecer isso e treiná-lo para responder a perguntas relacionadas ao assunto principal do fórum usando LM / chatgpt etc… é possível?

Provavelmente, o melhor é criar sua própria persona/bot de IA em vez de tentar personalizar o discobot.

1 curtida