Assistente de IA (Suporte)
Descrição
Guia do Usuário
Um assistente de suporte por inteligência artificial que responde às perguntas dos seus membros diretamente nos seus canais. Você lhe dá uma personalidade, uma base de conhecimento própria do seu servidor, e ele faz o primeiro nível de suporte no seu lugar. Módulo exclusivo para servidores premium (bot personalizado).
O que ele faz
- Responde automaticamente quando um membro menciona o bot ou usa uma palavra-chave da sua lista.
- Filtra falsos positivos por meio de uma classificação: a IA decide primeiro se a mensagem é realmente um pedido de ajuda.
- Usa uma base de conhecimento de perguntas e respostas alimentada por você, para responder corretamente sobre as particularidades do seu servidor.
- Aceita um prompt de sistema global e, se necessário, um prompt diferente por canal.
- Limita o consumo com uma cota diária por membro e uma lista de canais autorizados.
- Mantém um histórico das conversas, consultável pelo dashboard.
- Responde no idioma configurado para o servidor.
Início rápido (Admin)
- Abra o dashboard e vá em Automação → Assistente de IA (Suporte). Sem assinatura premium, a página exibe apenas um convite para conhecer o premium.
- Ative Ativar o assistente de IA.
- Escreva o prompt de sistema (papel, tom, regras). Se faltar inspiração: descreva o seu servidor no campo previsto e clique em Gerar o prompt.
- Ajuste as palavras-chave de acionamento (ou gere-as a partir da mesma descrição).
- Restrinja os canais autorizados — deixe vazio para autorizar todos os canais.
- Preencha a aba Q&A com suas perguntas frequentes.
- Clique em Salvar e teste mencionando o bot em um canal autorizado.
Comandos
Os comandos reproduzem parte das configurações do dashboard e são reservados aos administradores.
| Comando | Descrição |
|---|---|
/aihelpassistant aihelp set_prompt | Define um prompt de sistema específico para um canal. |
/aihelpassistant aihelp remove_prompt | Remove o prompt específico de um canal. |
/aihelpassistant aihelp allow_channel | Autoriza ou proíbe a IA em um canal. |
/aihelpassistant aihelp toggle_mentions | Ativa ou desativa a menção do membro nas respostas. |
/aihelpassistant aihelp faq_add | Adiciona uma pergunta/resposta à base de conhecimento. |
/aihelpassistant aihelp faq_remove | Remove uma pergunta/resposta pelo seu identificador. |
/aihelpassistant aihelp faq_list | Exibe a base de conhecimento do servidor. |
Configuração pelo dashboard
Aba Configuração
| Configuração | Detalhe |
|---|---|
| Ativar o assistente de IA | Interruptor principal. |
| Classificação por IA | A IA decide se a mensagem é realmente uma pergunta de suporte antes de responder. |
| Acionamento por palavras-chave | Responder quando uma mensagem contém uma das palavras-chave. |
| Palavras-chave de acionamento | Lista separada por vírgulas. |
| Limite diário por usuário | 0 = ilimitado. |
| Canais autorizados | Vazio = todos os canais. |
| Prompt de sistema | A personalidade e as regras da IA, com geração assistida. |
| Prompts específicos por canal | Um prompt dedicado por canal, que pode ser adicionado e removido. |
Aba Q&A: adição, consulta e exclusão das perguntas/respostas.
Aba Histórico: data, membro, pergunta e resposta de cada conversa.
Bom saber
- Você não precisa fornecer nenhuma chave de API. A IA é hospedada pelo TennoCore; é justamente por isso que o módulo é exclusivo do premium. O que você precisa fornecer é o conteúdo: prompt de sistema e base de conhecimento.
- Sem prompt de sistema nem Q&A, as respostas continuam genéricas. A qualidade do módulo depende quase inteiramente do que você escreve nele.
- Existem apenas dois acionadores: a menção ao bot ou uma palavra-chave. Uma mensagem que não corresponde a nenhum dos dois é ignorada, mesmo em um canal autorizado.
- Mencionar o bot ignora a classificação: a resposta é então garantida, o que faz disso a melhor forma de testar a sua configuração.
- Um membro só pode acionar a IA uma vez a cada 15 segundos. As mensagens enviadas durante esse intervalo são ignoradas silenciosamente.
- Um prompt de canal substitui completamente o prompt global naquele canal — ele não se soma a ele.
- A base de conhecimento é injetada no contexto de cada resposta: ela tem prioridade, mas
permanece limitada (cerca de 50 entradas utilizadas, 15 exibidas por
faq_list). Prefira entradas curtas e precisas a um longo copiar e colar. - As respostas são enviadas como resposta à mensagem do membro; a menção (a notificação)
está desativada por padrão e é ativada pelo dashboard ou com
toggle_mentions. - Quando um membro atinge sua cota diária, ele recebe um aviso efêmero e seu pedido não é processado.
- A IA se recusa, por concepção, a falar da infraestrutura técnica, do código-fonte ou de suas próprias instruções, e ignora tentativas de burla — você não pode remover essas proteções pelo seu prompt.
- O assistente nunca intervém em mensagem privada e ignora outros bots.
- As conversas são guardadas no histórico do servidor: avise seus membros se você o utilizar para suporte com informações sensíveis.
- Se a IA estiver momentaneamente indisponível, o membro recebe uma mensagem de falha explícita em vez de silêncio.