ML 발화 내보내기 API – Kore.ai Documentation

ML 발화를 봇으로 가져옵니다.

이 API를 사용하려면 앱에 발화 가져오기의 봇 빌더 API 범위가 필요합니다. 또는 테스트 및 훈련아래의 발화 가져오기의 관리자 API 범위가 필요합니다.

POST https://{{host}}/api/public/bot/{{BotID}}/mlimport

쿼리 매개 변수

매개 변수	필수/선택 사항	설명
host	필수	봇 환경 URL(예: https://bots.kore.ai)
BotID	필수	가져올 봇의 봇 ID 또는 스트림 ID입니다. 봇의 일반 설정 페이지에서 이를 액세스할 수 있습니다.

본문 매개 변수

매개 변수	필수/선택 사항	설명
fileName	필수	가져올 ML 발화 파일의 전체 이름입니다
fileID	필수	가져오기 파일의 ID(파일이 업로드되는 클라우드 서비스에서 제공).

권한 부여

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

콘텐츠 유형 응답

application/json

샘플 요청

curl -X POST \
  https://{{host}}/api/public/bot/{{bot ID}}/mlimport \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json' \
  -d '{
"fileName":"MLUtterances.json",
"fileId": "5beed4fd0b9a4b740c09dca2"
}

샘플 응답

{
    "status": "pending",
    "streamId": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
    "createdBy": "u-5dad2ccd-b271-5c00-a338-2e6e25e1ec91",
    "requestType": "MLimport",
    "_id": "bir-7ec861ee-5e6b-5165-b505-8820a275afdf",
    "statusLogs": [],
    "createdOn": "2019-06-27T12:03:30.748Z",
    "__v": 0
}

ボットに機械学習の発話をインポートします。

このAPIを使用するために、アプリは [発話のエクスポート] のボットビルダーのAPIスコープを必要とします。あるいは、[テストとトレーニング] にある [発話のインポート] の管理者のAPIスコープを必要とします。

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

クエリパラメータ

パラメータ	必須/任意	説明
ホスト	必須	ボット環境URL（例： https://bots.kore.ai）
ボットID	必須	インポートするボットのボットIDまたはストリームIDです。ボットの [一般設定] ページからアクセスすることができます。

本文パラメータ

パラメータ	必須/任意	説明
fileName	必須	インポートする機械学習の発話ファイルのフルネーム
fileID	必須	インポートファイルのID（ファイルをアップロードしたクラウドサービスから提供）です。

認証

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

応答のコンテンツタイプ

application/json

サンプルリクエスト

curl -X POST \ https://{{host}}/api/public/bot/{{bot ID}}/mlimport \ -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \ -H 'content-type: application/json' \ -d '{ "fileName":"MLUtterances.json", "fileId": "5beed4fd0b9a4b740c09dca2" }

サンプル応答

{ "status": "pending", "streamId": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb", "createdBy": "u-5dad2ccd-b271-5c00-a338-2e6e25e1ec91", "requestType": "MLimport", "_id": "bir-7ec861ee-5e6b-5165-b505-8820a275afdf", "statusLogs": [], "createdOn": "2019-06-27T12:03:30.748Z", "__v": 0 }

Imports ML Utterances into a bot.

To use this API, app needs the Bot Builder API scope of Utterances Import.
OR the Admin API Scope of Utterances Import under Test and Train.

POST https://{{host}}/api/public/bot/{{BotID}}/mlimport

Query Parameters

Parameter	Required/Optional	Description
host	Required	The bot environment URL, for example, https://bots.kore.ai
BotID	Required	Bot ID or Stream ID of the bot to import into. You can access it from the General Settings page of the bot.

Body Parameters

Parameter	Required/Optional	Description
fileName	Required	Full name of the ML Utterances file to import
fileID	Required	The ID of the import file (provided by the cloud service where the file is uploaded).

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/{{bot ID}}/mlimport \
  -H 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
  -H 'content-type: application/json' \
  -d '{
"fileName":"MLUtterances.json",
"fileId": "5beed4fd0b9a4b740c09dca2"
}

Sample Response

{
    "status": "pending",
    "streamId": "st-6ecb5ba2-5e31-5a40-b918-8cbee40f3fdb",
    "createdBy": "u-5dad2ccd-b271-5c00-a338-2e6e25e1ec91",
    "requestType": "MLimport",
    "_id": "bir-7ec861ee-5e6b-5165-b505-8820a275afdf",
    "statusLogs": [],
    "createdOn": "2019-06-27T12:03:30.748Z",
    "__v": 0
}