Un Intent représente ce que l'utilisateur veut savoir ou faire via le bot.

Les Intents sont des points d'entrée qui déclenchent un Use Case. Il existe deux types d'Intents, selon l'endroit où se trouve l'utilisateur dans le parcours :

• Start Intents (dans la Start User Action)

• Intents (dans une User Action)

Chaque Use Case possède un ou plusieurs Start Intents.
Chaque User Action possède un ou plusieurs Intents.

Créer un Intent

Nom de l'Intent

Donnez à chaque Intent un nom clair qui reflète l'intention de l'utilisateur.

👍 Bonne pratique pour nommer les Intents

Nommez les Intents de façon cohérente pour que vos collègues les comprennent facilement et les distinguent des Intents similaires

Description de l'Intent et Labeling Hints

La description de l'Intent aide les concepteurs de bots à comprendre l'intention de l'utilisateur.

👍 Bonne pratique pour la description et le labeling

Précisez les Use Cases couverts par l'Intent, les autres Intents avec lesquels il risque d'être confondu et les variables que le bot détecte dans les phrases des utilisateurs

Types d'Intents

Le type d'un Intent décrit le genre d'élément qu'il doit détecter :

• Text : détecte une phrase envoyée au bot par l'utilisateur.

• Misunderstanding : déclenche directement la classe « OUT » du modèle. Il n'en existe qu'une par bot.

• Image : détecte une image envoyée au bot.

• Video : détecte une vidéo envoyée au bot.

• Audio : détecte un message vocal envoyé au bot.

• Location : détecte une localisation envoyée au bot.

📌 Remarque

Le bot détecte le format des images, vidéos ou fichiers audio, mais ne peut pas en comprendre le contenu. Vous pouvez définir une réponse spécifique pour informer l'utilisateur que le fichier a bien été reçu mais n'a pas été compris.

Hints

Les hints sont des exemples de phrases qui aident les concepteurs de bots et les annotateurs à comprendre l'Intent.

Priorité

La priorité sert à départager des User Actions qui se chevauchent et créent de la confusion lors de la prédiction du bon Intent.

Bot Action déclenchée

Sélectionnez la Bot Action déclenchée lorsque l'Intent est détecté. Les Start Intents du Use Case sont systématiquement reliés à la Start Bot Action du Use Case.

Erase

Indiquez les variables à effacer du contexte lorsque l'Intent est déclenché.

📌 Comment indiquer les variables à effacer

• ""` (chaîne vide) : le contexte reste inchangé.

• "key1, key2, key3" (clés séparées par des virgules) : efface les variables listées.

• "erase_all" : vide entièrement le contexte.

• "erase_all_except key1, key2, key3" : efface toutes les variables sauf les clés listées.

📌 Les espaces sont ignorés dans la liste des clés.

Ajouter des Entities à votre Intent

Vous pouvez ajouter des Entities et leurs wrappers associés à votre Intent.

Nom de l'Entity

Saisissez le nom de l'Entity qui sera utilisé dans le contexte.

👍 Bonne pratique

Utilisez des noms en minuscules, sans caractères spéciaux, pour éviter les fautes de frappe et les erreurs.

Wrapper

Sélectionnez un wrapper à appliquer à votre Entity.

Type d'Entity

Sélectionnez un type d'Entity pour votre Intent.

Required

Lorsque cette option est sélectionnée :

• L'Intent ne peut pas être déclenché si l'Entity est absente du message de l'utilisateur ou du payload de la Quick Reply ou du bouton.

📌 Inspection de la trace

Dans la Trace, vérifiez si des Entities sont manquantes sous :
Raw > NLP Controller > Instance Classifier : `"missing_entities": "True"

Optional

Lorsque cette option est sélectionnée :

• L'Intent peut être déclenché même si l'Entity est absente du message de l'utilisateur ou du payload.

Ajouter des phrases d'entraînement à votre Intent

Rule-Based

Les Intents par règles sont déclenchés par la détection de mots-clés précis. Définissez des ensembles de mots qui déclenchent l'Intent lorsqu'ils apparaissent dans les messages des utilisateurs. Pour plus de détails, consultez Syntaxe des règles.

📌 Remarque

Les Intents par règles ne sont vérifiés qu'une fois que le modèle a examiné tous les Intents IA sans qu'aucun ne soit déclenché.

AI-Based

Les Intents IA sont déclenchés par l'analyse de phrases complètes (Training Phrases). Fournissez des phrases variées et représentatives pour entraîner le modèle. Les modifications des phrases d'entraînement d'un Use Case publié s'appliquent dès le réentraînement.

📌 Bonne pratique

Fournissez au moins 10 phrases d'entraînement pour les Intents IA. Les Intents qui en ont moins ne sont pas pris en compte dans l'entraînement du modèle.

Score de qualité NLU

Chaque phrase d'entraînement reçoit un score de qualité qui indique dans quelle mesure elle correspond à l'Intent :

• Vert 🟢 : score de qualité ≥ 0,5, et aucun Intent concurrent n'a un score > 0,2.

• Orange 🟠 : score de qualité < 0,5, ou un Intent concurrent a un score > 0,2.

• Rouge 🟥 : le score de qualité d'un autre Intent dépasse celui de la phrase.

• Blanc ⚪ : score de qualité non calculé ou phrase en double. Relancez l'entraînement pour mettre à jour les scores.

🖋️ Astuce :

Un score orange ne signifie pas que l'Intent ne sera pas déclenché. Considérez-le comme un avertissement pour affiner vos phrases d'entraînement

Pour résoudre les problèmes de score de qualité NLU :

• Ajoutez davantage de variantes de phrases.

• Supprimez les phrases hors sujet.

• Ajustez les phrases des Intents concurrents.

Importer / télécharger les phrases d'entraînement en CSV

Importez un fichier CSV pour ajouter des phrases d'entraînement, ou téléchargez les phrases existantes pour les modifier.

Format CSV :

message,use_as,smart_label,label
"What's the weather today in Paris?",example,false,false
"It is raining?",example,false,false

📌 Remarque

Mettez entre guillemets doubles les phrases qui contiennent des virgules pour éviter les conflits.

⚠️ Pour supprimer des phrases d'entraînement, utilisez l'icône de corbeille 🗑.