[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-18。"],[[["\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."]]