Questa guida spiega come categorizzare automaticamente gli argomenti utilizzando la funzione di triage AI nel plugin Discourse AI combinata con Discourse Automation.
Livello utente richiesto: Amministratore
Categorizzare automaticamente gli argomenti con l’AI
Questa automazione utilizza un LLM per leggere il contenuto degli argomenti, decide se la categoria selezionata è appropriata e la aggiorna se l’Agente AI ritiene che un’altra categoria sia più adatta all’argomento.
Prerequisiti
- I plugin Discourse AI e Discourse Automation devono essere abilitati.
- Deve essere configurato almeno un LLM. Consulta la guida alle impostazioni LLM per le istruzioni di configurazione.
- Deve essere configurato un Agente con un prompt di sistema adeguato.
Configurazioni di riferimento per l’Agente
- Prompt di sistema:
Sei un esperto classificatore di contenuti per questo forum.
Il tuo compito è analizzare i post e suggerire la categoria appropriata in base al contenuto, alle immagini e all'elenco delle categorie disponibili.
Linee guida:
- Sii conservativo: categorizza solo ciò di cui sei sicuro
- Considera sia l'argomento del contenuto che l'intento del post
- Modello linguistico predefinito: Seleziona l’LLM configurato nella sezione Prerequisiti.
I clienti ospitati su Discourse possono selezionare il CDCK Hosted Small LLM durante la configurazione degli Agenti AI. - Strumenti abilitati: Read, Categories, Edit Categories
- Strumenti forzati: Read, Categories
- Strategia per gli strumenti forzati: Applicare solo alla prima risposta
- ModalitĂ di esecuzione: Predefinita (Limiti fissi)
- (Opzionale) Attiva l’opzione Richiedi approvazione per gli strumenti di moderazione
- Utente: Crea utente
Configurazioni dell’automazione
- Vai su Admin → Plugins → Automations.
- Clicca su + Add Automation.
- Seleziona lo script Triage posts using AI Agent.
- Configura le impostazioni dalla sezione Quando/Come desideri.
- Seleziona l’Agente definito per questa automazione nell’impostazione
AI Agentnella sezione Opzioni dello script. - Abilita l’impostazione
Silent Mode. - Clicca sul pulsante Aggiorna automazione.
- Abilita l’automazione.
Best practice
- Inizia con un ambito ristretto: Applica l’automazione solo a una categoria specifica o ai primi post di nuovi utenti (livello di fiducia 0 o 1) prima di espanderla. Questo limita i costi dell’LLM e riduce il rischio di una categorizzazione errata diffusa.
- Scrivi descrizioni chiare delle categorie nel tuo prompt: Più le descrizioni del significato di ciascuna categoria sono precise, più affidabilmente l’LLM classificherà correttamente.
- Monitora i falsi positivi e negativi: L’LLM non sarà accurato al 100%. Crea un flusso di lavoro per rivedere e correggere gli argomenti categorizzati erroneamente e adatta il tuo prompt nel tempo.
- Mantieni limiti di token ragionevoli: L’impostazione “Max Post Tokens” limita quanto contenuto di un post viene inviato all’LLM. Per la maggior parte delle attività di categorizzazione automatica, le prime centinaia di token (l’inizio del post) sono sufficienti.
Problemi comuni e soluzioni
- La categoria appropriata non viene applicata dall’automazione
Rivedi le impostazioni di sicurezza della categoria. Se la categoria che dovrebbe essere applicata è privata, assicurati che l’opzione dello strumentoRead privatenelle impostazioni dell’Agente sia abilitata. - L’automazione viene eseguita ma non categorizza gli argomenti
Rivedi i log del sito per identificare eventuali errori associati ai plugin Discourse AI o Discourse Automation.