항목 옵션

항목 일치 및 데이터 추출의 동작을 변경할 수 있는 다양한 항목 옵션이 있습니다. 이 옵션은 시스템 항목에 사전 구성되어 있으므로 시스템 항목에서는 이 옵션을 변경할 수 없습니다. 하지만 자체의 커스텀 항목에서는 변경할 수 있습니다. 선택한 옵션에 따라 다음과 같이 여러 종류의 항목을 만들 수 있습니다.

매핑 항목
목록 항목
복합 항목(특수한 종류의 목록 항목)
정규 표현식 항목

또한 항목의 종류를 결정하지는 않지만 항목 일치 동작에 영향을 주는 다른 옵션이 있습니다.

자동 확장
퍼지 일치
로그에서 수정
항목 제외

이 문서에서는 이러한 옵션을 각각 설명합니다.

이 데이터를 찾을 수 있는 위치

에이전트를 빌드할 때는 Dialogflow CX 콘솔을 사용하는 것이 가장 일반적입니다(문서 보기, 콘솔 열기). 아래의 안내는 콘솔 사용에 중점을 둡니다. 항목 옵션 데이터에 액세스하려면 다음 안내를 따르세요.

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
항목 유형을 클릭합니다.
기존 항목에 대해 다음 옵션을 참조하세요(일부는 고급 옵션을 확장한 후에만 표시될 수 있음).
- 항목만(동의어 없음)
- Regexp 항목
- 항목 자동 추가
- 퍼지 일치
- 로그에서 수정
- 항목 제외

콘솔 대신 API를 사용하여 에이전트를 빌드하는 경우 EntityType 유형을 확인하세요. API 필드 이름은 콘솔 필드 이름과 유사합니다. 아래 안내에서 콘솔과 API의 중요한 차이점을 볼 수 있습니다.

EntityType 참조의 프로토콜 및 버전 선택:

프로토콜	V3	V3beta1
REST	EntityType 리소스	EntityType 리소스
RPC	EntityType 인터페이스	EntityType 인터페이스
C++	EntityTypesClient	해당 사항 없음
C#	EntityTypesClient	해당 사항 없음
Go	EntityTypesClient	해당 사항 없음
자바	EntityTypesClient	EntityTypesClient
Node.js	EntityTypesClient	EntityTypesClient
PHP	없음	해당 사항 없음
Python	EntityTypesClient	EntityTypesClient
Ruby	없음	해당 사항 없음

매핑 항목

매핑 항목은 각 참조 값의 동의어에 참조 값의 매핑을 제공합니다. 각 매핑 항목에는 참조 값 하나와 동의어 목록이 포함됩니다. 원하는 경우 각 항목에 DTMF 패턴을 설정할 수도 있습니다.

예를 들어 다음 각 행은 size 항목 유형의 항목입니다.

항목	동의어	DTMF 패턴
S	S, small, tiny, little
M	M, medium, average
L	L, large, huge, big

참조 값은 위 각 항목의 동의어 목록에 포함되어 있습니다. 참조 값이 일치하려면 동의어로 포함되어야 합니다. 콘솔에서 처음에 참조 값을 입력하면 자동으로 동의어로 추가됩니다.

최종 사용자 입력 부분에서 특정 값이 일치하면 일치하는 연결된 참조 값이 추출되고 연결된 매개변수 값을 확인하는 데 사용됩니다.

동의어 목록에서 참조 값을 생략해도 괜찮습니다. 이는 최종 사용자 입력 부분과 일치하지 않지만 동의어 중 하나가 일치할 때 추출된 값으로 사용됨을 의미하며, 최종 사용자가 입력하거나 말하지 않은 참조 값에 특수 문자열을 사용할 때 좋습니다.

많은 시스템 항목이 매핑 항목입니다. 예를 들어 @sys.date 시스템 항목은 '2015년 1월 1일' 또는 '2015년 1월 첫째 날'과 같은 일반적인 날짜 입력과 일치합니다. 두 입력 모두 ISO-8601 형식의 참조 값 '2015-01-01T12:00:00-03:00'으로 매핑됩니다.

매핑 항목을 만들려면 다음 안내를 따르세요.

콘솔에서 정규 표현식 항목 옵션을 선택 해제하고 항목만 옵션을 선택 해제합니다.
API를 사용하여 EntityType.kind 필드를 KIND_MAP로 설정합니다.

목록 항목

목록 항목은 단일 값 항목의 목록을 제공합니다. 참조 값과 동의어는 없습니다. 예를 들어 다음 각 행은 material 항목 유형의 항목입니다.

값
천
목재
금속

최종 사용자 입력 부분에서 특정 값이 일치하면 일치하는 값이 추출되고 연결된 매개변수 값을 확인하는 데 사용됩니다.

많은 시스템 항목이 목록 항목입니다. 예를 들어 @sys.color 시스템 항목은 'red' 또는 'blue' 같은 일반적인 색상 입력과 일치합니다. 색상이 일치할 때 추출된 값은 참조 값에 매핑되지 않습니다. 예를 들어 'scarlet'이나 'crimson'과 같은 빨간색의 음영은 'red'에 매핑되지 않고 원래 값인 'scarlet' 및 'crimson'으로 추출됩니다.

목록 항목을 만들려면 다음 안내를 따르세요.

콘솔에서 정규 표현식 항목 옵션을 선택 해제하고 항목만 옵션을 선택합니다.
API를 사용하여 EntityType.kind 필드를 KIND_LIST로 설정합니다.

복합 항목

