Este guia explica como categorizar tópicos automaticamente usando o recurso de triagem com IA do plugin Discourse AI, combinado com o Discourse Automation.
Nível de usuário necessário: Administrador
Categorizar tópicos automaticamente usando IA
Essa automação usa um LLM para ler o conteúdo do tópico, decide se a categoria selecionada é adequada e a atualiza caso o Agente de IA considere que outra categoria se encaixa melhor no tópico.
Pré-requisitos
- Os plugins Discourse AI e Discourse Automation devem estar habilitados.
- Pelo menos um LLM deve estar configurado. Consulte o guia de configurações do LLM para instruções de configuração.
- Um Agente deve estar configurado com um prompt de sistema adequado.
Configurações de referência do Agente
- Prompt de sistema:
Você é um classificador especialista de conteúdo para este fórum.
Sua tarefa é analisar as postagens e sugerir a categoria apropriada com base no conteúdo, nas imagens e na lista de categorias disponíveis.
Diretrizes:
- Seja conservador — categorize apenas o que tiver certeza
- Considere tanto o tópico do conteúdo quanto a intenção da postagem
- Modelo de linguagem padrão: Selecione o LLM configurado na seção de Pré-requisitos.
Clientes hospedados no Discourse podem selecionar o CDCK Hosted Small LLM ao configurar Agentes de IA. - Ferramentas habilitadas: Ler, Categorias, Editar Categorias
- Ferramentas forçadas: Ler, Categorias
- Estratégia de ferramentas forçadas: Aplicar apenas à primeira resposta
- Modo de execução: Padrão (Limites Fixos)
- (Opcional) Ative a opção Exigir aprovação para ferramentas de moderação
- Usuário: Criar usuário
Configurações de automação
- Navegue até Admin → Plugins → Automações.
- Clique em + Adicionar Automação.
- Selecione o script Triar postagens usando Agente de IA.
- Configure as definições da seção Quando/O que conforme desejar.
- Selecione o Agente definido para esta automação na configuração
AI Agentda seção Opções do Script. - Ative a configuração
Modo Silencioso. - Clique no botão Atualizar automação.
- Ative a automação.
Melhores práticas
- Comece com um escopo restrito: Aplique a automação apenas a uma categoria específica ou às primeiras postagens de novos usuários (nível de confiança 0 ou 1) antes de expandi-la. Isso limita os custos do LLM e reduz o risco de categorizações incorretas generalizadas.
- Escreva descrições claras de categoria no seu prompt: Quanto mais precisas forem suas descrições do significado de cada categoria, mais confiavelmente o LLM classificará corretamente.
- Monitore falsos positivos e negativos: O LLM não será 100% preciso. Crie um fluxo de trabalho para revisar e corrigir tópicos categorizados incorretamente e ajuste seu prompt ao longo do tempo.
- Mantenha limites de tokens sensatos: A configuração “Max Post Tokens” limita quanto de uma postagem é enviada ao LLM. Para a maioria das tarefas de categorização automática, os primeiros centenas de tokens (o início da postagem) são suficientes.
Problemas comuns e soluções
- A categoria apropriada não está sendo aplicada pela automação
Revise as configurações de segurança da categoria. Se a categoria que deve ser aplicada for privada, certifique-se de que a opção de ferramentaLer privadasnas configurações do Agente esteja habilitada. - A automação é executada, mas não categoriza tópicos
Revise os logs do site para identificar quaisquer erros associados aos plugins Discourse AI ou Discourse Automation.