시작
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 커넥터
봇 관리자용 분석
청구
  1. Docs
  2. Virtual Assistants
  3. API Guide
  4. Kore.ai API 사용

Kore.ai API 사용

Kore.ai 봇 플랫폼은 보안 API를 사용하여 봇 개발에 대한 액세스를 제공합니다. 봇 생성, 봇 가져오기, 봇 내보내기, 학습, 게시와 같은 모든 주요 개발자 활동은 API를 활용해 사용할 수 있습니다. 봇 빌더 액세스 관리, 관리자 및 봇 역할 관리 등의 주요 계정 관리 작업도 보안 공용 API를 통해 수행할 수 있습니다. 전체 API 목록 및 사용 지침은 여기를 참조하세요. API 요청 인증에는 다음 두 단계가 포함됩니다.

  1. 앱 생성: 앱을 만드는 과정에서 앱의 API 범위를 선택해야 하며, 선택한 API만 앱에 액세스할 수 있습니다.
    • 봇 빌더 API 범위: 봇 개발자는 봇 빌더 도구에서 봇별 API 범위를 정의할 수 있습니다.
    • 봇 관리자 콘솔 API 범위: 계정 관리자는 API 범위를 정의하여 관리자 콘솔에서 계정에 내장된 봇에 액세스할 수 있습니다.
  2. API 범위를 앱에 연결: 클라이언트 애플리케이션이 봇 플랫폼 API에 액세스할 수 있도록 하려면 클라이언트 앱을 봇에 연결해야 합니다.

또한 다음 방법으로 플랫폼과의 연결을 보호할 수 있습니다.

  1. JTI 클레임 적용 – 활성화되면 플랫폼은 요청에서 JTI 클레임이 있는 호출의 요청만 수락하며 JTI 클레임이 없는 요청은 거부됨
  2. JWE 암호화 적용– JWT 토큰 생성: 봇 플랫폼의 공용 API에 액세스 하려면 API 요청을 하는 애플리케이션은 인증이 필요합니다. Kore.ai는 JWS(JSON 웹 토큰) 메커니즘을 사용하여 인증을 처리합니다. JWT 토큰의 간략한 개요에 대해서는 Introduction to JWT tokens를 참조하세요. 위에서 클라이언트 앱의 클라이언트 ID 및 클라이언트 암호를 사용하여 JWT 토큰을 생성합니다. 이 토큰은 인증을 위한 각 API 요청의 일부로 전달되어야 합니다.

앱 생성 및 관리

봇 빌더

다음 단계를 통해 봇 빌더에서 클라이언트 앱을 생성할 수 있습니다.

  1. 상단 메뉴에서 배포 탭 선택
  2. 왼쪽 메뉴에서, 통합-> 앱 관리 클릭
  3. 새 앱 클릭
  4. 클라이언트 앱 생성 페이지에서 다음을 수행합니다.
    1. 앱의 이름을 입력하고,
    2. 요구 사항대로 JTI 또는 JWE를 적용하고
  5. 다음마침을 클릭합니다.
  6. 앱 관리 페이지로 리디렉션되며 이 봇과 연결된 모든 앱이 표시됩니다.
  7. 앱을 선택하면 클라이언트 ID 및 클라이언트 시크릿 섹션이 나타납니다. 또한 이 앱이 사용되는 웹 SDK, 봇 키트 SDK 등의 목록도 표시됩니다.
  8. 해당 앱에 휴지통 아이콘을 사용하여 앱을 삭제하도록 이 화면도 사용할 수 있습니다. 봇 소유만 앱을 삭제할 수 있는 점 유의하세요.

참고 사항: ver. 7.3이 출시되기 전에는 앱이 사용자와 연결되어 있었습니다. 이 앱은 ver 7.3이 출시된 이후 봇과 연결되어 있습니다. 봇 소유자가 아닌 봇 개발자는 앱 및 범위 권한을 통해 이러한 앱에 액세스할 수 있습니다. 이전 버전과의 호환성을 보장하기 위해, 한 개 이상의 봇에서 앱을 사용하는 경우, 이러한 각 봇에 대해 동일한 자격 증명으로 앱이 복제됩니다.

봇 관리자 콘솔

다음 단계를 수행하면 봇 관리자 콘솔에서 클라이언트 앱을 생성할 수 있습니다.

  1. 봇 관리자 홈 페이지의 측면 탐색 패널에서 보안 및 제어 > API 범위 를 클릭합니다.
  2. API 범위 페이지에서 신규 를 클릭합니다.
  3. 새 앱을 만들려면 앱 관리 링크를 클릭합니다.
  4. 새 앱을 클릭하고,
    1. 이름을 입력하고
    2. 요구 사항대로 JTI 또는 JWE를 적용하고
  5. Save를 클릭합니다.

데이터 테이블

플랫폼의 v7.3에 있는 플랫폼에 데이터 테이블 옵션이 추가되었습니다(자세한 내용은 여기 참조). 이러한 액세스 제어는 봇 빌더 및 봇 관리자 콘솔 액세스 제어와 다릅니다. 데이터 테이블 및 데이터 보기에서 데이터에 안전하게 접근하기 위해 앱을 정의할 수 있습니다.

  • 하나 이상의 앱을 만들 수 있으며 해당 앱을 소유할 수 있습니다. 자세한 내용은 여기를 참조하세요.
  • 이러한 앱은 다음을 위해 사용될 수 있습니다:
    • 공용 API를 통한 데이터 테이블 및 보기 접근
    • 서비스 노드를 사용하여 데이터 테이블 및 보기 접근
    • 데이터 테이블 및 보기 정의를 위해 가져오기 및 내보내기 API에 액세스
  • 이 앱에 각 테이블에 대한 읽기, 쓰기 및 삭제 권한을 부여하거나 별도로 볼 수 있습니다. 자세한 내용은 여기를 참조하세요.

