Questa guida spiega come etichettare automaticamente gli argomenti utilizzando la funzionalitĂ 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 tutti i tag del sito se configurato nelle impostazioni dell’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 dell’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 dei tag disponibili fornito.
Linee guida:
- Suggerisci solo etichette dall'elenco dei tag 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 tag dall'elenco disponibile
- confidence: intero da 0 a 100 che rappresenta il tuo livello di fiducia
Se nessun tag è appropriato, usa: {"tags": [], "confidence": 0}
- Formato di risposta JSON dell’Agente:
{
"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: Tag
- Strumenti forzati: Tag
- Strategia degli strumenti forzati: Applica solo alla prima risposta
- ModalitĂ di esecuzione: Predefinita (Limiti fissi)
Configurazioni dell’automazione
- Vai su Admin → Plugins → Automations.
- Clicca su + Add Automation.
- Seleziona lo script Tag topics using AI.
- Configura le impostazioni dalla sezione Quando/Come desideri.
- Seleziona l’Agente definito per questa automazione nell’impostazione
AI Agentdalla sezione Opzioni script. - Specifica come l’AI selezionerà i tag nell’impostazione
Tag Selection Mode.- Usa un elenco di tag specifico (configurato nell’impostazione
Available Tags) - Lascia che l’AI scopra e utilizzi qualsiasi tag del sito.
- Usa un elenco di tag specifico (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 dei tag nel tuo prompt: Più precise sono le descrizioni del significato di ciascun tag, 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 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
- I tag non vengono applicati dall’automazione
Rivedi le autorizzazioni del tag. Se ci sono tag con restrizioni che dovrebbero essere applicati, assicurati che l’impostazione dell’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.