봇을 새 봇 API로 가져오기 – Kore.ai Documentation

봇을 새 봇으로 가져오기 API는 계정 소유자의 빌더 도구에서 새 봇을 만드는 데 사용되며, 파일을 로컬 서버에 업로드하여 생성된 파일 ID를 사용합니다. 파일 ID를 업로드하고 얻는 방법은 파일 업로드 API를 참조하세요.

이 API를 사용하려면 오직 봇 관리자 콘솔에서 생성된 애플리케이션에서 만들어진 JWT가 필요합니다. 이 API를 사용하려면 봇 정의 아래에 있는 봇 가져오기의 관리자 API 범위가 필요합니다.

POST https://{{host}}/api/public/bot/import

쿼리 매개 변수

매개 변수	설명
host	환경 URL(예: https://bots.kore.ai)

본문 매개 변수

매개 변수	설명
botDefinition	"봇 정의 파일 ID"는 파일 ID를 업로드하고 얻는 방법에 대한 파일 업로드 API를 참조하세요.
configInfo	"봇 설정 파일 ID"는 파일 ID를 업로드하고 얻는 방법에 대한 파일 업로드 API를 참조하세요.
botFunctions (선택 사항)	"봇 기능 파일 ID"는 파일 ID를 업로드하고 얻는 방법에 대한 파일 업로드 API를 참조하세요.
icon	"봇 아이콘 파일 ID"는 파일 ID를 업로드하고 얻는 방법에 대한 파일 업로드 API를 참조하세요.
name (선택 사항)	"봇 이름" 제공되지 않는 경우, 기존 봇 복사본에서 가져옵니다
purpose (선택 사항)	“고객”/”직원”제공되지 않는 경우 기존 봇 복사본에서 가져옵니다

권한 부여

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

콘텐츠 유형 응답

application/json

샘플 요청

curl -X POST \
  https://{{host}}/api/public/bot/import \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
   -H 'content-type: application/json' \
   -d '{
  "botDefinition" : "5b7ed3c87cab5c48ea9794f9",
  "configInfo" : "5b7ed2w77cab5c48ea9794fa",
  "botFunctions":["5b7ed13a86a5fc48f4777ea6"],
  "icon":"5b7ed3837cab5c48ea9794fb"
}'

샘플 응답

{
    "streamRefId": "f6e21f2d-cf90-52b0-bbc5-638add8dba26",
    "statusLogs": [
        {
            "taskType": "importRequest",
            "taskName": "SampleTaskName",
            "status": "success"
        }
    ],
    "createdBy": "u-3ae8bd39-a65b-5b2c-b66b-85864a8202c3",
    "requestType": "Botimport",
    "_id": "bir-32a5ed0d-6181-5a0a-9f21-1bf872290029",
    "status": "pending",
    "createdOn": "2018-12-05T07:28:46.113Z",
    "__v": 0
}

[新しいボットとしてボットをインポート] は、ファイルをローカルサーバーにアップロードすることで生成されたファイルIDを使用し、アカウントオーナーのビルダーツールで新しいボットを作成するために使用されます。ファイルIDのアップロードおよび取得方法については、「ファイルAPIをアップロード」を参照してください。

このAPIには、ボット管理者コンソールからのみ作成されたアプリケーションによって生成されたJWTが必要です。このAPIを使用するために、アプリは [ボット定義] の [ボットをインポート] の管理APIスコープを必要とします。

ポスト https://{{host}}/api/public/bot/import

クエリパラメータ

パラメータ	説明
ホスト	環境URL（例： https://bots.kore.ai）

本文パラメータ

