에이전트와 관련된 데이터와 일치시킬 커스텀 항목을 만들 수 있습니다.
예를 들어 식료품 가게 에이전트를 통해 구매 가능한 야채의 유형과 일치할 수 있는 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
: 이 파일 이름은 항목 유형 표시 이름에 해당합니다. 이 파일에는 다른 파일에 없는 항목 유형별 데이터가 포함되어 있습니다.
예를 들면 다음과 같습니다.
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'을 추가하여 가져온 항목 유형의 이름을 변경합니다.
- 항목 유형 건너뛰기: 기존 항목 유형이 변경되지 않으며 가져온 항목 유형이 무시됩니다.
항목 유형을 내보내려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 항목 유형을 클릭합니다.
- 내보내려는 모든 항목 유형을 선택합니다.
- 선택한 항목 내보내기를 클릭합니다.
- 형식 및 목적지를 선택합니다.
- 제출을 클릭합니다.
항목 유형을 가져오려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 항목 유형을 클릭합니다.
- 가져오기를 클릭합니다.
- 소스 및 병합 동작을 선택합니다.
- 제출을 클릭합니다.
항목 가져오기
항목을 기존 항목 유형으로 가져올 수 있습니다.
항목을 가져오는 데 사용되는 파일 형식은 항목 유형을 가져오는 데 사용되는 형식과 동일합니다. 그러나 가져오기 파일에는 항목 유형이 1개만 포함될 수 있으며 그 아래에 있는 모든 항목을 선택한 항목 유형으로 가져오게 됩니다. 동일한 항목이 있으면 중복되지 않고 그 아래에 있는 동의어가 병합됩니다.
특정 항목 유형의 항목을 가져오려면 다음 안내를 따르세요.
콘솔
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 항목 유형을 클릭합니다.
- 항목을 선택합니다.
- 항목으로 가져오기를 클릭합니다.
- 파일을 선택하세요.
- 제출을 클릭합니다.