복합 항목은 특별한 종류의 목록 항목입니다. 목록 항목의 항목에는 일반적으로 간단한 단어나 구문이 포함되지만 다른 항목 유형이 포함될 수도 있습니다. 항목 유형이 다른 항목 유형에서 참조되는 경우 이러한 참조를 별칭이라 합니다. 목록 항목에 다른 항목 유형의 별칭이 포함되어 있으면 이를 복합 항목이라 합니다.

별칭을 만들 때는 참조되는 항목 유형의 이름과 선택한 속성 이름을 제공합니다. 런타임 시 복합 항목이 일치하면 추출된 값은 JSON 속성 이름으로 사용되는 별칭 속성 이름과 함께 JSON 객체로 반환됩니다. 별칭 입력 형식은 다음과 같습니다.

@entity-name:property-name

예를 들어 도시 또는 주를 다음 항목과 일치시키는 place 항목 유형을 만들 수 있습니다.

값
@sys.geo-city:city
@sys.geo-state:state

최종 사용자 입력에 'Nashville' 부분이 포함되어 있으면 place 항목 유형이 일치합니다. 추출된 값은 {"city": "Nashville"}로 반환됩니다.

항목 하나에서 항목 별칭을 여러 개 사용할 수도 있습니다. direction 항목 유형의 별칭과 @sys.number 시스템 항목 유형이 포함된 다음과 같은 move 커스텀 항목 유형이 있다고 가정해 보겠습니다.

경로 커스텀 매핑 항목 유형:

참조 값	동의어
forward	forward, forwards
back	back, backward, backwards

이동 커스텀 목록 항목 유형:

값
@sys.number:steps steps @direction:direction

move 항목이 'five steps backward'가 포함된 최종 사용자 입력과 일치하면 move 항목이 일치합니다. 추출된 값은 {"steps": 5, "direction": "back"}으로 반환됩니다.

많은 시스템 항목이 복합 항목입니다. 예를 들어 @sys.unit-currency 시스템 항목은 금액과 통화 이름을 일치시키는 데 사용됩니다. '50 euros' 또는 'twenty dollars and five cents'와 같은 최종 사용자 입력을 일치시킵니다. 추출된 값은 {"amount": 50, "currency": "EUR"}과 같은 JSON 객체로 반환됩니다.

정규 표현식 항목

정규 표현식 항목을 사용하면 일치를 위한 정규 표현식을 제공할 수 있습니다. 자세한 내용은 정규 표현식 항목을 참조하세요.

정규 표현식 항목을 만들려면 다음 안내를 따르세요.

콘솔에서 정규 표현식 항목 옵션을 선택합니다.
API를 사용하여 EntityType.kind 필드를 KIND_REGEXP로 설정합니다.

자동 확장(항목 자동 추가)

커스텀 항목 유형에 자동 확장을 사용 설정할 수 있습니다. 이 옵션을 사용 설정하면 에이전트에서 명시적으로 제공되지 않은 값을 인식할 수 있습니다. 예를 들어 다음과 같은 쇼핑 목록 항목 유형이 있다고 가정해 보겠습니다.

값
빵
butter
우유
사과
아이스크림

최종 사용자 입력이 'I need to buy some carrots'라면 제공되지 않더라도 'carrots'가 이 항목 유형에 일치합니다. 에이전트는 'carrots'가 다른 값과 문맥적으로 비슷함을 인식합니다.

자동 확장을 고려할 때는 다음 권장사항을 따라야 합니다.

자동 확장을 사용 설정한다고 해서 항목 추출이 보장되는 것은 아닙니다. 한정된 목록의 경우 부분 목록을 제공하는 대신 전체 목록을 제공하고 자동 확장을 사용 설정해야 합니다.
항목 두 개 이상에서 자동 확장을 사용 설정하면 충돌 및 예기치 않은 분류 결과가 발생할 수 있습니다.
우수한 매개변수 추출 품질을 보장하기 위해 예상 에이전트의 트래픽에서 특정 항목을 찾을 수 있는 모든 사용 사례를 포괄하는 다양한 학습 데이터를 제공하는 것이 중요합니다. 예시가 충분하지 않으면 자동 항목 확장이 예상대로 작동하지 않을 수 있습니다.

자동 확장을 사용 설정하려면 다음 안내를 따르세요.

콘솔에서 항목 자동 추가 옵션을 선택합니다.
API를 사용하여 EntityType.autoExpansionMode 필드를 AUTO_EXPANSION_MODE_DEFAULT로 설정합니다.

퍼지 일치

커스텀 항목에 퍼지 일치를 사용 설정할 수 있습니다. 퍼지 일치를 사용 설정하면 값이나 동의어에서의 단어 순서가 중요하지 않게 됩니다. 자세한 내용은 퍼지 일치를 참조하세요.

퍼지 일치를 사용 설정하려면 다음 안내를 따르세요.

콘솔에서 퍼지 일치 옵션을 선택합니다.
API를 사용하여 EntityType.enableFuzzyExtraction 필드를 true로 설정합니다.

로그에서 수정

항목 수정을 사용 설정하면 항목 유형에 대한 모든 런타임 추출 매개변수 값이 로깅 시 수정됩니다.

또는 개별 매개변수를 수정해도 됩니다.

항목 제외

일치하지 않아야 하는 구문인 항목 제외를 추가할 수 있습니다. 예를 들어 항목 giant(형용사)가 있는 크기 항목 유형이 있는 경우 giants(명사)를 제외로 추가하는 것을 고려해 보세요.

항목

시스템 개체