Certains produits et fonctionnalités sont en cours de changement de nom. Les fonctionnalités de playbook et de flux génératifs sont également en cours de migration vers une console unique. Consultez les détails.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 :
(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.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 précédent.
Pour ces entrées d'entités, vous devez fournir une valeur de référence et un ou plusieurs synonymes.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eEntity types control the extraction of data from user input in Conversational Agents (Dialogflow CX).\u003c/p\u003e\n"],["\u003cp\u003eDialogflow CX offers predefined system entities for common data types like dates and times, and allows the creation of custom entities.\u003c/p\u003e\n"],["\u003cp\u003eAn entity type defines the kind of information to be extracted, such as "vegetable" as a display name for an entity type.\u003c/p\u003e\n"],["\u003cp\u003eEntity entries within an entity type contain a reference value and a set of synonyms that are treated as equivalent in user input.\u003c/p\u003e\n"],["\u003cp\u003eDialogflow CX allows for the automatic generation of synonyms for entity reference values using AI, to simplify the process of defining entity entries.\u003c/p\u003e\n"]]],[],null,["# Entities\n\n*Entity types* are used to control how data from end-user input is extracted.\n\n\u003cbr /\u003e\n\nConversational Agents (Dialogflow CX) provides predefined\n[system entities](/dialogflow/cx/docs/concept/entity-system)\nthat can match many common types of data.\nFor example, there are system entities for matching dates,\ntimes, colors, email addresses, and so on.\nYou can also create your own\n[custom entities](/dialogflow/cx/docs/concept/entity-custom)\nfor matching custom data.\nFor example,\nyou could define a vegetable entity\nthat can match the types of vegetables available\nfor purchase with a grocery store agent.\n\nEntity terminology\n------------------\n\nThe term *entity* is used in this documentation and in the Dialogflow CX console\nto describe the general concept of entities.\nWhen discussing entity details,\nit's important to understand more specific terms:\n\n- **Entity type** :\n Defines the type of information you want to extract from user input.\n For example, *vegetable* could be the display name of an entity type.\n Clicking **Create** from the **Entity Types** section\n of the Dialogflow CX console creates an *entity type* .\n When using the API,\n the term *entity type* refers to the `EntityType` type.\n\n\n Go to the EntityType API reference\n\n **Select a protocol and version for the EntityType reference:**\n\n Close\n\n \u003cbr /\u003e\n\n- **(Optional) Description**: Describes the purpose of the entity type, for\n example \"This entity is triggered when the user mentions a vegetable\". If\n you intend to use AI generation to auto-generate reference value synonyms,\n this field will be used by the model to produce higher-quality results.\n\n- **Entity entry** :\n For each entity type, there can be many *entity entries* . Each entity entry\n provides a set of words or phrases that are considered equivalent, a\n *reference value* in the first column and one or more *synonyms* to that\n reference value in the second column. For example, if *vegetable* is an\n entity type, you could define these entity entries:\n\n Instead of entering entity entries and synonyms manually, you can select\n the **Auto-generate __ syonyms per entity** checkbox when you create a new\n entity entry. The default value is 3 synonyms. The AI will generate synonyms\n based on the reference value and entity type description and enter them in\n the table. Please note that the synonyms list must also include the\n original reference value in order to produce a match to that value.\n\n When editing an entity type from the Dialogflow CX console, each row of the\n display is an *entity entry* . When using the API,\n the term *entity entry* refers to the\n `Entity` type (`EntityType.Entity` or `EntityType_Entity`\n for some client library languages).\n- **Entity reference value and synonyms** :\n Some entity entries have multiple words or phrases\n that are considered equivalent,\n like the *scallion* in previous example.\n For these entity entries, you provide one *reference value*\n and one or more *synonyms*."]]
