대화형 에이전트(Dialogflow CX)는 여러 일반적인 데이터 유형과 일치시킬 수 있는 사전 정의된 시스템 항목을 제공합니다.
예를 들어 날짜, 시간, 색상, 이메일 주소 등을 일치시키는 시스템 항목이 있습니다.
커스텀 데이터와 일치시킬 커스텀 항목을 직접 만들 수도 있습니다.
예를 들어 식료품 가게 에이전트를 통해 구매 가능한 야채의 유형과 일치할 수 있는 야채 항목을 정의할 수 있습니다.
항목 용어
항목이라는 용어는 이 문서와 Dialogflow CX 콘솔에서 항목의 일반적인 개념을 설명하는 데 사용됩니다.
항목 세부정보를 논의할 때는 더 구체적인 용어를 이해하는 것이 중요합니다.
항목 유형:
사용자 입력에서 추출하고자 하는 정보의 유형을 정의합니다.
예를 들어 야채는 항목 유형의 표시 이름일 수 있습니다.
Dialogflow CX 콘솔의 항목 유형 섹션에서 만들기를 클릭하면 항목 유형이 생성됩니다.
API를 사용할 때 항목 유형이라는 용어는 EntityType 유형을 나타냅니다.
(선택사항) 설명: 항목 유형의 목적을 설명합니다(예: '이 항목은 사용자가 채소를 언급할 때 트리거됩니다'). AI 생성을 사용하여 참조 값 동의어를 자동 생성하려는 경우 이 필드는 모델에서 더 높은 품질의 결과를 생성하는 데 사용됩니다.
개체 항목: 각 개체 유형에는 여러 개체 항목이 있을 수 있습니다. 각 항목 입력은 동일한 것으로 간주되는 일련의 단어 또는 문구, 첫 번째 열의 참조 값, 두 번째 열의 해당 참조 값에 대한 동의어를 제공합니다. 예를 들어 야채가 항목 유형인 경우 다음과 같은 항목 항목을 정의할 수 있습니다.
참조 값
동의어
봄양파
봄양파, 골파
피망
피망, 파프리카
당근
당근
감자
감자
항목 항목과 동의어를 수동으로 입력하는 대신 새 항목 항목을 만들 때 항목당 __ 동의어 자동 생성 체크박스를 선택할 수 있습니다. 기본값은 동의어 3개입니다. AI는 참조 값과 항목 유형 설명을 기반으로 동의어를 생성하고 테이블에 입력합니다. 동의어 목록에 원래 참조 값도 포함되어야 해당 값과 일치하는 결과가 나옵니다.
Dialogflow CX 콘솔에서 항목 유형을 편집할 때 화면의 각 행은 개체 항목입니다. API를 사용하는 경우 개체 항목이라는 용어는 Entity 유형(일부 클라이언트 라이브러리 언어의 경우 EntityType.Entity 또는 EntityType_Entity)을 나타냅니다.
항목 참조 값 및 동의어: 일부 항목 항목에는 위의 scallion 예시와 같이 동일한 것으로 간주되는 단어 또는 문구가 여러 개 있습니다.
이러한 항목 입력에는 참조 값과 하나 이상의 동의어를 제공합니다.
[[["이해하기 쉬움","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\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*."]]
