커스텀 항목

에이전트와 관련된 데이터와 일치시킬 커스텀 항목을 만들 수 있습니다. 예를 들어 식료품 가게 에이전트를 통해 구매 가능한 야채의 유형과 일치할 수 있는 vegetable 개체 유형을 정의할 수 있습니다.

커스텀 개체 만들기

커스텀 개체를 만들려면 다음 안내를 따르세요.

콘솔

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
항목 유형을 클릭합니다.
만들기를 클릭합니다.
개체 데이터를 입력합니다.
저장을 클릭합니다.

API

EntityType의 create 메서드를 사용합니다.

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	사용 불가능	해당 사항 없음

제한사항

다음과 같은 제한사항이 적용됩니다.

커스텀 항목 유형 표시 이름은 에이전트마다 고유합니다. 항목 유형 표시 이름은 문자로 시작해야 하며 A-Z, a-z, 0-9, _(밑줄), -(대시)를 포함할 수 있습니다. 항목 참조 및 동의어 값에는 이러한 제한이 없습니다.

커스텀 항목 내보내기 및 가져오기

항목을 내보내고 가져와 에이전트 간에 공유할 수 있습니다.

내보내기 형식 옵션 중 하나는 Json 패키지이며 디렉터리 및 JSON 파일의 계층 구조가 포함된 ZIP 파일입니다. 다음은 디렉터리 구조에 대한 설명입니다.

entityTypes: 이 디렉터리에는 항목 유형이 포함됩니다.
- <entity type name>: 이러한 디렉터리는 한 개 이상 있으며 디렉터리 이름은 항목 유형 표시 이름에 해당합니다.
  - entities: 이 디렉터리에는 항목 파일이 포함되어 있습니다.
    - <language tag>.json: 이러한 파일은 한 개 이상 있으며 파일 이름은 언어 태그에 해당합니다. 각 파일에는 언어별 항목이 포함되어 있습니다.
  - <excludedPhrases>: 이 디렉터리에는 제외된 구문 파일이 포함되어 있습니다.
    - <language tag>.json: 이러한 파일은 한 개 이상 있으며 파일 이름은 언어 태그에 해당합니다. 각 파일에는 언어별 구문 제외가 포함되어 있습니다.
  - <entity type name>.json: 이 파일 이름은 항목 유형 표시 이름에 해당합니다. 이 파일에는 다른 파일에 없는 항목 유형별 데이터가 포함되어 있습니다.

예를 들면 다음과 같습니다.

folder entityTypes
 ⤷ folder Entity Type A
    ⤷ folder entities
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ folder excludedPhrases
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ insert_drive_file Entity Type A.json
 ⤷ folder Entity Type B
    ⤷ folder entities
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ folder excludedPhrases
       ⤷ insert_drive_file en.json
       ⤷ insert_drive_file en-gb.json
       ⤷ insert_drive_file en-ca.json
    ⤷ insert_drive_file Entity Type B.json

항목 유형을 가져올 때 기존 에이전트에 있는 항목 유형의 표시 이름이 가져온 항목 유형의 표시 이름과 일치할 때 병합 충돌이 발생할 수 있습니다. 다음 중 하나를 선택하여 항목 유형 표시 이름이 일치할 때 병합 동작을 제어할 수 있습니다.

기존 항목 유형 바꾸기: 가져온 항목 유형이 기존 에이전트에서 이름이 같은 항목 유형을 덮어씁니다.
기존 항목 유형과 병합: 가져온 항목 유형의 항목이 기존 항목 유형에 추가됩니다. 동일한 항목이 있으면 중복되지 않고 그 아래에 있는 동의어가 병합됩니다.
이름 바꾸기 및 새 항목 유형으로 가져오기: 표시 이름에 '_1'을 추가하여 가져온 항목 유형의 이름을 변경합니다.
항목 유형 건너뛰기: 기존 항목 유형이 변경되지 않으며 가져온 항목 유형이 무시됩니다.

항목 유형을 내보내려면 다음 안내를 따르세요.

콘솔

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
항목 유형을 클릭합니다.
내보내려는 모든 항목 유형을 선택합니다.
선택한 항목 내보내기를 클릭합니다.
형식 및 목적지를 선택합니다.
제출을 클릭합니다.

항목 유형을 가져오려면 다음 안내를 따르세요.

콘솔

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
항목 유형을 클릭합니다.
가져오기를 클릭합니다.
소스 및 병합 동작을 선택합니다.
제출을 클릭합니다.

항목 가져오기

항목을 기존 항목 유형으로 가져올 수 있습니다.

항목을 가져오는 데 사용되는 파일 형식은 항목 유형을 가져오는 데 사용되는 형식과 동일합니다. 그러나 가져오기 파일에는 항목 유형이 1개만 포함될 수 있으며 그 아래에 있는 모든 항목을 선택한 항목 유형으로 가져오게 됩니다. 동일한 항목이 있으면 중복되지 않고 그 아래에 있는 동의어가 병합됩니다.

특정 항목 유형의 항목을 가져오려면 다음 안내를 따르세요.

콘솔

Dialogflow CX 콘솔을 엽니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
항목 유형을 클릭합니다.
항목을 선택합니다.
항목으로 가져오기를 클릭합니다.
파일을 선택하세요.
제출을 클릭합니다.

시스템 항목

세션 항목