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 agents de conversation (Dialogflow CX) fournissent de nombreuses entités système permettant d'extraire les types de valeur les plus courants des expressions d'utilisateur final.
Par exemple, le type @sys.color permet d'extraire des valeurs telles que "rouge" ou "bleu".
Vous trouverez la liste complète des entités système dans la documentation de référence sur les entités système.
Les valeurs fournies par les entités système conviennent pour la plupart des applications.
Il se peut cependant que votre application nécessite l'ajout de valeurs supplémentaires pour certaines entités système.
Par exemple, vous pourriez avoir besoin d'ajouter "bleu-vert" à la liste des valeurs de @sys.color.
Certaines entités système peuvent être étendues à cette fin.
La documentation de référence sur les entités système répertorie les entités système pouvant être étendues.
Pour étendre une entité système, procédez comme suit :
Console
Utilisez l'entité système dans l'un de vos paramètres.
Sélectionnez l'onglet Manage (Gérer).
Cliquez sur Entity Types (Types d'entités).
Cliquez sur l'onglet System (Système) pour accéder aux entités système.
La liste des entités système actuellement utilisées par votre agent s'affiche.
Les entités dont le nom est affiché dans une couleur de police normale sont extensibles, en revanche celles dont le nom est affiché en gris ne sont pas extensibles.
Vous pouvez sélectionner une entité extensible et mettre à jour les valeurs étendues.
Fournissez des entrées d'entité en utilisant les valeurs avec lesquelles vous souhaitez étendre l'entité.
API
La création d'extensions d'entité système est semblable à la création d'entités personnalisées.
Indiquez le nom de l'entité système que vous souhaitez étendre et indiquez les valeurs à inclure dans l'extension.
Si l'entité système que vous tentez d'étendre n'est pas extensible, une erreur est renvoyée.
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/08/18 (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/08/18 (UTC)."],[[["\u003cp\u003eDialogflow CX offers system entities to extract common types from user expressions, such as \u003ccode\u003e@sys.color\u003c/code\u003e for colors like "red" and "blue".\u003c/p\u003e\n"],["\u003cp\u003eSome system entities are extendable, allowing you to add values like "blue-green" to \u003ccode\u003e@sys.color\u003c/code\u003e or to other applicable entities.\u003c/p\u003e\n"],["\u003cp\u003eSystem entities that can be extended are listed in the System entity reference and can be identified by their normal font color in the console.\u003c/p\u003e\n"],["\u003cp\u003eSystem entity support varies by language and region, with details on limitations provided in the system entity limitations section.\u003c/p\u003e\n"],["\u003cp\u003eExtending a system entity can be done via the Dialogflow CX console by selecting the extendable entity and adding values, or through the API similarly to creating custom entities.\u003c/p\u003e\n"]]],[],null,["# System entities\n\nConversational Agents (Dialogflow CX) provides many *system entities*\nto extract common types from end-user expressions.\nFor example, the `@sys.color` type can be used\nto extract values like \"red\" or \"blue\".\nYou can see the full list of system entities in the\n[System entity reference](/dialogflow/cx/docs/reference/system-entities).\n\nFor most applications, the values provided by system entities work well.\nHowever, your application may need to add additional values for system entities.\nFor example, you may want to add \"blue-green\"\nto the list of values for `@sys.color`.\nSome system entities can be extended for this purpose.\nThe\n[System entity reference](/dialogflow/cx/docs/reference/system-entities)\nlists the system entities that can be extended.\n\nSystem entity support differs for\n[languages](/dialogflow/cx/docs/reference/language)\nand\n[regions](/dialogflow/cx/docs/concept/region).\nSee the\n[system entity limitations](/dialogflow/cx/docs/reference/system-entities#limits)\nfor details.\n\nExtend a system entity\n----------------------\n\nTo extend a system entity: \n\n### Console\n\n1. Use the system entity in one of your [parameters](/dialogflow/docs/intents-actions-parameters).\n2. Select the **Manage** tab.\n3. Click **Entity Types**.\n4. Select the **System** tab for system entities.\n5. The system entities currently used by your agent are listed. Entities shown in a grey font color are not extendable, and entities shown in a normal font color are extendable.\n6. You can select an extendable entity and update the extended values.\n7. Provide entity entries using the values you want to extend the entity with.\n\n### API\n\nCreating system entity extensions is similar to how you create\n[custom entities](/dialogflow/cx/docs/concept/entity-custom).\nProvide the name of the system entity you wish to extend,\nand provide the values you want to extend it with.\nIf you attempt to extend a system entity that is not extendable,\nyou will receive an error."]]
