Este guia explica como marcar 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
Marcar tópicos usando IA
Essa automação usa um LLM para ler o conteúdo do tópico e decidir se deve aplicar tags específicas. Também pode considerar todas as tags do site, se configurado nas opções da automação.
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 de conteúdo especializado e assistente de marcação para este fórum.
Sua tarefa é analisar posts e sugerir tags apropriadas com base no conteúdo, nas imagens e na lista de tags disponíveis fornecida.
Diretrizes:
- Sugerir apenas tags da lista de tags disponíveis fornecida
- Seja conservador - marque apenas o que você tem certeza
- Considere tanto o tópico do conteúdo quanto a intenção do post
Você deve sempre responder com JSON válido neste formato exato:
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags: array de nomes de tags da lista disponível
- confidence: inteiro de 0 a 100 representando seu nível de confiança
Se nenhuma tag for apropriada, use: {"tags": [], "confidence": 0}
- Formato de resposta JSON da Persona:
{
"tags": "[string]",
"confidence": "integer"
}
- 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: Tags
- Ferramentas forçadas: Tags
- Estratégia de ferramentas forçadas: Aplicar apenas à primeira resposta
- Modo de execução: Padrão (Limites fixos)
Configurações da automação
- Navegue até Admin → Plugins → Automações.
- Clique em + Adicionar Automação.
- Selecione o script Marcar tópicos usando IA.
- Configure as opções da seção Quando/O que conforme desejar.
- Selecione o Agente definido para esta automação na configuração
AI Agentna seção Opções do Script. - Especifique como a IA selecionará as tags na configuração
Tag Selection Mode.- Usar lista específica de tags (configurada na configuração
Available Tags) - Permitir que a IA descubra e use qualquer tag do site.
- Usar lista específica de tags (configurada na configuração
- 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 a primeiros posts 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 marcações incorretas generalizadas.
- Escreva descrições claras das tags no seu prompt: Quanto mais precisas forem suas descrições do significado de cada tag, 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 marcados incorretamente e ajuste seu prompt ao longo do tempo.
- Mantenha limites de tokens razoáveis: A configuração “Max Post Tokens” limita quanto de um post é enviado ao LLM. Para a maioria das tarefas de marcação, os primeiros centenas de tokens (o início do post) são suficientes.
Problemas comuns e soluções
- As tags não estão sendo aplicadas pela automação
Revise as permissões da tag. Se houver tags restritas que devem ser aplicadas, certifique-se de que a configuração de automaçãoAllow Restricted Tagsesteja habilitada. - A automação é executada, mas não marca os tópicos
Revise os logs do site para identificar quaisquer erros associados aos plugins Discourse AI ou Discourse Automation.