Ce guide explique comment catégoriser automatiquement les sujets en utilisant la fonctionnalité de triage par IA du plugin Discourse AI combinée à Discourse Automation.
Niveau d’utilisateur requis : Administrateur
Catégorisation automatique des sujets par IA
Cette automatisation utilise un LLM pour lire le contenu des sujets, déterminer si la catégorie sélectionnée est appropriée, et la mettre à jour si l’Agent IA estime qu’une autre catégorie convient mieux au sujet.
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é.
Configurations de référence pour l’Agent
- Prompt système :
Vous êtes un expert en classification de contenu pour ce forum.
Votre tâche consiste à analyser les messages et à suggérer la catégorie appropriée en fonction du contenu, des images et de la liste des catégories disponibles.
Directives :
- Soyez prudent : ne catégorisez que ce dont vous êtes certain
- Tenez compte à la fois du sujet du contenu et de l'intention du message
- 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 : Read, Categories, Edit Categories
- Outils forcés : Read, Categories
- Stratégie des outils forcés : Appliquer uniquement à la première réponse
- Mode d’exécution : Par défaut (Limites fixes)
- (Optionnel) Activez l’option « Exiger une approbation pour les outils de modération »
- Utilisateur : Créer un utilisateur
Configurations de l’automatisation
- Accédez à Admin → Plugins → Automations.
- Cliquez sur + Ajouter une automatisation.
- Sélectionnez le script Trier les messages à l’aide de l’Agent 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. - Activez le paramètre
Mode silencieux. - Cliquez sur le bouton Mettre à jour l’automatisation.
- Activez l’automatisation.
Bonnes pratiques
- Commencez par 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 LLM et réduit le risque de mauvaises catégorisations à grande échelle.
- Rédigez des descriptions de catégories claires dans votre prompt : Plus vos descriptions du sens de chaque catégorie 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 de révision et de correction des sujets mal catégorisé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 contenu d’un message envoyé au LLM. Pour la plupart des tâches de catégorisation automatique, les quelques centaines de premiers tokens (l’ouverture du message) suffisent.
Problèmes courants et solutions
- La catégorie appropriée n’est pas appliquée par l’automatisation
Vérifiez les paramètres de sécurité de la catégorie. Si la catégorie à appliquer est privée, assurez-vous que l’option d’outilRead privatedans les paramètres de l’Agent est activée. - L’automatisation s’exécute mais ne catégorise pas les sujets
Consultez les journaux du site pour identifier toute erreur liée aux plugins Discourse AI ou Discourse Automation.