시작
Kore.ai 대화형 플랫폼
챗봇 개요
자연어 처리(NLP)
봇 개념 및 용어들
빠른 시작 가이드
봇 빌더 접근 방법
사용 고지 사항 (영어)
Kore.ai 봇 빌더로 작업하기
봇 구축 시작하기
릴리스 정보
현재 버전 (영어)
이전 버전 (영어)

개념
디자인
스토리보드
대화 작업
개요
Using the Dialog Builder Tool
노드 유형
사용자 의도 노드
대화 노드
엔티티 노드
양식 노드
확인 노드
서비스 노드
봇 조치 노드
Service Node
WebHook 노드
스크립트 노드
노드 그룹화하기
Agent Transfer Node
사용자 프롬프트
음성 통화 속성
대화 관리
노드 및 전환
구성 요소 전환
컨텍스트 개체
이벤트 기반 봇 조치
지식 그래프
소개
지식 추출
지식 그래프 생성
봇에 지식 그래프 추가
그래프 생성
지식 그래프 작성
FAQ 추가
작업 실행
기존 소스에서 FAQ 구축
특성, 동의어 및 불용어
변수 네임스페이스 관리
수정
용어 편집 및 삭제
용어 편집 및 삭제
질문과 응답 편집
Knowledge Graph Training
지식 그래프 분석
봇 온톨로지 가져오기 및 내보내기
지식 그래프 가져오기
지식 그래프 내보내기
지식 그래프 생성
CSV 파일에서
JSON 파일
지식 그래프 생성
경고 작업
스몰 토크
Digital Skills
디지털 양식
Views
Digital Views
Panels
Widgets
기차
봇 성능 향상 – NLP 최적화
기계 학습
소개
모델 검증
기초 의미
지식 그래프 학습
특성
순위 및 해결
고급 NLP 설정
NLP 설정 및 지침
봇 인텔리전스
소개
컨텍스트 관리
컨텍스트 관리
대화 관리
다중 – 의도 탐지
엔티티 수정
기본 대화
정서 관리
어조 분석
Test & Debug
봇과 대화
발화 테스트
배치 테스트하기
대화 테스트
배포
채널 활성화
봇 게시
분석
봇 분석하기
Conversations Dashboard
Performance Dashboard
사용자 정의 대시보드
소개
맞춤형 메타 태그
사용자 정의 대시보드 생성 방법
Conversation Flows
NLP 지표
Containment Metrics
사용량 지표
스마트 봇
소개
범용 봇
소개
범용 봇 정의
범용 봇 생성
범용 봇 학습
범용 봇 커스터마이징
범용 봇용 추가 언어 활성화
스토어
Manage Assistant
플랜 및 사용량
Overview
Usage Plans
Support Plans
플랜 관리
봇 인증
다국어 봇
개인 식별 정보 삭제하기
봇 변수 사용
IVR 통합
일반 설정
봇 관리

방법
간단한 봇 생성하기
Design Conversation Skills
뱅킹 봇 생성
뱅킹 봇 – 자금 이체
뱅킹 봇 – 잔액 업데이트
Knowledge Graph (KG) 구축
스마트 경고를 예약하는 방법
Design Digital Skills
디지털 양식 설정 방법
디지털 보기 설정 방법
데이터 테이블에 데이터를 추가하는 방법
데이터 테이블 내 데이터 업데이트 방법
UI 양식에서 데이터 테이블에 데이터를 추가하는 방법
Train the Assistant
특성 사용 방법
의도와 엔티티에 대한 패턴 사용 방법
컨텍스트 전환 관리 방법
Deploy the Assistant
상담사 전환을 설정하는 방법
봇 기능 사용 방법
콘텐츠 변수 사용 방법
전역 변수 사용 방법
Kore.ai 웹 SDK 튜토리얼
Kore.ai 위젯 SDK 튜토리얼
Analyze the Assistant
사용자 정의 대시보드 생성 방법
사용자 지정 태그를 사용하여 봇 메트릭을 필터링하는 방법

API 및 SDK
API 참조
Kore.ai API 사용
API 목록
API 컬렉션
koreUtil Libraries
SDK 참조
상담사 전환을 설정하는 방법
봇 기능 사용 방법
콘텐츠 변수 사용 방법
전역 변수 사용 방법
소개
Kore.ai 웹 SDK 튜토리얼
Kore.ai 위젯 SDK 튜토리얼

관리
소개
봇 관리자 콘솔
대시보드
사용자 관리
사용자 관리
그룹 관리
역할 관리
봇 관리 모듈
등록
사용자 초대
사용자 등록을 위한 대량 초대 보내기
사용자 및 사용자 데이터 가져오기
Active Directory에서 사용자 동기화
보안 및 준수
싱글 사인 온 사용
보안 설정
Kore.ai 커넥터
봇 관리자용 분석
Billing (지원하지 않음)
  1. Docs
  2. Virtual Assistants
  3. How Tos
  4. 엔티티 규칙

엔티티 규칙

이러한 값을 처리하기 전에 사용자 입력을 검증하는 것은 봇의 효율성과 사용자 경험을 개선하는 데 있어 장기간의 시간이 필요합니다. 엔티티 유형에 몇몇 기본 제한 사항이 적용되지만 이러한 제한 사항은 항상 충분하지 않으며 특정 비즈니스 요건을 충족하지 않습니다. 엔티티 규칙은 추가 처리 힌트 및 유효성 검사에 사용할 수 있습니다. 엔티티 규칙은 해당 엔티티의 인스턴스 속성 아래 엔티티 규칙 섹션에서 추가할 수 있습니다. 제공된 JSON 에디터에 규칙을 추가하고. 방법은 여기를 참조하세요. 이러한 규칙은 엔티티에 대한 스크립트에서 설정될 수도 있습니다. 이러한 경우 대화 흐름에서 엔티티 프롬프트 전에 규칙이 설정되어야 합니다. 다음 스크립트를 사용하여 대화의 시작 부분이나 관련 엔티티 노드 바로 앞에 스크립트 노드를 추가합니다:

context.entityRules.<entityName> = {
      "ruleName": "value"
   }

하위 엔티티 규칙은 복합 엔티티 규칙의 일부가 될 수 있습니다:

context.entityRules.<compositeEntityName> = {
    <subentityName> : { 
      "ruleName": "value"
     }
   }

