Les agents de conversation (Dialogflow CX) fournissent 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 des entités. 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é. Lorsque vous cliquez sur Créer dans la section Types d'entités de la console Dialogflow CX, vous créez 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 souhaitez utiliser la génération d'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 exister 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 légume est un type d'entité, vous pouvez définir ces entrées d'entité:
Valeur de référence Synonymes cébette cébette, oignon vert poivron poivron carrot carrot pomme de terre pomme de terre Au lieu de saisir manuellement des entrées d'entités et des 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 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 des 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 constitue 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 d'entité et synonymes : certaines entrées d'entité comportent plusieurs mots ou expressions considérés comme équivalents, comme cébette 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.