Dialogflow CX fournit des entités système prédéfinies correspondant à de nombreux types de données courants. Par exemple, il existe des entités système pour la mise en correspondance des dates, des heures, des couleurs, des adresses e-mail, etc. Vous pouvez également créer vos propres entités personnalisées pour la mise en correspondance de données personnalisées. Par exemple, vous pouvez définir une entité légume pouvant être mise en correspondance avec les types de légumes proposés dans une épicerie.
Terminologie relative aux entités
Le terme entité est utilisé dans cette documentation et dans la console Dialogflow CX pour décrire le concept général d'entité. En abordant les détails d'une entité, il est important de comprendre certains termes plus spécifiques :
Type d'entité : définit le type d'informations que vous souhaitez extraire de l'entrée utilisateur. Par exemple, légume pourrait être le nom à afficher d'un type d'entité. Cliquez sur Créer dans la section Types d'entités de la console Dialogflow CX pour créer un type d'entité. Lorsque vous utilisez l'API, le terme type d'entité fait référence au type
EntityType.Sélectionnez un protocole et une version pour la référence EntityType :
Protocole V3 V3beta1 REST Ressource EntityType Ressource EntityType RPC Interface EntityType Interface EntityType C++ EntityTypesClient Non disponible C# EntityTypesClient Non disponible Go EntityTypesClient Non disponible Java EntityTypesClient EntityTypesClient Node.js EntityTypesClient EntityTypesClient PHP Non disponible Non disponible Python EntityTypesClient EntityTypesClient Ruby Non disponible Non disponible (Facultatif) Description : décrit l'objectif du type d'entité, par exemple "Cette entité est déclenchée lorsque l'utilisateur mentionne un légume". Si vous avez l'intention d'utiliser la génération par IA pour générer automatiquement des synonymes de valeurs de référence, ce champ sera utilisé par le modèle pour produire des résultats de meilleure qualité.
Entrée d'entité : pour chaque type d'entité, il peut y avoir de nombreuses entrées d'entité. Chaque entrée d'entité fournit un ensemble de mots ou d'expressions considérés comme équivalents, une valeur de référence dans la première colonne et un ou plusieurs synonymes de cette valeur de référence dans la deuxième colonne. Par exemple, si vegetable est un type d'entité, vous pouvez définir ces entrées d'entité :
Valeur de référence Synonymes oignon vert cébette, oignon vert poivron poivron carrot carrot pomme de terre pomme de terre, patate, tubercule Au lieu de saisir manuellement les entrées d'entité et les synonymes, vous pouvez cocher la case Générer automatiquement __ synonymes par entité lorsque vous créez une entrée d'entité. La valeur par défaut est de trois synonymes. L'IA génère des synonymes en fonction de la valeur de référence et de la description du type d'entité, puis les saisit dans le tableau. Notez que la liste de synonymes doit également inclure la valeur de référence d'origine pour produire une correspondance avec cette valeur.
Lorsque vous modifiez un type d'entité à partir de la console Dialogflow CX, chaque ligne de l'affichage correspond à une entrée d'entité. Lorsque vous utilisez l'API, le terme entrée d'entité fait référence au type
Entity(EntityType.EntityouEntityType_Entitypour certains langages de bibliothèques clientes).Valeur de référence et synonymes d'une entité : certaines entrées d'entité comportent plusieurs mots ou expressions considérés comme équivalents, comme scallion (oignon vert) dans l'exemple précédent. Pour ces entrées d'entités, vous devez fournir une valeur de référence et un ou plusieurs synonymes.