시작
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. API Guide
  4. 의도 API 찾기

의도 API 찾기

의도 인식 결과와 NLP 및 ML 엔진의 점수를 모두 매겨줍니다.

이 API를 사용하려면 앱은 의도 및 입력 감지의 봇 빌더 API 범위가 필요합니다.

POST https://{{host}}/api/v1.1/rest/bot/{{BotID}}/findIntent?fetchConfiguredTasks=false

쿼리 매개 변수

매개 변수 설명
host 환경 URL(예: https://bots.kore.ai)
BotID 봇 ID입니다. 봇의 일반 설정 페이지에서 이를 액세스할 수 있습니다.
fetchConfiguredTasks 봇에 설정된 작업에서 의도를 가져오려면 이고 게시된 작업에 대해서만 가져오려면 거짓 입니다.

본문 매개 변수

매개 변수 설명
parentIntent 다중 의도 모델을 지원합니다.
input 일치하는 의도를 찾기 위한 사용자 발화 예: 작업 생성
streamName 일치하는 의도를 찾기 위한 사용자 발화 예: 작업 생성 참고 사항: 3,000자를 초과하는 길이의 긴 발화는 허용되지 않습니다.

권한 부여

다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}

봇 언어

선택적으로 봇에 대해 다중 언어를 사용하도록 설정한 경우, 봇 언어 헤더를 en, zh_cn 등의 언어 코드와 함께 전달해야 합니다. 다국어 봇에 언어 코드가 전달되지 않았다면 봇의 기본 언어가 고려됩니다. bot-header: {{lang-code}}

콘텐츠 유형 응답

application/json

샘플 요청

curl -X POST \
  'https://{{host}}/api/v1.1/rest/bot/{{BotID}}/findIntent?fetchConfiguredTasks=false' \
  -H "Content-Type:application/json" \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}'\ 
  -H "bot-language:{{lang-code}}" \
  -d '{
     "parentIntent": "{{parent intent}}",
     "input": "{{user utterance}}",
     "streamName": "{{bot name}}"
   }'

샘플 응답

