Les phrases d'entraînement sont des exemples de phrases que les utilisateurs finaux sont susceptibles de saisir ou de prononcer (désignées par le terme expressions de l'utilisateur final). Pour chaque intent, vous définissez plusieurs phrases d'entraînement. Lorsque l'expression d'un utilisateur final ressemble à l'une de ces phrases, Dialogflow la met en correspondance avec l'intent.
Par exemple, une phrase d'entraînement telle que "Je veux manger une pizza" entraîne votre agent à reconnaître les expressions de l'utilisateur final semblables à cette phrase, comme "Acheter une pizza" ou "Commander une pizza".
Vous n'avez pas besoin de définir tous les exemples possibles, car le machine learning intégré de Dialogflow en développe d'autres à partir de votre liste et d'autres phrases semblables. Vous devez créer au moins 10 à 20 phrases (en fonction de la complexité de l'intent) pour que votre agent puisse reconnaître diverses expressions d'utilisateur final. Par exemple, si vous souhaitez que votre intent identifie une expression d'un utilisateur final concernant sa couleur préférée, vous pouvez définir les phrases d'entraînement suivantes :
- "J'aime le rouge"
- "Ma couleur préférée est le jaune"
- "noir"
- "Le bleu est ma couleur préférée"
- …
Où trouver ces données
La méthode la plus courante pour créer un agent consiste à utiliser la console Dialogflow ES (consulter la documentation, ouvrir la console). Les instructions ci-dessous concernent l'utilisation de la console. Pour accéder aux données des phrases d'entraînement, procédez comme suit :
- Accédez à la console Dialogflow ES.
- Sélectionnez un agent.
- Cliquez sur Intents dans le menu de la barre latérale gauche.
- Sélectionnez un intent.
- Faites défiler la page jusqu'à la section Training phrases (Phrases d'entraînement).
Si vous créez un agent à l'aide de l'API au lieu de la console, consultez la documentation de référence sur les intents. Les champs portent le même nom dans l'API et dans la console. Les instructions ci-dessous présentent les différences importantes entre la console et l'API.
Ajouter des phrases d'entraînement
Pour ajouter des phrases d'entraînement à un intent, procédez comme suit :
- Cliquez sur le champ de texte "Add user expression" (Ajouter une expression utilisateur).
- Saisissez vos phrases d'entraînement et appuyez sur la touche
Enteraprès chaque saisie.
Annoter les phrases d'entraînement
Lorsqu'un intent est mis en correspondance au moment de l'exécution, Dialogflow fournit les valeurs extraites de l'expression de l'utilisateur final en tant que paramètres. Chaque paramètre est associé à un type, appelé type d'entité, qui détermine la manière exacte dont les données sont extraites. Contrairement aux entrées utilisateur brutes, les paramètres sont des données structurées pouvant être utilisées pour exécuter une logique ou générer des réponses.Lorsque vous créez un agent, vous pouvez annoter le texte de vos phrases d'entraînement et configurer les paramètres associés pour contrôler la manière dont les données sont extraites.
Par exemple, imaginons que vous définissiez une phrase d'entraînement comme "Quel temps fera-t-il demain à Tokyo ?".
Vous devez annoter "demain" avec le paramètre date et "Tokyo" avec le paramètre location.
Lorsque vous annotez des mots dans une phrase d'entraînement, Dialogflow reconnaît que ce ne sont que des exemples de valeurs réelles fournies par les utilisateurs finaux au moment de l'exécution.
Si l'expression d'un utilisateur final est "Quel temps est prévu pour vendredi à Sydney ?",
Dialogflow extrait le paramètre date à partir de "vendredi" "et le paramètre location à partir de "Sydney".
Lorsque vous créez un agent avec la console, la plupart des annotations sont automatiquement créées lorsque vous ajoutez des phrases d'entraînement qui contiennent du texte pouvant être associé à un type d'entité existant. Ce texte est mis en surbrillance dans la console. Vous pouvez modifier ces annotations et ces paramètres si nécessaire.
Pour annoter manuellement une phrase d'entraînement à l'aide de la console, procédez comme suit :
- Sélectionnez le texte de la phrase d'entraînement que vous souhaitez annoter.
- Sélectionnez le type d'entité souhaité dans la liste.
- Un paramètre est créé pour vous dans le tableau des paramètres présenté ci-dessous.
- Cliquez sur le bouton Enregistrer et attendez que la boîte de dialogue Entraînement de l'agent indique que l'entraînement est terminé.
Quand vous créez un agent à l'aide de l'API, vous devez annoter les expressions d'entraînement et configurer les paramètres manuellement.
Reportez-vous aux types TrainingPhrase et Parameter dans la documentation de référence sur les intents.
Le champ Part.alias associe des annotations de phrases d'entraînement à des paramètres particuliers.
Entités implicites créées par des phrases d'entraînement
La plupart des entités personnalisées sont définies explicitement en créant des types d'entités et en ajoutant des entrées d'entités. Toutefois, les entités personnalisées peuvent également contenir des valeurs implicites. Cela se produit lorsque vous annotez le texte d'une phrase d'entraînement, où le texte annoté n'est pas une valeur définie par le type d'entité sélectionné. Le texte annoté devient une valeur de référence d'entité pour l'entrée d'entité ajoutée implicitement. Si le type d'entité est une entité de carte, le texte devient également un synonyme de l'entrée d'entité.
Modes exemple et modèle
Chaque expression d'entraînement peut appartenir à l'un des deux modes suivants :
- Mode exemple : indiqué par format_quote à gauche de la phrase d'entraînement. Les phrases d'entraînement en mode exemple sont écrites en langage naturel et annotées afin que les paramètres puissent être extraits.
- Mode modèle : indiqué par alternate_email à gauche de la phrase d'entraînement. Les phrases d'entraînement en mode modèle contiennent des références directes aux types d'entités.