GETTING STARTED
Kore.ai XO Platform
Virtual Assistants Overview
Natural Language Processing (NLP)
Concepts and Terminology
Quick Start Guide
Accessing the Platform
Navigating the Kore.ai XO Platform
Building a Virtual Assistant
Help & Learning Resources
Release Notes
Current Version
Recent Updates
Previous Versions
Deprecations
Request a Feature
CONCEPTS
Design
Storyboard
Overview
FAQs
Conversation Designer
Overview
Dialog Tasks
Mock Scenes
Dialog Tasks
Overview
Navigate Dialog Tasks
Build Dialog Tasks
Node Types
Overview
Intent Node
Dialog Node
Dynamic Intent Node
GenAI Node
GenAI Prompt
Entity Node
Form Node
Confirmation Node
Message Nodes
Logic Node
Bot Action Node
Service Node
Webhook Node
Script Node
Process Node
Agent Transfer
Node Connections
Node Connections Setup
Sub-Intent Scoping
Entity Types
Entity Rules
User Prompts or Messages
Voice Call Properties
Knowledge AI
Introduction
Knowledge Graph
Introduction
Terminology
Build a Knowledge Graph
Manage FAQs
Knowledge Extraction
Import or Export Knowledge Graph
Prepare Data for Import
Importing Knowledge Graph
Exporting Knowledge Graph
Auto-Generate Knowledge Graph
Knowledge Graph Analysis
Answer from Documents
Alert Tasks
Small Talk
Digital Skills
Overview
Digital Forms
Digital Views
Introduction
Widgets
Panels
Session and Context Variables
Context Object
Intent Discovery
Train
NLP Optimization
ML Engine
Overview
Model Validation
FM Engine
KG Engine
Traits Engine
Ranking and Resolver
Training Validations
NLP Configurations
NLP Guidelines
LLM and Generative AI
Introduction
LLM Integration
Kore.ai XO GPT Module
Prompts & Requests Library
Co-Pilot Features
Dynamic Conversations Features
Intelligence
Introduction
Event Handlers
Contextual Memory
Contextual Intents
Interruption Management
Multi-intent Detection
Amending Entities
Default Conversations
Conversation Driven Dialog Builder
Sentinment Management
Tone Analysis
Default Standard Responses
Ignore Words & Field Memory
Test & Debug
Overview
Talk to Bot
Utterance Testing
Batch Testing
Conversation Testing
Conversation Testing Overview
Create a Test Suite
Test Editor
Test Case Assertion
Test Case Execution Summary
Glossary
Health and Monitoring
NLP Health
Flow Health
Integrations
Actions
Actions Overview
Asana
Configure
Templates
Azure OpenAI
Configure
Templates
BambooHR
Configure
Templates
Bitly
Configure
Templates
Confluence
Configure
Templates
DHL
Configure
Templates
Freshdesk
Configure
Templates
Freshservice
Configure
Templates
Google Maps
Configure
Templates
Here
Configure
Templates
HubSpot
Configure
Templates
JIRA
Configure
Templates
Microsoft Graph
Configure
Templates
Open AI
Configure
Templates
Salesforce
Configure
Templates
ServiceNow
Configure
Templates
Stripe
Configure
Templates
Shopify
Configure
Templates
Twilio
Configure
Templates
Zendesk
Configure
Templates
Agents
Agent Transfer Overview
Custom (BotKit)
Drift
Genesys
Intercom
NiceInContact
NiceInContact(User Hub)
Salesforce
ServiceNow
Configure Tokyo and Lower versions
Configure Utah and Higher versions
Unblu
External NLU Adapters
Overview
Dialogflow Engine
Test and Debug
Deploy
Channels
Publishing
Versioning
Analyze
Introduction
Dashboard Filters
Overview Dashboard
Conversations Dashboard
Users Dashboard
Performance Dashboard
Custom Dashboards
Introduction
Custom Meta Tags
Create Custom Dashboard
Create Custom Dashboard Filters
LLM and Generative AI Logs
NLP Insights
Task Execution Logs
Conversations History
Conversation Flows
Conversation Insights
Feedback Analytics
Usage Metrics
Containment Metrics
Universal Bots
Introduction
Universal Bot Definition
Universal Bot Creation
Training a Universal Bot
Universal Bot Customizations
Enabling Languages
Store
Manage Assistant
Team Collaboration
Plan & Usage
Overview
Usage Plans
Templates
Support Plans
Invoices
Authorization
Conversation Sessions
Multilingual Virtual Assistants
Get Started
Supported Components & Features
Manage Languages
Manage Translation Services
Multiingual Virtual Assistant Behavior
Feedback Survey
Masking PII Details
Variables
Collections
IVR Settings
General Settings
Assistant Management
Manage Namespace
Data
Overview
Data Table
Table Views
App Definitions
Data as Service
HOW TOs
Build a Travel Planning Assistant
Travel Assistant Overview
Create a Travel Virtual Assistant
Design Conversation Skills
Create an ‘Update Booking’ Task
Create a Change Flight Task
Build a Knowledge Graph
Schedule a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Train the Assistant
Use Traits
Use Patterns
Manage Context Switching
Deploy the Assistant
Use Bot Functions
Use Content Variables
Use Global Variables
Use Web SDK
Build a Banking Assistant
Design Conversation Skills
Create a Sample Banking Assistant
Create a Transfer Funds Task
Create a Update Balance Task
Create a Knowledge Graph
Set Up a Smart Alert
Design Digital Skills
Configure Digital Forms
Configure Digital Views
Add Data to Data Tables
Update Data in Data Tables
Add Data from Digital Forms
Train the Assistant
Composite Entities
Use Traits
Use Patterns for Intents & Entities
Manage Context Switching
Deploy the Assistant
Configure an Agent Transfer
Use Assistant Functions
Use Content Variables
Use Global Variables
Intent Scoping using Group Node
Analyze the Assistant
Create a Custom Dashboard
Use Custom Meta Tags in Filters
Migrate External Bots
Google Dialogflow Bot
APIs & SDKs
API Reference
API Introduction
Rate Limits
API List
koreUtil Libraries
SDK Reference
SDK Introduction
Web SDK
How the Web SDK Works
SDK Security
SDK Registration
Web Socket Connect and RTM
Tutorials
Widget SDK Tutorial
Web SDK Tutorial
BotKit SDK
BotKit SDK Deployment Guide
Installing the BotKit SDK
Using the BotKit SDK
SDK Events
SDK Functions
Tutorials
BotKit - Blue Prism
BotKit - Flight Search Sample VA
BotKit - Agent Transfer
  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"]이 추출됩니다.
메뉴