커스텀 항목

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

커스텀 개체 만들기

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

콘솔

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

API

EntityTypecreate 메서드를 사용합니다.

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: 이 파일 이름은 항목 유형 표시 이름에 해당합니다. 이 파일에는 다른 파일에 없는 항목 유형별 데이터가 포함되어 있습니다.

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

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

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

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

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

콘솔

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

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

콘솔

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

항목 가져오기

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

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

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

콘솔

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