{
    "request": {
        "input": "book a ticket",
        "streamName": "Public APIs"
    },
    "response": {
        "usedtime": 313,
        "debugTitle": "Intent Match Successful: 'Book a ticket'",
        "result": "successintent",
        "messageStoreId": "xxx",
        "bot": "Public APIs",
        "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
        "task": "Book a ticket",
        "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
        "intentStatus": "published",
        "subType": "dialog",
        "input": [
            "book a ticket"
        ],
        "identifiedVia": "cs em",
        "language": "en",
        "userId": "u-5dad2ccd-b271-5c00-a338-2e6e25e1ec91",
        "time": "2019-06-27T11:48:28.250Z",
        "_id": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
        "traits": {},
        "toneAnalysis": {},
        "nlProcessing": {
            "originalInput": "book a ticket",
            "canonical": "book a ticket",
            "wordAnalysis": [
                {
                    "word": "book",
                    "ignored": false,
                    "pos": "Verb_infinitive ",
                    "role": "MAINVERB ",
                    "original": "book",
                    "processedWord": "book"
                },
                {
                    "word": "a",
                    "ignored": true,
                    "pos": "Determiner ",
                    "original": "a",
                    "processedWord": "a"
                },
                {
                    "word": "ticket",
                    "ignored": false,
                    "pos": "Noun_singular ",
                    "role": "MAINOBJECT ",
                    "original": "ticket",
                    "processedWord": "ticket"
                }
            ]
        },
        "ml": {
            "namedEntityRecognition": []
        },
        "fm": {
            "definitive": [
                {
                    "count": 2,
                    "score": 11643.33,
                    "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
                    "botname": "Public APIs",
                    "activity": "Book a ticket",
                    "activityType": 1,
                    "exactcount": 2,
                    "labelsize": 2,
                    "ignorewords": 1,
                    "mask": 66306,
                    "words": {
                        "book": [
                            "0-1"
                        ],
                        "ticket": [
                            "0-3"
                        ]
                    },
                    "priority": 2,
                    "tense": 8192,
                    "mainRoles": 10,
                    "sentencelength": 3,
                    "ignorewordlist": {
                        "a": 1
                    },
                    "maskEntity": 66306,
                    "firstwordmatch": "book",
                    "details": {
                        "0": {
                            "1": {
                                "labelword": "book",
                                "inputwords": {
                                    "1": "book"
                                },
                                "wordindex": [
                                    1
                                ],
                                "foundexact": true,
                                "bestwordindex": 1,
                                "role": 2,
                                "pos": 2200096997376,
                                "tense": 8192,
                                "ageLevel": 1,
                                "commonness": 6
                            },
                            "2": {
                                "labelword": "ticket",
                                "inputwords": {
                                    "3": "ticket"
                                },
                                "wordindex": [
                                    3
                                ],
                                "foundexact": true,
                                "bestwordindex": 3,
                                "role": 8,
                                "pos": 2147483680,
                                "tense": 8192,
                                "ageLevel": 1,
                                "commonness": 5
                            }
                        }
                    },
                    "hasNoun": true,
                    "hasVerb": true,
                    "ageLevel": 1,
                    "foundFmEngine": true,
                    "scoreBreakdown": {
                        "wordMatch": 500,
                        "exactWords": 60,
                        "coverage": 2000,
                        "sentenceBonus": 4000,
                        "positionBonus": 733.33,
                        "orderBonus": 100,
                        "spreadBonus": 800,
                        "roleBonus": 2900,
                        "faqQuestionBonus": 0,
                        "mlMatchBonus": 0,
                        "tasktypeBonus": 50,
                        "matchBonus": 500,
                        "phraseJoinPenalty": 0
                    },
                    "matchType": "definite",
                    "task": "Book a ticket",
                    "state": "published",
                    "foundVia": "wordMatch"
                }
            ]
        },
        "finalResolver": {
            "ranking": [
                {
                    "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
                    "intent": "Book a ticket",
                    "activityType": "dialog",
                    "state": "published",
                    "totalScore": 11643.33,
                    "scoring": {
                        "count": 2,
                        "score": 11643.33,
                        "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
                        "botname": "Public APIs",
                        "activity": "Book a ticket",
                        "activityType": 1,
                        "exactcount": 2,
                        "labelsize": 2,
                        "ignorewords": 1,
                        "mask": 66306,
                        "words": {
                            "book": [
                                "0-1"
                            ],
                            "ticket": [
                                "0-3"
                            ]
                        },
                        "priority": 10,
                        "tense": 8192,
                        "mainRoles": 10,
                        "sentencelength": 3,
                        "ignorewordlist": {
                            "a": 1
                        },
                        "maskEntity": 66306,
                        "firstwordmatch": "book",
                        "details": {
                            "0": {
                                "1": {
                                    "labelword": "book",
                                    "inputwords": {
                                        "1": "book"
                                    },
                                    "wordindex": [
                                        1
                                    ],
                                    "foundexact": true,
                                    "bestwordindex": 1,
                                    "role": 2,
                                    "pos": 2200096997376,
                                    "tense": 8192,
                                    "ageLevel": 1,
                                    "commonness": 6
                                },
                                "2": {
                                    "labelword": "ticket",
                                    "inputwords": {
                                        "3": "ticket"
                                    },
                                    "wordindex": [
                                        3
                                    ],
                                    "foundexact": true,
                                    "bestwordindex": 3,
                                    "role": 8,
                                    "pos": 2147483680,
                                    "tense": 8192,
                                    "ageLevel": 1,
                                    "commonness": 5
                                }
                            }
                        },
                        "hasNoun": true,
                        "hasVerb": true,
                        "ageLevel": 1,
                        "foundFmEngine": true,
                        "scoreBreakdown": {
                            "wordMatch": 500,
                            "exactWords": 60,
                            "coverage": 2000,
                            "sentenceBonus": 4000,
                            "positionBonus": 733.33,
                            "orderBonus": 100,
                            "spreadBonus": 800,
                            "roleBonus": 2900,
                            "faqQuestionBonus": 0,
                            "mlMatchBonus": 0,
                            "tasktypeBonus": 50,
                            "matchBonus": 500,
                            "phraseJoinPenalty": 0
                        },
                        "matchType": "definite",
                        "csMatch": true
                    },
                    "identifyingEngines": {
                        "fm": true
                    },
                    "csMatch": true,
                    "intentMatchVia": "wordMatch"
                }
            ],
            "userInput": "book a ticket",
            "winningIntent": [
                {
                    "intent": "Book a ticket",
                    "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
                    "activityType": "dialog",
                    "state": "published",
                    "score": 11643.33
                }
            ],
            "entities": []
        }
    },
    "streamId": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
    "streamName": "Public APIs",
    "seqLogId": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
    "_id": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
    "name": "Public APIs",
    "input": [
        "book a ticket"
    ]
}

의도 API 찾기

의도 인식 결과와 NLP 및 ML 엔진의 점수를 모두 매겨줍니다.

