Kore.ai BotKit SDK는 Node.js 애플리케이션으로 실행됩니다. 자체 역방향 프록시, 방화벽, 로드 밸런서를 추가하여 가용성, 확장성, 성능을 위한 기능적 요구 사항을 충족할 수 있습니다. BotKit SDK 설치 및 설정에 대한 높은 수준의 개요를 제공합니다. Kore.ai 샘플 봇을 사용한 설치 및 설정에 대한 자세한 엔드투엔드 튜토리얼의 경우, Kore.ai BotKit SDK 튜토리얼을 참조하세요. BotKit SDK를 설치하려면, 다음을 수행해야 합니다.

  • 봇을 만들고 웹/모바일 채널을 위한 봇을 설정하여 Kore.ai 봇 플랫폼에 애플리케이션을 등록합니다.
  • BotKit SDK 라이브러리를 다운로드하고 배포합니다.
  • config.json 파일을 설정합니다.

권한 부여

BotKit SDK 설치의 필수 구성 요소로, Kore.ai 봇 빌더 도구를 사용하여 Kore.ai 봇 플랫폼에 SDK 앱을 등록해야 합니다. 봇 빌더에서 봇을 만들고, API 확장 -> BotKit SDK 섹션에서, 해당 봇이 클라이언트 ID 및 앱과 봇 플랫폼 간에 통신을 위한 상호 SSL 인증에 사용되는 클라이언트 시크릿 보안 자격 증명을 생성하고, SDK에서 Kore.ai 플랫폼으로의 API 호출 권한을 부여하기 위한 앱을 등록/생성합니다.  SDK의 config.json 파일에서, 봇 빌더로 부터 다음 인증 키를 복사해야 합니다.

  • appId = 클라이언트 ID
  • appKey – 클라이언트 시크릿

자세한 내용은, SDK 앱 등록을 참조하세요.

설치 및 설정

Kore.ai BotKit SDK 라이브러리는 다음의 Github 저장소에서 다운로드할 수 있습니다. https://github.com/Koredotcom/BotKit SDK를 설정하려면, config.json 파일에 다음 키를 정의하여 BotKit이 잘 작동하도록 합니다.

키 설명
"server": { “port”: } BotKit NodeJS 앱 실행을 위한 포트를 지정합니다.
app": { “apiPrefix” : } NodeJS 익스프레스 경로에 대한 API 경로 접두사를 지정합니다.
"credentials": { “appId”: } SDK 앱 등록 시 Kore 봇 빌더에서 생성된 클라이언트 ID 값.

기본적으로, JWT 토큰은 60초 후에 만료됩니다. 다음 KoreConfig 설정을 사용하여 이를 변경할 수 있습니다.

"botkit":{
       "jwt_expiry": 300 //seconds
  }

BotKit SDK를 실행하려면, 터미널 창에서 다음을 입력합니다. node app.js

Kore.ai BotKit SDKは、Node.js アプリケーションとして動作します。独自のリバース プロキシ、ファイアウォール、ロードバランサーを追加することで、可用性、スケーラビリティ、パフォーマンスなどの関数要件を満たすことができます。このセクションでは、BotKit SDK のインストールと設定に関する詳細な概要を説明します。Kore.ai サンプル ボットを使ったインストールとセットアップの詳細なエンド ツー エンドのチュートリアルについては、Kore.ai BotKit SDK Tutorial をご覧ください。BotKit SDK をインストールするには、以下が必要です:

  • ボットを作成し、そのボットを Web/モバイル チャネル用に設定して、Kore.ai ボット プラットフォームにアプリケーションを登録します。
  • BotKit SDK ライブラリをダウンロードしてデプロイします。
  • config.json ファイルの設定を行います。

承認

BotKit SDK のインストールの前提として、Kore.ai ボットビルダー ツールを使って、SDK アプリを Kore.ai ボット プラットフォームに登録する必要があります。ボットビルダーではボットを作成し、[API 拡張] > [BotKit SDK] セクションでそのボット用のアプリを登録または作成して、アプリと ボット プラットフォーム間の通信のための相互 SSL 認証や、SDK から Kore.ai ボット プラットフォームへの API 呼出しの認証に使用される ClientID と クライアント シークレットのセキュリティ資格情報を生成することができます。 SDK の config.json ファイルでは、ボットビルダーから以下の認証キーをコピーする必要があります。

  • appId = ClientID
  • appKey ー クライアント シークレット

<span style="font-weight: 400">詳しくは、 </span><a href="/docs/bots/kore-web-sdk/sdk-app-registration/"><span style="font-weight: 400">「SDKアプリの登録」</span></a><span style="font-weight: 400">をご覧ください。</span>詳しくは SDKアプリの登録をご覧ください。

インストールとセットアップ

Kore.ai BotKit SDK のライブラリは、以下の GitHub リポジトリからダウンロードできます。https://github.com/Koredotcom/BotKit SDK を設定するには、config.json ファイルに以下のキーを定義して、BotKit を稼働させる必要があります。

キー 説明
"server": { "port": } BotKit Node.js アプリを実行するポートを指定します。
app": { "apiPrefix” : } Node.js express ルートの API パスのプレフィックスを指定します。
"credentials": { "appId": } SDK アプリの登録時に Kore ボットビルダーで生成されるクライアント ID の値です。

JWT トークンの有効期限は、デフォルトで 60 秒です。これは以下の KoreConfig の設定で変更できます:

"botkit":{ "jwt_expiry": 300 //seconds }

BotKit SDK を実行するには、ターミナル ウィンドウで、次のように入力します: node app.js

The Kore.ai BotKit SDK runs as Node.js application. You can add your own reverse proxy, firewall, and load balancer to meet your functional requirements for availability, scalability, and performance.
This section provides a high-level overview of BotKit SDK installation and configuration.
For a detailed end-to-end tutorial on installation and setup using our Kore.ai Sample Bots, see the Kore.ai BotKit SDK Tutorial.
To install the BotKit SDK, you will need to:

  • Register your application on the Kore.ai Bots Platform by creating a bot, and then configuring that bot for the Web/Mobile channel.
  • Download and deploy the BotKit SDK libraries.
  • Configure the config.json file.

Authorization

As a prerequisite for BotKit SDK installation, you need to register your SDK app with the Kore.ai Bots Platform using the Kore.ai Bot Builder tool.
In Bot Builder you need to create a bot, and then from API Extensions -> BotKit SDK section, register/create an app for that bot to generate the ClientID and Client Secret security credentials used for mutual SSL authentication for communication between your app and the Bots Platform and to authorize API calls from your SDK to the Kore.ai Bots Platform. 
In the config.json file in the SDK, you will need to copy the following authentication keys from Bot Builder.

  • appId = ClientID
  • appKey – Client Secret

For more information, see SDK App Registration.

Installation and Setup

The Kore.ai BotKit SDK libraries can be downloaded from the Github repository at:
https://github.com/Koredotcom/BotKit
To configure your SDK, you need to define the following keys in your config.json file to get your BotKit up and running.

Key Description
"server": {
“port”:
}		 Specifies the port to run the BotKit NodeJS app .
app": {
“apiPrefix” :
}		 Specifies the API path prefix to the NodeJS express route.
"credentials": {
“appId”:
}		 The Client ID value generated in Kore Bot Builder when registering your SDK app.

Note that the JWT token would expire in 60 seconds, by default. You can change this using the following KoreConfig setting:

"botkit":{
       "jwt_expiry": 300 //seconds
  }

To run BotKit SDK, in a Terminal window, enter:
node app.js