Entities

Chaque paramètre d'intent est associé à un type, appelé type d'entité, qui détermine la manière exacte dont les données sont extraites d'une expression d'utilisateur final.

Dialogflow 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 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 d'un type d'entité. Lorsque vous cliquez sur Créer une entité dans la console Dialogflow, vous créez un type d'entité. Lorsque vous utilisez l'API, le terme type d'entité fait référence au type EntityType.

  • Entrée d'entité : pour chaque type d'entité, il existe de nombreuses entrées d'entité. Chaque entrée d'entité fournit un ensemble de mots ou d'expressions considérés comme équivalents. Par exemple, si légume est un type d'entité, vous pouvez définir ces trois entrées d'entité :

    • carotte
    • cébette, oignon vert
    • poivron

    Lors de la modification d'un type d'entité à partir de la console Dialogflow, chaque ligne affichée 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.Entity ou EntityType_Entity pour 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 ci-dessus. Pour ces entrées d'entités, vous devez fournir une valeur de référence et un ou plusieurs synonymes.