CreateBotLocale - Amazon Lex

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CreateBotLocale

봇에 로케일을 만듭니다. 로케일에는 봇이 지정된 언어 및 로케일의 사용자와 대화할 때 사용하는 인텐트 및 슬롯 유형이 포함됩니다. 봇에 인텐트와 슬롯 유형을 추가하려면 먼저 봇에 로캘을 추가해야 합니다.

요청 구문

PUT /bots/botId/botversions/botVersion/botlocales/ HTTP/1.1 Content-type: application/json { "description": "string", "localeId": "string", "nluIntentConfidenceThreshold": number, "voiceSettings": { "engine": "string", "voiceId": "string" } }

URI 요청 파라미터

요청은 다음의 URI 파라미터를 사용합니다.

botId

로케일을 만들 봇의 식별자입니다.

길이 제약: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

: 필수 사항 예

botVersion

로케일을 생성할 봇의 버전입니다. 봇의 초안 버전일 수 있습니다.

길이 제약: 고정 길이 5입니다.

Pattern: ^DRAFT$

: 필수 사항 예

요청 본문

요청은 JSON 형식의 다음 데이터를 받습니다.

description

봇 로케일에 대한 설명입니다. 이 옵션을 사용하면 목록에서 봇 로캘을 식별할 수 있습니다.

Type: 문자열

길이 제약: 최소 길이는 0입니다. 최대 길이는 200입니다.

: 필수 사항 아니요

localeId

봇이 사용될 언어 및 로케일의 식별자입니다. 문자열은 지원되는 로케일 중 하나와 일치해야 합니다. 봇에 사용되는 모든 인텐트, 슬롯 유형 및 슬롯은 동일한 로캘을 가져야 합니다. 자세한 내용은 단원을 참조하십시오.지원되는 언어.

Type: 문자열

: 필수 사항 예

nluIntentConfidenceThreshold

Amazon Lex가 삽입할 임계값을 결정합니다.AMAZON.FallbackIntent,AMAZON.KendraSearchIntent또는 둘 다 대체 의도를 반환할 때AMAZON.FallbackIntentAMAZON.KendraSearchIntent는 봇에 대해 구성된 경우에만 삽입됩니다.

예를 들어 봇이 신뢰 임계값 0.80으로 구성되어 있다고 가정하고AMAZON.FallbackIntent. Amazon Lex는 다음과 같은 신뢰 점수와 함께 세 가지 대체 인텐트를 반환합니다. 인텐타 (0.70), 인텐트B (0.60), 인텐트C (0.50). 의 응답RecognizeText작업은 다음과 같습니다.

  • AMAZON.FallbackIntent

  • 인텐타

  • 인텐트B

  • IntentC

Type: Double

유효한 범위: 최소값은 0입니다. 최대값은 1이고,

: 필수 사항 예

voiceSettings

Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다.

유형: VoiceSettings 객체

: 필수 사항 아니요

응답 구문

HTTP/1.1 202 Content-type: application/json { "botId": "string", "botLocaleStatus": "string", "botVersion": "string", "creationDateTime": number, "description": "string", "localeId": "string", "localeName": "string", "nluIntentConfidenceThreshold": number, "voiceSettings": { "engine": "string", "voiceId": "string" } }

응답 요소

작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

botId

지정된 봇 식별자입니다.

Type: 문자열

길이 제약: 고정 길이 10입니다.

Pattern: ^[0-9a-zA-Z]+$

botLocaleStatus

봇의 상태입니다.

상태가 다음과 같을 때Creating봇의 로캘이 구성되고 있습니다. 상태가 다음과 같을 때BuildingAmazon Lex는 테스트 및 사용을 위해 봇을 구축하고 있습니다.

봇의 상태가 다음과 같은 경우ReadyExpressTesting를 선택하면 봇의 의도에 지정된 정확한 발언을 사용하여 봇을 테스트할 수 있습니다. 봇이 전체 테스트 또는 실행이 준비되면 상태는 다음과 같습니다.Built.

봇을 빌드하는 데 문제가 있는 경우 상태는 다음과 같습니다.Failed. 봇이 저장되었지만 빌드되지 않은 경우 상태는 다음과 같습니다.NotBuilt.

Type: 문자열

유효한 값: Creating | Building | Built | ReadyExpressTesting | Failed | Deleting | NotBuilt | Importing | Processing

botVersion

지정된 봇 버전입니다.

Type: 문자열

길이 제약: 고정 길이 5입니다.

Pattern: ^DRAFT$

creationDateTime

봇이 생성된 날짜와 시간을 지정하는 타임스탬프입니다.

Type: 타임스탬프

description

봇의 로캘에 대한 지정된 설명입니다.

Type: 문자열

길이 제약: 최소 길이는 0입니다. 최대 길이는 200입니다.

localeId

지정된 로캘 식별자입니다.

Type: 문자열

localeName

지정된 로캘 이름입니다.

Type: 문자열

nluIntentConfidenceThreshold

삽입을 위한 지정된 신뢰 임계값AMAZON.FallbackIntentAMAZON.KendraSearchIntent의도.

Type: Double

유효한 범위: 최소값은 0입니다. 최대값은 1이고,

voiceSettings

Amazon Lex가 사용자와의 음성 상호 작용에 사용하는 Amazon Polly 음성 ID입니다.

유형: VoiceSettings 객체

오류

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.

ConflictException

리소스가 충돌하는 상태이므로 수행하려고 시도한 작업을 완료할 수 없습니다. 예를 들어 CREATING 상태에 있는 봇을 삭제할 수 있습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 409

InternalServerException

서비스에 예상치 못한 조건이 발생했습니다. 요청을 다시 시도하십시오.

HTTP 상태 코드: 500

PreconditionFailedException

하나 이상의 요청 필드가 유효하지 않기 때문에 요청을 완료할 수 없습니다. 요청의 필드를 확인하고 다시 시도하십시오.

HTTP 상태 코드: 412

ServiceQuotaExceededException

봇에 대한 할당량에 도달했습니다.

HTTP 상태 코드: 402

ThrottlingException

요청량이 너무 높습니다. 요청 횟수를 줄입니다.

HTTP 상태 코드: 429

ValidationException

요청의 입력 매개 변수 중 하나가 잘못되었습니다. 파라미터를 확인하고 요청을 다시 시도하십시오.

HTTP 상태 코드: 400

참고 항목

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.