Entités

Les types d'entité permettent de contrôler la manière dont les données des entrées de l'utilisateur final sont extraites.

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

  • 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 CX, chaque ligne de l'affichage est 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.