이 API를 사용하려면 앱은 의도 및 입력 감지의 봇 빌더 API 범위가 필요합니다.

POST https://{{host}}/api/v1.1/rest/bot/{{BotID}}/findIntent?fetchConfiguredTasks=false

쿼리 매개 변수

매개 변수 설명
host 환경 URL(예: https://bots.kore.ai)
BotID 봇 ID입니다. 봇의 일반 설정 페이지에서 이를 액세스할 수 있습니다.
fetchConfiguredTasks 봇에 설정된 작업에서 의도를 가져오려면 이고 게시된 작업에 대해서만 가져오려면 거짓 입니다.

본문 매개 변수

매개 변수 설명
parentIntent 다중 의도 모델을 지원합니다.
input 일치하는 의도를 찾기 위한 사용자 발화 예: 작업 생성
streamName 일치하는 의도를 찾기 위한 사용자 발화 예: 작업 생성 참고 사항: 3,000자를 초과하는 길이의 긴 발화는 허용되지 않습니다.

권한 부여

다음 구문을 포함한 헤더에 JWT를 포함한 API를 호출합니다. auth: {{JWT}}

봇 언어

선택적으로 봇에 대해 다중 언어를 사용하도록 설정한 경우, 봇 언어 헤더를 en, zh_cn 등의 언어 코드와 함께 전달해야 합니다. 다국어 봇에 언어 코드가 전달되지 않았다면 봇의 기본 언어가 고려됩니다. bot-header: {{lang-code}}

콘텐츠 유형 응답

application/json

샘플 요청

curl -X POST \
  'https://{{host}}/api/v1.1/rest/bot/{{BotID}}/findIntent?fetchConfiguredTasks=false' \
  -H "Content-Type:application/json" \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}'\ 
  -H "bot-language:{{lang-code}}" \
  -d '{
     "parentIntent": "{{parent intent}}",
     "input": "{{user utterance}}",
     "streamName": "{{bot name}}"
   }'

샘플 응답

