Questa guida spiega come etichettare automaticamente gli argomenti utilizzando la funzione di triage AI nel plugin Discourse AI combinata con Discourse Automation.
Livello utente richiesto: Amministratore
Etichettare gli argomenti con l’AI
Questa automazione utilizza un LLM per leggere il contenuto degli argomenti e decidere se applicare etichette specifiche. Può anche considerare tutte le etichette del sito se configurato nelle impostazioni di automazione.
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 appropriato.
Configurazioni di riferimento per l’Agente
- Prompt di sistema:
Sei un esperto classificatore di contenuti e assistente di etichettatura per questo forum.
Il tuo compito è analizzare i post e suggerire etichette appropriate in base al contenuto, alle immagini e all'elenco delle etichette disponibili fornito.
Linee guida:
- Suggerisci solo etichette dall'elenco delle etichette disponibili fornito
- Sii conservativo: etichetta solo ciò di cui sei sicuro
- Considera sia l'argomento del contenuto che l'intento del post
Devi sempre rispondere con un JSON valido in questo formato esatto:
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags: array di nomi di etichette dall'elenco disponibile
- confidence: numero intero da 0 a 100 che rappresenta il tuo livello di fiducia
Se nessuna etichetta è appropriata, usa: {"tags": [], "confidence": 0}
- Formato di risposta JSON della Persona:
{
"tags": "[string]",
"confidence": "integer"
}
- 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: Etichette
- Strumenti forzati: Etichette
- Strategia strumenti forzati: Applica solo alla prima risposta
- ModalitĂ di esecuzione: Predefinita (Limiti fissi)
Configurazioni di automazione
- Vai su Admin → Plugins → Automations.
- Clicca su + Add Automation.
- Seleziona lo script Tag topics using AI.
- Configura le impostazioni dalla sezione When/What come preferisci.
- Seleziona l’Agente definito per questa automazione nell’impostazione
AI Agentdalla sezione Script options. - Specifica come l’AI selezionerà le etichette nell’impostazione
Tag Selection Mode.- Usa un elenco specifico di etichette (configurato nell’impostazione
Available Tags) - Lascia che l’AI scopra e utilizzi qualsiasi etichetta del sito.
- Usa un elenco specifico di etichette (configurato nell’impostazione
- 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 etichettature errate diffuse.
- Scrivi descrizioni chiare delle etichette nel tuo prompt: Più precise sono le tue descrizioni del significato di ogni etichetta, 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 revisionare e correggere gli argomenti etichettati erroneamente e aggiusta il tuo prompt nel tempo.
- Mantieni limiti di token ragionevoli: L’impostazione “Max Post Tokens” limita quanto di un post viene inviato all’LLM. Per la maggior parte delle attività di etichettatura, le prime centinaia di token (l’inizio del post) sono sufficienti.
Problemi comuni e soluzioni
- Le etichette non vengono applicate dall’automazione
Rivedi le autorizzazioni dell’etichetta. Se ci sono etichette riservate che dovrebbero essere applicate, assicurati che l’impostazione di automazioneAllow Restricted Tagssia abilitata. - L’automazione viene eseguita ma non etichetta gli argomenti
Rivedi i log del sito per identificare eventuali errori associati ai plugin Discourse AI o Discourse Automation.