Ce guide explique comment taguer automatiquement les sujets en utilisant la fonctionnalité de triage par IA du plugin Discourse AI combinée à Discourse Automation.
Niveau utilisateur requis : Administrateur
Taguer les sujets avec l’IA
Cette automatisation utilise un LLM pour lire le contenu des sujets et décider d’appliquer des tags spécifiques. Elle peut également prendre en compte tous les tags du site si configuré dans les paramètres de l’automatisation.
Prérequis
- Les plugins Discourse AI et Discourse Automation doivent être activés.
- Au moins un LLM doit être configuré. Consultez le guide des paramètres LLM pour les instructions de configuration.
- Un Agent doit être configuré avec un prompt système approprié.
Références de configuration d’Agent
- Prompt système :
Vous êtes un expert en classification de contenu et assistant de tag pour ce forum.
Votre tâche consiste à analyser les messages et à suggérer des tags appropriés en fonction du contenu, des images et de la liste des tags disponibles fournie.
Directives :
- Ne suggérez que des tags issus de la liste des tags disponibles fournie
- Soyez prudent : n'appliquez des tags que si vous en êtes certain
- Tenez compte à la fois du sujet du contenu et de l'intention du message
Vous devez toujours répondre avec un JSON valide dans ce format exact :
{"tags": ["tag1", "tag2"], "confidence": 85}
- tags : tableau de noms de tags issus de la liste disponible
- confidence : entier de 0 à 100 représentant votre niveau de confiance
Si aucun tag n'est approprié, utilisez : {"tags": [], "confidence": 0}
- Format de réponse JSON de l’Agent :
{
"tags": "[string]",
"confidence": "integer"
}
- Modèle de langage par défaut : Sélectionnez le LLM configuré dans la section Prérequis.
Les clients hébergés par Discourse peuvent sélectionner le CDCK Hosted Small LLM lors de la configuration des Agents IA. - Outils activés : Tags
- Outils forcés : Tags
- Stratégie des outils forcés : Appliquer uniquement à la première réponse
- Mode d’exécution : Par défaut (Limites fixes)
Configurations de l’automatisation
- Accédez à Admin → Plugins → Automations.
- Cliquez sur + Ajouter une automatisation.
- Sélectionnez le script Taguer les sujets avec l’IA.
- Configurez les paramètres de la section Quand/Comme bon vous semble.
- Sélectionnez l’Agent défini pour cette automatisation dans le paramètre
AI Agentde la section Options du script. - Spécifiez comment l’IA sélectionnera les tags dans le paramètre
Tag Selection Mode.- Utiliser une liste de tags spécifique (configurée dans le paramètre
Available Tags) - Laisser l’IA découvrir et utiliser n’importe quel tag du site.
- Utiliser une liste de tags spécifique (configurée dans le paramètre
- Cliquez sur le bouton Mettre à jour l’automatisation.
- Activez l’automatisation.
Bonnes pratiques
- Commencez avec un périmètre restreint : Appliquez l’automatisation uniquement à une catégorie spécifique ou aux premiers messages des nouveaux utilisateurs (niveau de confiance 0 ou 1) avant de l’étendre. Cela limite les coûts du LLM et réduit le risque de mauvais tagage généralisé.
- Rédigez des descriptions claires des tags dans votre prompt : Plus vos descriptions de la signification de chaque tag sont précises, plus le LLM classera correctement.
- Surveillez les faux positifs et les faux négatifs : Le LLM ne sera pas précis à 100 %. Mettez en place un processus pour réviser et corriger les sujets mal tagués, et ajustez votre prompt au fil du temps.
- Gardez les limites de tokens raisonnables : Le paramètre « Max Post Tokens » limite la quantité de message envoyée au LLM. Pour la plupart des tâches de tag, les quelques centaines de premiers tokens (l’ouverture du message) suffisent.
Problèmes courants et solutions
- Les tags ne sont pas appliqués par l’automatisation
Vérifiez les permissions des tags. Si des tags restreints doivent être appliqués, assurez-vous que le paramètre d’automatisationAllow Restricted Tagsest activé. - L’automatisation s’exécute mais ne tague pas les sujets
Consultez les journaux du site pour identifier toute erreur associée aux plugins Discourse AI ou Discourse Automation.