다음은 필수 엔티티의 JSON 에디터에 입력되거나 위의 스크립트와 같이 ruleName으로 포함될 수 있는 엔티티 규칙입니다. 이 목록을 지속적으로 개선하고 업데이트하고 있습니다. 커뮤니티 포럼에 피드백 또는 제안 사항을 게시해 주시면 실현 가능할 경우 개발자들이 이를 수용하겠습니다.

일반 규칙

규칙 이름 설명
processLatestSentence true/false 현재 Volley의 문장으로만 검사를 제한합니다.
예시

{
 "processLatestSentence": <true/false>
}
patternsOnly true/false 엔티티 패턴에만 매칭하는 것을 제한합니다. 기본적으로 지정된 엔티티 패턴으로 인해 엔티티 값이 추출되지 않으면 플랫폼은 사용자 발화에서 값을 찾으려고 시도합니다. 이 규칙을 true로 설정하면 해당 기본 처리가 비활성화됩니다.
예시

{
"patternsOnly": <true/false>
}
allowConfirmation true/false 추출된 엔티티 값은 각 입력 후에 사용자에게 표시되며 흐름은 사용자가 확인한 후에만 지속됩니다. 현재 이 규칙은 LoV 열거된 엔티티 유형에만 적용할 수 있습니다.
예시

{
"allowConfirmation": <true/false>
}
confirmYesSynonyms <concept names> 엔티티 값을 확인하는 데 사용되는 추가 단어/구문 위에서 언급한 allowConfirmation 규칙과 함께 사용됩니다.
예시

{
"confirmYesSynonyms": ["~concept1", "~concept2"]
}

concept1: ok라면, concept2: affirmative

confirmNoSynonyms <concept names> 확인 엔티티를 취소하는 데 사용되는 추가 단어/구문입니다. 이 항목을 선택/발화하면 위에서 언급한 allowConfirmation 규칙과 함께 사용되는 엔티티 값이 null로 설정됩니다.
예시

{
"confirmNoSynonyms": ["~concept2", "~concept3"]
}

Concept1:nope이라면, concept2:wrong

문자열 유형 엔티티

설명 엔티티 유형

규칙 이름 설명
stripLeading <concept name> 추출된 문자열의 시작에서 콘셉트에 주어진 단어를 제거합니다. 콘셉트는 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{ "stripLeading": [ 
      "~stringConcept" 
    ]
}
stringConcept:  도시 엔티티 패턴: I like * 사용자 발화 "I like city New York" 추출된 값 New York
stripTrailing <concept name> 추출된 문자열의 끝에서 콘셉트의 단어를 제거합니다. 값은 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{ "stripTrailing":
    "~stringConcept ~stringConcept1"
 }
stringConcept:  도시; stringConcept1:  공항 엔티티 패턴: I like * 사용자 발화 "I ike New York city" 또는 "I like New York airport" 추출된 값 New York
avoidSingleWord <concept name> 전체 입력 값이 아니라면 콘셉트 멤버의 값을 무시합니다. 값은 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "avoidSingleWord": 
      "~stringConcept"
}
stringConcept:  체스, 크리켓 엔티티 패턴: like to watch * tournament 사용자 발화 "I like to watch chess tournament" 추출된 값 엔티티 값에 대한 표시 사용자 발화 "I like to watch golf tournament" 추출된 값 golf 사용자 발화cricket추출된 값 cricket(이것이 전체 입력값이기 때문)
avoidSingleVerb true true로 설정하면 전체 입력값이 아닌 경우 동사만 있는 값은 무시됩니다.
예시
JSON

{
"avoidSingleVerb": true
}
엔티티 패턴: I like * music 사용자 발화 "I like playing music" 추출된 값 엔티티 값에 대한 표시 사용자 발화 "I like rap music" 추출된 값 rap 사용자 발화 "play" 추출된 값 play(이것이 전체 입력값이기 때문)
extractOnlyNumbers true true인 경우 엔티티는 문자열의 숫자만 추출하고 이를 엔티티 값으로 설정합니다
예시
JSON

{
"extractOnlyNumbers": true
}

숫자 유형 엔티티

규칙 이름 설명
asString true 숫자를 문자열로 캡처하려면 맨 앞의 0을 유지합니다
예시
JSON

{
  "asString": true
}
엔티티 패턴 – 기본 숫자 입력값 사용자 발화 "OTP is 009944" 추출된 값 "009944"규칙이 없다면 "9944"가 추출됩니다.

통화 유형 엔티티

규칙 이름 설명
defaultCode <currency code> 또는 <country code> 사용자 입력에 언급된 코드가 없으면 이 값이 코드로 선택됩니다. 값은 3자로 된 통화 코드 또는 2자로 된 국가 알파벳 두 글자 코드여야 합니다.
예시
JSON

{
  "defaultCode": "NZD"
}
엔티티 패턴 pay * 사용자 발화 "Pay 30" 추출된 값 "NZD30" 사용자 발화 "Pay USD30" 추출된 값 "USD30"
maxDigits <number> 금액의 길이를 제한합니다. 금액의 길이가 값을 초과하면 삭제됩니다.
예시
JSON

{
  "maxDigits":[
    "3"
   ]
}
엔티티 패턴 pay * 사용자 발화"Pay USD30" 추출된 값 "USD30" 사용자 발화"Pay USD3000" 추출된 값 값에 대한 표시
currencyCodes [<currency code>,<currency code>] 또는 [<country code>,<country code>] 통화 코드를 제한합니다. 사용자가 입력한 코드가 주어진 목록에 없으면 값이 삭제됩니다.
예시
JSON

{
  "currencyCodes": [
    "USD",
    "INR",
    "NZD"
  ]
}
엔티티 패턴 pay * 사용자 발화"Pay USD30" 추출된 값 "USD30" 사용자 발화"Pay AUD30" 추출된 값 값에 대한 표시

PersonName 유형 엔티티

규칙 이름 설명
disablePatterns 무시할 사람 이름 패턴 배열 – 현재 "소유격"만 지원 특정 시나리오에 해당하지 않는다면 사람 이름을 추출할 때 패턴을 비활성화합니다.
예시
JSON