パラメータ	説明
botDefinition	「ボットの定義ファイルID」ファイルIDのアップロードおよび取得方法については、「ファイルAPIをアップロード」を参照してください。
configInfo	「ボットの設定ファイルID」ファイルIDのアップロードおよび取得方法については、「ファイルAPIをアップロード」を参照してください。
botFunctions（任意）	「ボットの機能ファイルID」ファイルIDのアップロードおよび取得方法については、「ファイルAPIをアップロード」を参照してください。
icon	「ボットのアイコンファイルID」ファイルIDのアップロードおよび取得方法については、「ファイルAPIをアップロード」を参照してください。
name（任意）	「ボット名」指定されていない場合は、既存のボットのコピーから取得されます。
purpose（任意）	「カスタマー」/「従業員」指定されていない場合は、既存のボットのコピーから取得されます。

認証

以下の構文を使用して、JWTをヘッダーに含むAPIを呼び出します。 auth: {{JWT}}

応答のコンテンツタイプ

application/json

サンプルリクエスト

curl -X POST \ https://{{host}}/api/public/bot/import \ -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \ -H 'content-type: application/json' \ -d '{ "botDefinition" : "5b7ed3c87cab5c48ea9794f9", "configInfo" : "5b7ed2w77cab5c48ea9794fa", "botFunctions":["5b7ed13a86a5fc48f4777ea6"], "icon":"5b7ed3837cab5c48ea9794fb" }'

サンプル応答

{ "streamRefId": "f6e21f2d-cf90-52b0-bbc5-638add8dba26", "statusLogs": [ { "taskType": "importRequest", "taskName": "SampleTaskName", "status": "success" } ], "createdBy": "u-3ae8bd39-a65b-5b2c-b66b-85864a8202c3", "requestType": "Botimport", "_id": "bir-32a5ed0d-6181-5a0a-9f21-1bf872290029", "status": "pending", "createdOn": "2018-12-05T07:28:46.113Z", "__v": 0 }

Import Bot as a New Bot API is used to create a new bot in the account owner’s Builder Tool using the File IDs generated by uploading the files to the local server. Refer to Upload File API on how to upload and obtain the File Id.

This API requires JWT generated by an application created only from Bot Admin Console.
To use this API, app needs the Admin API Scope of Bot Import under Bot Definition.

POST https://{{host}}/api/public/bot/import

Query Parameters

Parameter	Description
host	Environment URL, for example, https://bots.kore.ai

Body Parameters

Parameter	Description
botDefinition	“Bot definition file id” Refer to Upload File API on how to upload and obtain the File Id.
configInfo	“Bot configuration file id” Refer to Upload File API on how to upload and obtain the File Id.
botFunctions (optional)	“ Bot fuctions File id” Refer to Upload File API on how to upload and obtain the File Id.
icon	“Bot icon File id” Refer to Upload File API on how to upload and obtain the File Id.
name (optional)	“Bot name” If not provided they will be taken from the existing bot copy
purpose (optional)	“customer”/”employee” If not provided they will be taken from the existing bot copy

Authorization

Invoke the API with JWT in the header with the following syntax:

auth: {{JWT}}

Response content type

application/json

Sample Request

curl -X POST \
  https://{{host}}/api/public/bot/import \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
   -H 'content-type: application/json' \
   -d '{
  "botDefinition" : "5b7ed3c87cab5c48ea9794f9",
  "configInfo" : "5b7ed2w77cab5c48ea9794fa",
  "botFunctions":["5b7ed13a86a5fc48f4777ea6"],
  "icon":"5b7ed3837cab5c48ea9794fb"
}'

Sample Response

{
    "streamRefId": "f6e21f2d-cf90-52b0-bbc5-638add8dba26",
    "statusLogs": [
        {
            "taskType": "importRequest",
            "taskName": "SampleTaskName",
            "status": "success"
        }
    ],
    "createdBy": "u-3ae8bd39-a65b-5b2c-b66b-85864a8202c3",
    "requestType": "Botimport",
    "_id": "bir-32a5ed0d-6181-5a0a-9f21-1bf872290029",
    "status": "pending",
    "createdOn": "2018-12-05T07:28:46.113Z",
    "__v": 0
}