API 범위 연결

클라이언트 앱을 생성하면 API 범위와 연결해야 합니다.

봇 빌더

다음 단계를 수행하면 봇 빌더에서 API 범위를 클라이언트 앱에 연결할 수 있습니다.

  1. 봇의 탐색 패널쪽에 마우스를 이동하여 API 확장 을 클릭합니다.
  2. API 확장 페이지에서 API 범위 탭을 클릭한 다음 신규를 클릭합니다.
  3. API 범위 매핑 페이지의 앱 드롭다운 목록에서 인증을 위한 기존 클라이언트 앱을 선택합니다.
  4. 앱을 선택하면 클라이언트 ID 및 클라이언트 시크릿 섹션이 나타납니다. 값을 복사할 수 있습니다.
  5. 범위 섹션에서 클라이언트 앱에 액세스하고자 하는 API를 선택합니다. 앱은 여기에서 선택하지 않은 API에 액세스할 수 없습니다. 다음은 선택할 수 있는 범위 목록입니다.
    • 의도 및 엔티티 감지 – 보안 API를 사용하여 발화에서 의도 및 엔티티를 감지하기
    • 채팅 기록 – 보안 API를 사용하여 이 봇의 채팅 기록 검색하기
    • 디버그 로그 – 보안 API를 사용하여 이 봇의 디버그 로그 검색하기
    • 봇 내보내기 – 선택한 봇의 정의를 내보내기
    • 변수 가져오기 – 보안 API를 사용하여 이 봇의 변수 가져오기
    • 변수 내보내기 – 보안 API를 사용하여 이 봇의 변수 내보내기
    • ML 학습 – NL 모델에 대한 특정 발화과 일치시켜 발화에서 나타날 수 있는 의도 및 엔티티 파악하기
    • FAQ 학습 – FAQ 모델과 주어진 FAQ를 일치시키기
    • 발화 가져오기 – 봇 작업에 대한 발화 가져오기
    • 발화 내보내기 – 봇 작업에 대한 발화 내보내기
    • 로그 기록 – 특정 봇에 대한 변경 로그 검색하기
    • 봇 세션 – 봇 대화 세션 검색하기
    • 맞춤형 보고서 – 맞춤형 위젯 및 보고서와 연결된 데이터 검색하기
    • RCS 메시지 이벤트 – RCS 비즈니스 메시지 채널에 사용자를 등록하고 브로드캐스트 메시지 전송
    • 외부 봇 연결 – 이 계정의 일부가 아닌 자식 봇을 연결하도록 함

참고 사항: 활성화되면 API 범위는 게시되어야 합니다. 게시 절차에 따라 API 확장 옵션에서 API 범위를 선택해야 합니다.

봇 관리자 콘솔

다음 단계를 수행하면 봇 관리자 콘솔에서 API 범위를 클라이언트 앱에 연결할 수 있습니다.

  1. 봇 관리자 홈 페이지의 측면 탐색 패널에서 보안 및 제어 > API 범위 를 클릭합니다.
  2. API 범위 페이지에서 신규 를 클릭합니다.
  3. 새 API 범위 매핑 페이지의 드롭다운 목록에서 인증을 위한 기존 클라이언트 앱을 선택합니다. 새 앱을 만들려면 앱 관리 링크를 클릭합니다.
  4. 앱을 선택하면 클라이언트 ID 및 클라이언트 시크 릿 섹션이 나타납니다. 값을 복사합니다.
  5. 해당 앱에 휴지통 아이콘을 사용하여 앱을 삭제하도록 이 화면도 사용할 수 있습니다.
  6. 범위 섹션에서 클라이언트 앱에 액세스하고자 하는 API를 선택합니다. API 범위 목록은 여기 를 참조하세요.

JWT 토큰 생성

API 범위를 클라이언트 앱에 연결한 후에는 API 요청에 대한 JWT 토큰을 생성해야 합니다.

  1. 다음 링크를 사용하여 토큰을 생성할 수 있습니다. 여기를 클릭하세요.
  2. 토큰 생성에 사용할 알고리즘을 선택합니다(HS256 또는 RS256)
  3. 디코딩된 섹션으로 스크롤 다운합니다.
  4. 페이로드 상자의 콘텐츠를 이전 섹션에서 복사한 앱의 클라이언트 ID로 교체합니다.
    { 
      "appId": "your-client-id-here" 
    }
    참고 사항: 봇 빌더는 토큰이 “appId”로 정확히 생성될 때만 토큰을 검증합니다. 이 플랫폼은 “App ID” “appid” 또는 “appID” 등의 다른 형식으로 생성된 토큰의 유효성을 검증하지 않습니다.
  5. 서명 확인 상자에서,
    • HS256 인코딩의 경우, 상자의 이전 섹션에서 복사한 클라이언트 시크릿을 256비트 비밀의 텍스트와 함께 입력합니다.
    • RS256 인코딩의 경우 해당 텍스트 영역에 공개 및 개인 키를 입력합니다. 참고: 키는 시작 및 끝 태그 내에 붙여 넣어야 합니다.
  6. 맨 위에 있는 인코딩된 섹션에서 생성된 JWT 토큰을 복사하거나 맨 아래에 있는 JWT 복사 단추를 사용합니다.
  7. 이 토큰은 필요한 API에 액세스하는 데 사용할 수 있고 각 API 요청의 일부로서 인증을 위해 전달되어야 합니다.
  8. API 컬렉션을 사용하여 Postman 설정에서 API를 테스트할 수 있습니다. 자세한 내용은 여기를 참조하세요.
메뉴