{
  "disablePatterns": [
    "possessive"
  ]
}
엔티티 패턴 – 기본 대문자 단어 사용자 발화 "schedule Bob's review at 9 am" 추출된 값 "Bob"
ignoreWords <concept name> 콘셉트에서 단어는 대문자로 된 경우에도 이름으로 간주되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "ignoreWords": [
    "review",
    "~prepositionList"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "meeting for Bob Review" 추출된 값 "Bob" 규칙이 없다면 "Bob Review"가 추출됩니다.
negativePatterns 패턴 배열 사람의 이름은 일반적인 대문자 단어이거나, 사람으로 받아들일 수 없는 의미로 사용할 수 있습니다.
예시
JSON

{
  "negativePatterns": [
    "about *"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "schedule a meeting about Philip with Fred" 추출된 값 "Fred" 규칙이 없다면 "Philip"이 추출됩니다.

회사 유형 엔티티

규칙 이름 설명
ignoreWords <concept name> 콘셉트에서 단어는 대문자로 된 경우에도 회사로 간주되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "ignoreWords": [
    "atm"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "find ATM" 추출된 값 없음 규칙이 없다면 "ATM" (이탈리아 회사)이 추출됩니다.
negativePatterns 무시할 회사 이름 패턴 배열입니다 특정 시나리오에 해당하지 않는다면 회사 이름을 추출할 때 패턴을 비활성화합니다.

날짜 유형 엔티티

규칙 이름 설명
range { “from” : <from-date>, “to” : <to-date> } 지정된 범위에 있는 날짜만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 될 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
"range": {
   "from": "2020-01-01",
   "to": "today"
  }
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "show schedule for 2019-02-03" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for tomorrow" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03" 추출된 값 "2020-02-03"
referenceDate <date> 참조 날짜를 <date>로 설정하고 해당 날짜에 따라 현재 날짜 엔티티 값이 설정되도록 날짜를 계산합니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 되어야 합니다.
예시
JSON

{
  "referenceDate": "2020-07-09"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "schedule after two days" 추출된 값 참조 날짜가 없다면 현재 날짜로부터 이틀 후인 "2020-07-11"
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "dd-mm-yyyy"
  • "mm-dd-yyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.
returnOnlyMonthYear <true/false> true로 설정하면 플랫폼은 사용자 입력에서 월 및 연도를 캡처하고 그에 따라 컨텍스트 객체를 업데이트합니다. 사용자가 전체 입력(예: 2019년 10월 20일)을 제공하더라도 시스템은 해당 입력에서 2019년 10월만 가져옵니다. 사용자가 날짜를 제공하지 않으면 해당 날짜를 입력하라는 메시지가 표시되지 않습니다
예시
JSON

{
  "returnOnlyMonthYear": true
}
사용자 발화 "03-04-2021" 추출된 값 " 04-2021 "사용자 발화 " Apr 2021" 추출된 값 "04-2021"

날짜 기간 유형 엔티티

규칙 이름 설명
range { “from” : <from-date>, “to” : <to-date> } 지정된 범위에 있는 날짜만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 될 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
"range": {
   "from": "2020-01-01",
   "to": "today"
  }
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "show schedule for 2019-02-03" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for tomorrow" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03" 추출된 값 "2020-02-03"
referenceDate <date> 참조 날짜를 <date>로 설정하고 해당 날짜에 따라 현재 날짜 엔티티 값이 설정되도록 날짜를 계산합니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 되어야 합니다.
예시
JSON

{
  "referenceDate": "2020-07-09"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "schedule after two days" 추출된 값 "2020-07-11"
tense past/future 사용자의 발화에 연도가 없을 때 시제에 따라 날짜 기간을 조정합니다. 이 규칙이 없으면 월/일이 현재 날짜로부터 90일 이내인 경우 연도가 현재 연도로 설정되고, 그렇지 않으면 이전 연도로 설정됩니다. 이 규칙을 사용하면 연도를 현재 또는 과거 연도에 적용할 수 있습니다.
예시
JSON

{
 "tense": "past"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "get the statement for Jan" 추출된 값 "2020-01-01" 현재 날짜가 "2020-15-12"라면 규칙이 없는 경우 "2021-01-01"가 추출됩니다.  
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "ddmmyyyy"
  • "mmddyyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.

DateTime 유형 엔티티

규칙 이름 설명
range { “from” : <from-datetime>, “to” : <to-datetime> } 지정된 범위에 있는 날짜-시간만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜(YYYY-MM-DD) 또는 날짜 시간(YYYY-MM-DDTHH:MM:SS(지정되지 않았다면 사용자의 시간대로 가정됨) 또는 오늘, 내일, 어제, 지금과 같은 키워드일 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
  "range": {
    "from": "2020-01-01T00:00:00+05:30",
    "to": "2020-10-01T00:00:00+05:30"
  }
}
엔티티 패턴 – 기본적으로 날짜 시간 패턴 사용자 발화 "set alarm for 2019-02-03T10:00:00" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2021-12-20T10:00:00" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03 T10:00:00" 추출된 값 "2020-02-03T10:00:00"
preferredTimes { “from” : <from-time>, “to” : <to-time> } 시간이 모호하다면 시간을 해석하는 데 사용할 수 있는 선호 시간을 설정합니다. 이러한 시간은 주중 모든 요일에 적용됩니다. 예를 들어, preferredTimes가 오전 9시에서 오후 6시인 경우 "3"은 "3 pm"이 됩니다. 시간을 범위 내에 넣을 수 없다면 가장 가까운 오전/오후를 선택합니다. 두 가지 가능성 또는 동일한 거리가 있는 경우 "주간/표준 기상" 시간이 사용됩니다. 시간은 ISO 8601 형식(THH:MM)이어야 합니다
{ “from” : [], “to” : [] } 이 옵션은 주중의 요일별로 선호하는 시간을 다르게 설정하기 위한 것입니다. "From" 및 "to" 키는 일요일부터 토요일까지 각 요일의 시간을 나타내는 7개의 멤버로 구성된 배열일 수 있습니다. 각각의 값은 기본 설정이 없음을 나타내기 위해 Thh:mm 형식이거나 빈 문자열이어야 합니다.
{ “favor” : <keyword> } "favor" 키워드는 "미래", "과거", "오전" 또는 "오후"의 측면에서 기본 설정을 설정하는 데 사용할 수 있습니다.
예시
JSON

 "preferredTimes": {
    "from": "T12:00:00",
    "to": "T18:00:00"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
JSON

 "preferredTimes": {
    "from": [
      "", "T09:00", 
      "T09:00", "T21:00", 
      "T21:00", "T07:00", ""
    ],
    "to": [
      "", "T18:00",
      "T18:00", "T06:00", 
      "T06:00", "T16:00", ""
    ]
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 , 현재 월요일/화요일/금요일이라면 "T15:00:00", 현재 수요일/목요일이라면 "T03:00:00"입니다.
JSON

 "preferredTimes": {
    "favor": "pm"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
timeRangePossible true/false true라면 대화는 사용자 입력의 시간 범위를 찾습니다. "10 ~ 4"의 해석에 영향을 줍니다. 기본적으로 이 값은 "3:50"이지만 범위를 지정할 수 있다면 "10:00" 및 "16:00"의 두 배로 디코딩됩니다.
예시
JSON

{
"timeRangePossible": "true"
}
   
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "ddmmyyyy"
  • "mmddyyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.

시간 유형 엔티티

규칙 이름 설명
preferredTimes { “from” : <from-time>, “to” : <to-time> } 시간이 모호하다면 시간을 해석하는 데 사용할 수 있는 선호 시간을 설정합니다. 이러한 시간은 주중 모든 요일에 적용됩니다. 예를 들어, preferredTimes가 오전 9시에서 오후 6시인 경우 "3"은 "3 pm"이 됩니다. 시간을 범위 내에 넣을 수 없다면 가장 가까운 오전/오후를 선택합니다. 두 가지 가능성 또는 동일한 거리가 있는 경우 "주간/표준 기상" 시간이 사용됩니다. 시간은 ISO 8601 형식(THH:MM)이어야 합니다
{ “from” : [], “to” : [] } 이 옵션은 주중의 요일별로 선호하는 시간을 다르게 설정하기 위한 것입니다. "From" 및 "to" 키는 일요일부터 토요일까지 각 요일의 시간을 나타내는 7개의 멤버로 구성된 배열일 수 있습니다. 각각의 값은 기본 설정이 없음을 나타내기 위해 Thh:mm 형식이거나 빈 문자열이어야 합니다.
{ “favor” : <keyword> } "favor" 키워드는 "미래", "과거", "오전" 또는 "오후"의 측면에서 기본 설정을 설정하는 데 사용할 수 있습니다.
예시
JSON

 "preferredTimes": {
    "from": "T12:00:00",
    "to": "T18:00:00"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
JSON

 "preferredTimes": {
    "from": [
      "", "T09:00", 
      "T09:00", "T21:00", 
      "T21:00", "T07:00", ""
    ],
    "to": [
      "", "T18:00",
      "T18:00", "T06:00", 
      "T06:00", "T16:00", ""
    ]
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 , 현재 월요일/화요일/금요일이라면 "T15:00:00", 현재 수요일/목요일이라면 "T03:00:00"입니다.
JSON

 "preferredTimes": {
    "favor": "pm"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
timeRangePossible true/false true라면 대화는 사용자 입력의 시간 범위를 찾습니다.
예시
JSON

{
"timeRangePossible": "true"
}
"10 ~ 4"와 같은 발화가 해석되는 방식에 영향을 줍니다. 기본적으로 이 값은 "3:50"이지만 범위를 지정할 수 있다면 "10:00" 및 "16:00"의 두 개의 개별 시간 값으로 디코딩됩니다.
range { “from” : now, } 또는 { “to” : now } 지정된 범위에 있는 날짜-시간만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 현재 지원은 "현재" 값으로만 확장됩니다
예시
JSON

{
  "range": {
    "from": now
  }
}

주소 유형 엔티티

규칙 이름 설명
geocode true/false 완전한 형식의 주소용입니다. true로 설정하면 주소가 좌표 지정 서비스(예: Google)를 사용하여 개별 부분으로 나뉩니다.
예시
JSON

{
  "geocode" : true
}
추출된 값 JSON 객체

{
  "text" : "",
  "geocode" : []
}

"text" 속성에는 좌표 지정되지 않은 양식이 사용되었다면 주소가 포함됩니다. "geocode" 속성에는 서비스의 수정되지 않은 결과가 포함됩니다(기본적으로 Google). 결과에서 원하는 어떤 요소든 추출하여 필요에 맞출 수 있습니다.

도시 유형 엔티티

규칙 이름 설명
ignoreWords <concept name> 콘셉트 내 단어들은 도시들로 고려되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열 또는 공백으로 구분된 문자열일 수 있습니다.
예시
JSON

{
  "ignoreWords": "Send"
}
엔티티 패턴 – 기본적으로 대문자 단어 사용자 발화 "Send destination to my email" 추출된 값 엔티티 값에 대한 표시, 규칙이 없다면 이것이 도시 이름이기 때문에 "Send"가 추출됩니다.

우편번호 유형 엔티티

규칙 이름 설명
preferredCountries [<“country1”>,<“country2”>,..] 사용자 위치 국가 및 입력에서 얻은 국가와 함께 주어진 선호 국가의 우편번호를 제한합니다. <“Country1”>,<“country2”> 등 대신 2자로 된 국가 알파벳 두 글자 코드를 추가해야 합니다.
예시
JSON

{
  "preferredCountries": [
    "GB"
  ]
}
엔티티 패턴 – 기본적으로 우편번호 패턴 사용자 발화 "check delivery to PO16 7GZ" 추출된 값 "PO16 7GZ", 이 규칙이 없다면 사용자가 UK 지역에 있지 않은 경우 이것은 무시됩니다.

위치 유형 엔티티

규칙 이름 설명
preferredCountries [<“country1”>,<“country2”>,..] 사용자 위치 국가 및 입력에서 얻은 국가와 함께 주어진 선호 국가의 위치를 제한합니다. <“Country1”>,<“country2”> 등 대신 2자로 된 국가 알파벳 두 글자 코드를 추가해야 합니다.
예시
JSON

{
  "preferredCountries": [
    "GB"
  ]
}

항목 목록(열거) 유형 엔티티

규칙 이름 설명
ownership include/ exclude 잠재적 "소유권" 파싱을 찾습니다.예: "is mine"으로 엔티티 값에서 잠재적 선택이 포함되어야 할지 제외되어야 할지 결정합니다 소유권 구문의 예로는 "is mine", "belongs to me" 등이 있습니다
예시
JSON

{
  "ownership": "include"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 ["pen", "watch"]
JSON

{
  "ownership": "exclude"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 규칙이 소유권 규칙에서 제외되었으므로 ["bottle", "book", "cap"]가 추출됩니다.
includeWords <concept name> 또는 단어의 배열 소유권 문구를 보완하는 단어 목록입니다. 값은 문자열 배열이나 콘셉트일 수 있습니다. 함께 사용하려면 소유권: 포함 규칙을 사용합니다.
예시
JSON

{
  "ownership": "include",
  "includeWords": "great"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 ["pen", "watch"] 사용자 발화 "first two are great" 추출된 값 ["pen", "watch"]
excludeWords <concept name> 또는 단어의 배열 소유권 없는 구문으로 사용할 수 있는 단어 목록입니다. 값은 문자열 배열 또는 콘셉트일 수 있습니다. 소유권: 제외 규칙과 함께 사용됩니다.
예시
JSON

{
  "ownership": "exclude",
   "excludeWords": "~lovConcept"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" lovConcept – 불확실함사용자 발화 "first two are dubious" 추출된 값 ["bottle", "book", "cap"]
noIndexMatch true 알파벳 및 숫자 색인 일치 비활성화는 사용자에게 색인을 사용하여 항목을 선택할 수 없도록 합니다.
예시
JSON

{
  "noIndexMatch": "true"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 a 추출된 값 입력값에 대한 표시, 규칙이 없다면 ["pen"]이 추출됩니다.

엔티티 규칙

이러한 값을 처리하기 전에 사용자 입력을 검증하는 것은 봇의 효율성과 사용자 경험을 개선하는 데 있어 장기간의 시간이 필요합니다. 엔티티 유형에 몇몇 기본 제한 사항이 적용되지만 이러한 제한 사항은 항상 충분하지 않으며 특정 비즈니스 요건을 충족하지 않습니다. 엔티티 규칙은 추가 처리 힌트 및 유효성 검사에 사용할 수 있습니다. 엔티티 규칙은 해당 엔티티의 인스턴스 속성 아래 엔티티 규칙 섹션에서 추가할 수 있습니다. 제공된 JSON 에디터에 규칙을 추가하고. 방법은 여기를 참조하세요. 이러한 규칙은 엔티티에 대한 스크립트에서 설정될 수도 있습니다. 이러한 경우 대화 흐름에서 엔티티 프롬프트 전에 규칙이 설정되어야 합니다. 다음 스크립트를 사용하여 대화의 시작 부분이나 관련 엔티티 노드 바로 앞에 스크립트 노드를 추가합니다:

context.entityRules.<entityName> = {
      "ruleName": "value"
   }

하위 엔티티 규칙은 복합 엔티티 규칙의 일부가 될 수 있습니다:

context.entityRules.<compositeEntityName> = {
    <subentityName> : { 
      "ruleName": "value"
     }
   }

다음은 필수 엔티티의 JSON 에디터에 입력되거나 위의 스크립트와 같이 ruleName으로 포함될 수 있는 엔티티 규칙입니다. 이 목록을 지속적으로 개선하고 업데이트하고 있습니다. 커뮤니티 포럼에 피드백 또는 제안 사항을 게시해 주시면 실현 가능할 경우 개발자들이 이를 수용하겠습니다.

일반 규칙

규칙 이름 설명
processLatestSentence true/false 현재 Volley의 문장으로만 검사를 제한합니다.
예시

{
 "processLatestSentence": <true/false>
}
patternsOnly true/false 엔티티 패턴에만 매칭하는 것을 제한합니다. 기본적으로 지정된 엔티티 패턴으로 인해 엔티티 값이 추출되지 않으면 플랫폼은 사용자 발화에서 값을 찾으려고 시도합니다. 이 규칙을 true로 설정하면 해당 기본 처리가 비활성화됩니다.
예시

{
"patternsOnly": <true/false>
}
allowConfirmation true/false 추출된 엔티티 값은 각 입력 후에 사용자에게 표시되며 흐름은 사용자가 확인한 후에만 지속됩니다. 현재 이 규칙은 LoV 열거된 엔티티 유형에만 적용할 수 있습니다.
예시

{
"allowConfirmation": <true/false>
}
confirmYesSynonyms <concept names> 엔티티 값을 확인하는 데 사용되는 추가 단어/구문 위에서 언급한 allowConfirmation 규칙과 함께 사용됩니다.
예시

{
"confirmYesSynonyms": ["~concept1", "~concept2"]
}

concept1: ok라면, concept2: affirmative

confirmNoSynonyms <concept names> 확인 엔티티를 취소하는 데 사용되는 추가 단어/구문입니다. 이 항목을 선택/발화하면 위에서 언급한 allowConfirmation 규칙과 함께 사용되는 엔티티 값이 null로 설정됩니다.
예시

{
"confirmNoSynonyms": ["~concept2", "~concept3"]
}

Concept1:nope이라면, concept2:wrong

문자열 유형 엔티티

설명 엔티티 유형

규칙 이름 설명
stripLeading <concept name> 추출된 문자열의 시작에서 콘셉트에 주어진 단어를 제거합니다. 콘셉트는 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{ "stripLeading": [ 
      "~stringConcept" 
    ]
}
stringConcept:  도시 엔티티 패턴: I like * 사용자 발화 "I like city New York" 추출된 값 New York
stripTrailing <concept name> 추출된 문자열의 끝에서 콘셉트의 단어를 제거합니다. 값은 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{ "stripTrailing":
    "~stringConcept ~stringConcept1"
 }
stringConcept:  도시; stringConcept1:  공항 엔티티 패턴: I like * 사용자 발화 "I ike New York city" 또는 "I like New York airport" 추출된 값 New York
avoidSingleWord <concept name> 전체 입력 값이 아니라면 콘셉트 멤버의 값을 무시합니다. 값은 단일 콘셉트 이름 또는 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "avoidSingleWord": 
      "~stringConcept"
}
stringConcept:  체스, 크리켓 엔티티 패턴: like to watch * tournament 사용자 발화 "I like to watch chess tournament" 추출된 값 엔티티 값에 대한 표시 사용자 발화 "I like to watch golf tournament" 추출된 값 golf 사용자 발화cricket추출된 값 cricket(이것이 전체 입력값이기 때문)
avoidSingleVerb true true로 설정하면 전체 입력값이 아닌 경우 동사만 있는 값은 무시됩니다.
예시
JSON

{
"avoidSingleVerb": true
}
엔티티 패턴: I like * music 사용자 발화 "I like playing music" 추출된 값 엔티티 값에 대한 표시 사용자 발화 "I like rap music" 추출된 값 rap 사용자 발화 "play" 추출된 값 play(이것이 전체 입력값이기 때문)
extractOnlyNumbers true true인 경우 엔티티는 문자열의 숫자만 추출하고 이를 엔티티 값으로 설정합니다
예시
JSON

{
"extractOnlyNumbers": true
}

숫자 유형 엔티티

규칙 이름 설명
asString true 숫자를 문자열로 캡처하려면 맨 앞의 0을 유지합니다
예시
JSON

{
  "asString": true
}
엔티티 패턴 – 기본 숫자 입력값 사용자 발화 "OTP is 009944" 추출된 값 "009944"규칙이 없다면 "9944"가 추출됩니다.

통화 유형 엔티티

규칙 이름 설명
defaultCode <currency code> 또는 <country code> 사용자 입력에 언급된 코드가 없으면 이 값이 코드로 선택됩니다. 값은 3자로 된 통화 코드 또는 2자로 된 국가 알파벳 두 글자 코드여야 합니다.
예시
JSON

{
  "defaultCode": "NZD"
}
엔티티 패턴 pay * 사용자 발화 "Pay 30" 추출된 값 "NZD30" 사용자 발화 "Pay USD30" 추출된 값 "USD30"
maxDigits <number> 금액의 길이를 제한합니다. 금액의 길이가 값을 초과하면 삭제됩니다.
예시
JSON

{
  "maxDigits":[
    "3"
   ]
}
엔티티 패턴 pay * 사용자 발화"Pay USD30" 추출된 값 "USD30" 사용자 발화"Pay USD3000" 추출된 값 값에 대한 표시
currencyCodes [<currency code>,<currency code>] 또는 [<country code>,<country code>] 통화 코드를 제한합니다. 사용자가 입력한 코드가 주어진 목록에 없으면 값이 삭제됩니다.
예시
JSON

{
  "currencyCodes": [
    "USD",
    "INR",
    "NZD"
  ]
}
엔티티 패턴 pay * 사용자 발화"Pay USD30" 추출된 값 "USD30" 사용자 발화"Pay AUD30" 추출된 값 값에 대한 표시

PersonName 유형 엔티티

규칙 이름 설명
disablePatterns 무시할 사람 이름 패턴 배열 – 현재 "소유격"만 지원 특정 시나리오에 해당하지 않는다면 사람 이름을 추출할 때 패턴을 비활성화합니다.
예시
JSON

{
  "disablePatterns": [
    "possessive"
  ]
}
엔티티 패턴 – 기본 대문자 단어 사용자 발화 "schedule Bob's review at 9 am" 추출된 값 "Bob"
ignoreWords <concept name> 콘셉트에서 단어는 대문자로 된 경우에도 이름으로 간주되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "ignoreWords": [
    "review",
    "~prepositionList"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "meeting for Bob Review" 추출된 값 "Bob" 규칙이 없다면 "Bob Review"가 추출됩니다.
negativePatterns 패턴 배열 사람의 이름은 일반적인 대문자 단어이거나, 사람으로 받아들일 수 없는 의미로 사용할 수 있습니다.
예시
JSON

{
  "negativePatterns": [
    "about *"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "schedule a meeting about Philip with Fred" 추출된 값 "Fred" 규칙이 없다면 "Philip"이 추출됩니다.

회사 유형 엔티티

규칙 이름 설명
ignoreWords <concept name> 콘셉트에서 단어는 대문자로 된 경우에도 회사로 간주되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열일 수 있습니다.
예시
JSON

{
  "ignoreWords": [
    "atm"
  ]
}
엔티티 패턴 – 정의에 따라 대문자 단어 사용자 발화 "find ATM" 추출된 값 없음 규칙이 없다면 "ATM" (이탈리아 회사)이 추출됩니다.
negativePatterns 무시할 회사 이름 패턴 배열입니다 특정 시나리오에 해당하지 않는다면 회사 이름을 추출할 때 패턴을 비활성화합니다.

날짜 유형 엔티티

규칙 이름 설명
range { “from” : <from-date>, “to” : <to-date> } 지정된 범위에 있는 날짜만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 될 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
"range": {
   "from": "2020-01-01",
   "to": "today"
  }
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "show schedule for 2019-02-03" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for tomorrow" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03" 추출된 값 "2020-02-03"
referenceDate <date> 참조 날짜를 <date>로 설정하고 해당 날짜에 따라 현재 날짜 엔티티 값이 설정되도록 날짜를 계산합니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 되어야 합니다.
예시
JSON

{
  "referenceDate": "2020-07-09"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "schedule after two days" 추출된 값 참조 날짜가 없다면 현재 날짜로부터 이틀 후인 "2020-07-11"
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "dd-mm-yyyy"
  • "mm-dd-yyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.
returnOnlyMonthYear <true/false> true로 설정하면 플랫폼은 사용자 입력에서 월 및 연도를 캡처하고 그에 따라 컨텍스트 객체를 업데이트합니다. 사용자가 전체 입력(예: 2019년 10월 20일)을 제공하더라도 시스템은 해당 입력에서 2019년 10월만 가져옵니다. 사용자가 날짜를 제공하지 않으면 해당 날짜를 입력하라는 메시지가 표시되지 않습니다
예시
JSON

{
  "returnOnlyMonthYear": true
}
사용자 발화 "03-04-2021" 추출된 값 " 04-2021 "사용자 발화 " Apr 2021" 추출된 값 "04-2021"

날짜 기간 유형 엔티티

규칙 이름 설명
range { “from” : <from-date>, “to” : <to-date> } 지정된 범위에 있는 날짜만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 될 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
"range": {
   "from": "2020-01-01",
   "to": "today"
  }
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "show schedule for 2019-02-03" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for tomorrow" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03" 추출된 값 "2020-02-03"
referenceDate <date> 참조 날짜를 <date>로 설정하고 해당 날짜에 따라 현재 날짜 엔티티 값이 설정되도록 날짜를 계산합니다. 값은 날짜, YYYY-MM-DD 또는 오늘, 내일, 어제 등의 키워드가 되어야 합니다.
예시
JSON

{
  "referenceDate": "2020-07-09"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "schedule after two days" 추출된 값 "2020-07-11"
tense past/future 사용자의 발화에 연도가 없을 때 시제에 따라 날짜 기간을 조정합니다. 이 규칙이 없으면 월/일이 현재 날짜로부터 90일 이내인 경우 연도가 현재 연도로 설정되고, 그렇지 않으면 이전 연도로 설정됩니다. 이 규칙을 사용하면 연도를 현재 또는 과거 연도에 적용할 수 있습니다.
예시
JSON

{
 "tense": "past"
}
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "get the statement for Jan" 추출된 값 "2020-01-01" 현재 날짜가 "2020-15-12"라면 규칙이 없는 경우 "2021-01-01"가 추출됩니다.  
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "ddmmyyyy"
  • "mmddyyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.

DateTime 유형 엔티티

규칙 이름 설명
range { “from” : <from-datetime>, “to” : <to-datetime> } 지정된 범위에 있는 날짜-시간만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 값은 날짜(YYYY-MM-DD) 또는 날짜 시간(YYYY-MM-DDTHH:MM:SS(지정되지 않았다면 사용자의 시간대로 가정됨) 또는 오늘, 내일, 어제, 지금과 같은 키워드일 수 있습니다. 날짜는 포함되어 있습니다.
예시
JSON

{
  "range": {
    "from": "2020-01-01T00:00:00+05:30",
    "to": "2020-10-01T00:00:00+05:30"
  }
}
엔티티 패턴 – 기본적으로 날짜 시간 패턴 사용자 발화 "set alarm for 2019-02-03T10:00:00" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2021-12-20T10:00:00" 추출된 값 값에 대해 표시 사용자 발화 "show schedule for 2020-02-03 T10:00:00" 추출된 값 "2020-02-03T10:00:00"
preferredTimes { “from” : <from-time>, “to” : <to-time> } 시간이 모호하다면 시간을 해석하는 데 사용할 수 있는 선호 시간을 설정합니다. 이러한 시간은 주중 모든 요일에 적용됩니다. 예를 들어, preferredTimes가 오전 9시에서 오후 6시인 경우 "3"은 "3 pm"이 됩니다. 시간을 범위 내에 넣을 수 없다면 가장 가까운 오전/오후를 선택합니다. 두 가지 가능성 또는 동일한 거리가 있는 경우 "주간/표준 기상" 시간이 사용됩니다. 시간은 ISO 8601 형식(THH:MM)이어야 합니다
{ “from” : [], “to” : [] } 이 옵션은 주중의 요일별로 선호하는 시간을 다르게 설정하기 위한 것입니다. "From" 및 "to" 키는 일요일부터 토요일까지 각 요일의 시간을 나타내는 7개의 멤버로 구성된 배열일 수 있습니다. 각각의 값은 기본 설정이 없음을 나타내기 위해 Thh:mm 형식이거나 빈 문자열이어야 합니다.
{ “favor” : <keyword> } "favor" 키워드는 "미래", "과거", "오전" 또는 "오후"의 측면에서 기본 설정을 설정하는 데 사용할 수 있습니다.
예시
JSON

 "preferredTimes": {
    "from": "T12:00:00",
    "to": "T18:00:00"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
JSON

 "preferredTimes": {
    "from": [
      "", "T09:00", 
      "T09:00", "T21:00", 
      "T21:00", "T07:00", ""
    ],
    "to": [
      "", "T18:00",
      "T18:00", "T06:00", 
      "T06:00", "T16:00", ""
    ]
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 , 현재 월요일/화요일/금요일이라면 "T15:00:00", 현재 수요일/목요일이라면 "T03:00:00"입니다.
JSON

 "preferredTimes": {
    "favor": "pm"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
timeRangePossible true/false true라면 대화는 사용자 입력의 시간 범위를 찾습니다. "10 ~ 4"의 해석에 영향을 줍니다. 기본적으로 이 값은 "3:50"이지만 범위를 지정할 수 있다면 "10:00" 및 "16:00"의 두 배로 디코딩됩니다.
예시
JSON

{
"timeRangePossible": "true"
}
   
preferredDateFormat "yyyy-mm-dd" 날짜가 모호하다면 선호하는 날짜 형식을 사용하여 모호성을 해결합니다. 값은 다음과 같을 수 있습니다:

  • "yyyy-mm-dd"
  • "yyyy-dd-mm"
  • "ddmmyyyy"
  • "mmddyyyy"
예시
JSON

{
  "preferredDateFormat": "mm-dd-yyyy"
}
사용자 발화 "03-04-2021" 추출된 값 "2021-03-04" 참고 사항: 이 규칙은 사용자의 발화에서 모호성이 있을 때만 나타납니다. 사용자의 기본 설정이 이전 대화의 일부로 이미 설정되어 있다면 사용자가 선택한 형식이 정의된 규칙보다 우선합니다. 예를 들어, 이전 활용 사례에 따라 사용자가 대화 중 "dd-mm-yyy"를 선호하는 형식으로 선택했다면 날짜는 "2021-04-03"으로 지정됩니다.

시간 유형 엔티티

규칙 이름 설명
preferredTimes { “from” : <from-time>, “to” : <to-time> } 시간이 모호하다면 시간을 해석하는 데 사용할 수 있는 선호 시간을 설정합니다. 이러한 시간은 주중 모든 요일에 적용됩니다. 예를 들어, preferredTimes가 오전 9시에서 오후 6시인 경우 "3"은 "3 pm"이 됩니다. 시간을 범위 내에 넣을 수 없다면 가장 가까운 오전/오후를 선택합니다. 두 가지 가능성 또는 동일한 거리가 있는 경우 "주간/표준 기상" 시간이 사용됩니다. 시간은 ISO 8601 형식(THH:MM)이어야 합니다
{ “from” : [], “to” : [] } 이 옵션은 주중의 요일별로 선호하는 시간을 다르게 설정하기 위한 것입니다. "From" 및 "to" 키는 일요일부터 토요일까지 각 요일의 시간을 나타내는 7개의 멤버로 구성된 배열일 수 있습니다. 각각의 값은 기본 설정이 없음을 나타내기 위해 Thh:mm 형식이거나 빈 문자열이어야 합니다.
{ “favor” : <keyword> } "favor" 키워드는 "미래", "과거", "오전" 또는 "오후"의 측면에서 기본 설정을 설정하는 데 사용할 수 있습니다.
예시
JSON

 "preferredTimes": {
    "from": "T12:00:00",
    "to": "T18:00:00"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
JSON

 "preferredTimes": {
    "from": [
      "", "T09:00", 
      "T09:00", "T21:00", 
      "T21:00", "T07:00", ""
    ],
    "to": [
      "", "T18:00",
      "T18:00", "T06:00", 
      "T06:00", "T16:00", ""
    ]
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 , 현재 월요일/화요일/금요일이라면 "T15:00:00", 현재 수요일/목요일이라면 "T03:00:00"입니다.
JSON

 "preferredTimes": {
    "favor": "pm"
  }
엔티티 패턴 – 기본적으로 날짜 패턴 사용자 발화 "remind me at 3" 추출된 값 "T15:00:00"
timeRangePossible true/false true라면 대화는 사용자 입력의 시간 범위를 찾습니다.
예시
JSON

{
"timeRangePossible": "true"
}
"10 ~ 4"와 같은 발화가 해석되는 방식에 영향을 줍니다. 기본적으로 이 값은 "3:50"이지만 범위를 지정할 수 있다면 "10:00" 및 "16:00"의 두 개의 개별 시간 값으로 디코딩됩니다.
range { “from” : now, } 또는 { “to” : now } 지정된 범위에 있는 날짜-시간만 추출합니다. 엔드포인트 중 하나는 선택 사항입니다. 현재 지원은 "현재" 값으로만 확장됩니다
예시
JSON

{
  "range": {
    "from": now
  }
}

주소 유형 엔티티

규칙 이름 설명
geocode true/false 완전한 형식의 주소용입니다. true로 설정하면 주소가 좌표 지정 서비스(예: Google)를 사용하여 개별 부분으로 나뉩니다.
예시
JSON

{
  "geocode" : true
}
추출된 값 JSON 객체

{
  "text" : "",
  "geocode" : []
}

"text" 속성에는 좌표 지정되지 않은 양식이 사용되었다면 주소가 포함됩니다. "geocode" 속성에는 서비스의 수정되지 않은 결과가 포함됩니다(기본적으로 Google). 결과에서 원하는 어떤 요소든 추출하여 필요에 맞출 수 있습니다.

도시 유형 엔티티

규칙 이름 설명
ignoreWords <concept name> 콘셉트 내 단어들은 도시들로 고려되지 않습니다. 콘셉트 이름은 단일 콘셉트 공백으로 구분된 콘셉트 목록 또는 콘셉트 이름의 배열 또는 공백으로 구분된 문자열일 수 있습니다.
예시
JSON

{
  "ignoreWords": "Send"
}
엔티티 패턴 – 기본적으로 대문자 단어 사용자 발화 "Send destination to my email" 추출된 값 엔티티 값에 대한 표시, 규칙이 없다면 이것이 도시 이름이기 때문에 "Send"가 추출됩니다.

우편번호 유형 엔티티

규칙 이름 설명
preferredCountries [<“country1”>,<“country2”>,..] 사용자 위치 국가 및 입력에서 얻은 국가와 함께 주어진 선호 국가의 우편번호를 제한합니다. <“Country1”>,<“country2”> 등 대신 2자로 된 국가 알파벳 두 글자 코드를 추가해야 합니다.
예시
JSON

{
  "preferredCountries": [
    "GB"
  ]
}
엔티티 패턴 – 기본적으로 우편번호 패턴 사용자 발화 "check delivery to PO16 7GZ" 추출된 값 "PO16 7GZ", 이 규칙이 없다면 사용자가 UK 지역에 있지 않은 경우 이것은 무시됩니다.

위치 유형 엔티티

규칙 이름 설명
preferredCountries [<“country1”>,<“country2”>,..] 사용자 위치 국가 및 입력에서 얻은 국가와 함께 주어진 선호 국가의 위치를 제한합니다. <“Country1”>,<“country2”> 등 대신 2자로 된 국가 알파벳 두 글자 코드를 추가해야 합니다.
예시
JSON

{
  "preferredCountries": [
    "GB"
  ]
}

항목 목록(열거) 유형 엔티티

규칙 이름 설명
ownership include/ exclude 잠재적 "소유권" 파싱을 찾습니다.예: "is mine"으로 엔티티 값에서 잠재적 선택이 포함되어야 할지 제외되어야 할지 결정합니다 소유권 구문의 예로는 "is mine", "belongs to me" 등이 있습니다
예시
JSON

{
  "ownership": "include"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 ["pen", "watch"]
JSON

{
  "ownership": "exclude"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 규칙이 소유권 규칙에서 제외되었으므로 ["bottle", "book", "cap"]가 추출됩니다.
includeWords <concept name> 또는 단어의 배열 소유권 문구를 보완하는 단어 목록입니다. 값은 문자열 배열이나 콘셉트일 수 있습니다. 함께 사용하려면 소유권: 포함 규칙을 사용합니다.
예시
JSON

{
  "ownership": "include",
  "includeWords": "great"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 "first two are mine" 추출된 값 ["pen", "watch"] 사용자 발화 "first two are great" 추출된 값 ["pen", "watch"]
excludeWords <concept name> 또는 단어의 배열 소유권 없는 구문으로 사용할 수 있는 단어 목록입니다. 값은 문자열 배열 또는 콘셉트일 수 있습니다. 소유권: 제외 규칙과 함께 사용됩니다.
예시
JSON

{
  "ownership": "exclude",
   "excludeWords": "~lovConcept"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" lovConcept – 불확실함사용자 발화 "first two are dubious" 추출된 값 ["bottle", "book", "cap"]
noIndexMatch true 알파벳 및 숫자 색인 일치 비활성화는 사용자에게 색인을 사용하여 항목을 선택할 수 없도록 합니다.
예시
JSON

{
  "noIndexMatch": "true"
}
입력 옵션 – 항목 선택: "pen", "watch", "bottle", "book", "cap" 사용자 발화 a 추출된 값 입력값에 대한 표시, 규칙이 없다면 ["pen"]이 추출됩니다.
메뉴