Dialogflow는 최종 사용자 표현에서 일반적인 유형을 추출할 수 있도록 여러 시스템 항목을 제공합니다.
예를 들어 @sys.color 유형을 사용하여 '빨간색' 또는 '파란색'과 같은 값을 추출할 수 있습니다.
시스템 항목 참조에서 시스템 항목의 전체 목록을 확인할 수 있습니다.
시스템 항목에서 제공하는 값은 대부분의 애플리케이션에서 제대로 작동합니다.
하지만 애플리케이션에서 시스템 항목 값을 추가해야 할 수 있습니다.
예를 들어 @sys.color 값 목록에 '파란색-녹색'을 추가하려 할 수 있습니다.
일부 시스템 항목은 이러한 용도로 확장 가능합니다.
시스템 항목 참조에는 확장 가능한 시스템 항목이 나와 있습니다.
이 문서의 나머지 섹션에서는 시스템 항목을 확장하는 방법을 설명합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[[["\u003cp\u003eDialogflow uses system entities to identify common types in user input, such as colors.\u003c/p\u003e\n"],["\u003cp\u003eWhile system entities work well for most applications, some can be extended to include additional values specific to your needs.\u003c/p\u003e\n"],["\u003cp\u003eSystem entity support can vary by language, and some system entities cannot be extended.\u003c/p\u003e\n"],["\u003cp\u003eSystem entities can be extended through the Dialogflow ES console's Entities page by selecting the System tab and updating the values of an extendable entity.\u003c/p\u003e\n"],["\u003cp\u003eSystem entities can also be extended by annotating a training phrase with a new value or creating a new system entity through the API.\u003c/p\u003e\n"]]],[],null,["# System entities\n\nDialogflow 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/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\" to the list of values for `@sys.color`.\nSome system entities can be extended for this purpose.\nThe\n[System entity reference](/dialogflow/docs/reference/system-entities)\nlists the system entities that can be extended.\nThe remaining sections of this document describe how to extend system entities.\n\nSystem entity support differs for each language.\nSee the\n[system entity limitations](/dialogflow/es/docs/reference/system-entities#limits)\nfor details.\n\nWhere to find this data\n-----------------------\n\nWhen building an agent,\nit is most common to use the\nDialogflow ES console ([visit documentation](/dialogflow/docs/console), [open console](https://dialogflow.cloud.google.com)).\nThe instructions below focus on using the console.\nTo access system entity data for your agent:\n\n1. Go to the [Dialogflow ES console](https://dialogflow.cloud.google.com).\n2. Select an agent.\n3. Select **Entities** in the left sidebar menu.\n4. Select the **System** tab for system entities.\n\nIf you are building an agent using the API instead of the console, see the\n[EntityTypes reference](/dialogflow/docs/reference/common-types#entitytypes).\nThe API field names are similar to the console field names.\nThe instructions below highlight any important differences between the console and the API.\n\nExtend a system entity from the entities page\n---------------------------------------------\n\nFrom the entities page,\nyou can view system entities used by your agent\nand extend them by following these steps:\n\n1. Use the system entity in one of your [parameters](/dialogflow/docs/intents-actions-parameters).\n2. Select **Entities** in the left sidebar menu.\n3. Select the **System** tab for system entities.\n4. 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.\n5. You can select an extendable entity and update the extended values.\n6. Provide entity entries using the values you want to extend the entity with.\n\nExtend a system entity with the API\n-----------------------------------\n\nIf you are using the API to extend system entities,\ncreate system entity extensions similar to how you create\n[custom entities](/dialogflow/docs/entities-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.\n\nExtend a system entity while annotating a training phrase\n---------------------------------------------------------\n\nFrom the intent page's training phrase section,\nyou can extend a system entity while\n[annotating a training phrase](/dialogflow/docs/intents-training-phrases#annotation).\nIf you manually annotate a training phrase part\nwith an extendable system entity that does not include the selected value,\nyou will be prompted to add this value to the system entity."]]