{
    "request": {
        "input": "book a ticket",
        "streamName": "Public APIs"
    },
    "response": {
        "usedtime": 313,
        "debugTitle": "Intent Match Successful: 'Book a ticket'",
        "result": "successintent",
        "messageStoreId": "xxx",
        "bot": "Public APIs",
        "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
        "task": "Book a ticket",
        "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
        "intentStatus": "published",
        "subType": "dialog",
        "input": [
            "book a ticket"
        ],
        "identifiedVia": "cs em",
        "language": "en",
        "userId": "u-5dad2ccd-b271-5c00-a338-2e6e25e1ec91",
        "time": "2019-06-27T11:48:28.250Z",
        "_id": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
        "traits": {},
        "toneAnalysis": {},
        "nlProcessing": {
            "originalInput": "book a ticket",
            "canonical": "book a ticket",
            "wordAnalysis": [
                {
                    "word": "book",
                    "ignored": false,
                    "pos": "Verb_infinitive ",
                    "role": "MAINVERB ",
                    "original": "book",
                    "processedWord": "book"
                },
                {
                    "word": "a",
                    "ignored": true,
                    "pos": "Determiner ",
                    "original": "a",
                    "processedWord": "a"
                },
                {
                    "word": "ticket",
                    "ignored": false,
                    "pos": "Noun_singular ",
                    "role": "MAINOBJECT ",
                    "original": "ticket",
                    "processedWord": "ticket"
                }
            ]
        },
        "ml": {
            "namedEntityRecognition": []
        },
        "fm": {
            "definitive": [
                {
                    "count": 2,
                    "score": 11643.33,
                    "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
                    "botname": "Public APIs",
                    "activity": "Book a ticket",
                    "activityType": 1,
                    "exactcount": 2,
                    "labelsize": 2,
                    "ignorewords": 1,
                    "mask": 66306,
                    "words": {
                        "book": [
                            "0-1"
                        ],
                        "ticket": [
                            "0-3"
                        ]
                    },
                    "priority": 2,
                    "tense": 8192,
                    "mainRoles": 10,
                    "sentencelength": 3,
                    "ignorewordlist": {
                        "a": 1
                    },
                    "maskEntity": 66306,
                    "firstwordmatch": "book",
                    "details": {
                        "0": {
                            "1": {
                                "labelword": "book",
                                "inputwords": {
                                    "1": "book"
                                },
                                "wordindex": [
                                    1
                                ],
                                "foundexact": true,
                                "bestwordindex": 1,
                                "role": 2,
                                "pos": 2200096997376,
                                "tense": 8192,
                                "ageLevel": 1,
                                "commonness": 6
                            },
                            "2": {
                                "labelword": "ticket",
                                "inputwords": {
                                    "3": "ticket"
                                },
                                "wordindex": [
                                    3
                                ],
                                "foundexact": true,
                                "bestwordindex": 3,
                                "role": 8,
                                "pos": 2147483680,
                                "tense": 8192,
                                "ageLevel": 1,
                                "commonness": 5
                            }
                        }
                    },
                    "hasNoun": true,
                    "hasVerb": true,
                    "ageLevel": 1,
                    "foundFmEngine": true,
                    "scoreBreakdown": {
                        "wordMatch": 500,
                        "exactWords": 60,
                        "coverage": 2000,
                        "sentenceBonus": 4000,
                        "positionBonus": 733.33,
                        "orderBonus": 100,
                        "spreadBonus": 800,
                        "roleBonus": 2900,
                        "faqQuestionBonus": 0,
                        "mlMatchBonus": 0,
                        "tasktypeBonus": 50,
                        "matchBonus": 500,
                        "phraseJoinPenalty": 0
                    },
                    "matchType": "definite",
                    "task": "Book a ticket",
                    "state": "published",
                    "foundVia": "wordMatch"
                }
            ]
        },
        "finalResolver": {
            "ranking": [
                {
                    "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
                    "intent": "Book a ticket",
                    "activityType": "dialog",
                    "state": "published",
                    "totalScore": 11643.33,
                    "scoring": {
                        "count": 2,
                        "score": 11643.33,
                        "botid": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
                        "botname": "Public APIs",
                        "activity": "Book a ticket",
                        "activityType": 1,
                        "exactcount": 2,
                        "labelsize": 2,
                        "ignorewords": 1,
                        "mask": 66306,
                        "words": {
                            "book": [
                                "0-1"
                            ],
                            "ticket": [
                                "0-3"
                            ]
                        },
                        "priority": 10,
                        "tense": 8192,
                        "mainRoles": 10,
                        "sentencelength": 3,
                        "ignorewordlist": {
                            "a": 1
                        },
                        "maskEntity": 66306,
                        "firstwordmatch": "book",
                        "details": {
                            "0": {
                                "1": {
                                    "labelword": "book",
                                    "inputwords": {
                                        "1": "book"
                                    },
                                    "wordindex": [
                                        1
                                    ],
                                    "foundexact": true,
                                    "bestwordindex": 1,
                                    "role": 2,
                                    "pos": 2200096997376,
                                    "tense": 8192,
                                    "ageLevel": 1,
                                    "commonness": 6
                                },
                                "2": {
                                    "labelword": "ticket",
                                    "inputwords": {
                                        "3": "ticket"
                                    },
                                    "wordindex": [
                                        3
                                    ],
                                    "foundexact": true,
                                    "bestwordindex": 3,
                                    "role": 8,
                                    "pos": 2147483680,
                                    "tense": 8192,
                                    "ageLevel": 1,
                                    "commonness": 5
                                }
                            }
                        },
                        "hasNoun": true,
                        "hasVerb": true,
                        "ageLevel": 1,
                        "foundFmEngine": true,
                        "scoreBreakdown": {
                            "wordMatch": 500,
                            "exactWords": 60,
                            "coverage": 2000,
                            "sentenceBonus": 4000,
                            "positionBonus": 733.33,
                            "orderBonus": 100,
                            "spreadBonus": 800,
                            "roleBonus": 2900,
                            "faqQuestionBonus": 0,
                            "mlMatchBonus": 0,
                            "tasktypeBonus": 50,
                            "matchBonus": 500,
                            "phraseJoinPenalty": 0
                        },
                        "matchType": "definite",
                        "csMatch": true
                    },
                    "identifyingEngines": {
                        "fm": true
                    },
                    "csMatch": true,
                    "intentMatchVia": "wordMatch"
                }
            ],
            "userInput": "book a ticket",
            "winningIntent": [
                {
                    "intent": "Book a ticket",
                    "taskId": "dg-18219164-c11c-5605-9c29-d2e632ec3646",
                    "activityType": "dialog",
                    "state": "published",
                    "score": 11643.33
                }
            ],
            "entities": []
        }
    },
    "streamId": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
    "streamName": "Public APIs",
    "seqLogId": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
    "_id": "f-19f149a6-25e3-5c85-8793-679bfd26acf5",
    "name": "Public APIs",
    "input": [
        "book a ticket"
    ]
}
메뉴