CreateSlotType - Amazon Lex

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

CreateSlotType

사용자 지정 슬롯 유형을 생성합니다.

사용자 정의 슬롯 유형을 만들려면 슬롯 유형의 이름과 열거 값 집합 (이 유형의 슬롯이 가정할 수 있는 값) 을 지정합니다.

요청 구문

PUT /bots/botId/botversions/botVersion/botlocales/localeId/slottypes/ HTTP/1.1 Content-type: application/json { "description": "string", "externalSourceSetting": { "grammarSlotTypeSetting": { "source": { "kmsKeyArn": "string", "s3BucketName": "string", "s3ObjectKey": "string" } } }, "parentSlotTypeSignature": "string", "slotTypeName": "string", "slotTypeValues": [ { "sampleValue": { "value": "string" }, "synonyms": [ { "value": "string" } ] } ], "valueSelectionSetting": { "advancedRecognitionSetting": { "audioRecognitionStrategy": "string" }, "regexFilter": { "pattern": "string" }, "resolutionStrategy": "string" } }

URI 요청 파라미터

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

botId

이 슬롯 유형과 연결된 봇의 식별자입니다.

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

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

: 필수 예

botVersion

이 슬롯 유형과 연결된 봇 버전의 식별자입니다.

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

Pattern: ^DRAFT$

: 필수 예

localeId

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

: 필수 예

요청 본문

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

description

슬롯 유형에 대한 설명입니다. 목록에서 슬롯 유형을 식별할 수 있습니다.

Type: 문자열

길이 제약 조건: 최소 길이는 0이고, 최대 길이는 200입니다.

: 필수 아니요

externalSourceSetting

슬롯 유형을 생성하는 데 사용되는 외부 정보 유형을 설정합니다.

유형: ExternalSourceSetting 객체

: 필수 아니요

parentSlotTypeSignature

이 슬롯 유형의 부모로 사용되는 내장 슬롯 유형입니다. 상위 슬롯 유형을 정의할 때 새 슬롯 유형은 상위 슬롯 유형의 구성을 갖습니다.

AMAZON.AlphaNumeric만 지원됩니다.

Type: 문자열

: 필수 아니요

slotTypeName

슬롯의 이름 슬롯 유형 이름은 계정 내에서 고유해야 합니다.

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.

Pattern: ^([0-9a-zA-Z][_-]?)+$

: 필수 예

slotTypeValues

목록SlotTypeValue슬롯 유형이 취할 수 있는 값을 정의하는 객체입니다. 각 값에는 동의어 목록과 슬롯에 대해 해석되는 값에 대해 기계 학습 모델을 훈련시키는 데 도움이 되는 추가 값이 포함될 수 있습니다.

Type: 배열SlotTypeValue사물

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10000개입니다.

: 필수 아니요

valueSelectionSetting

Amazon Lex가 가능한 값 목록에서 값을 선택하기 위해 사용하는 전략을 결정합니다. 이 필드는 다음 값 중 하나로 설정될 수 있습니다.

  • OriginalValue- 사용자 값이 슬롯 값과 유사한 경우 사용자가 입력한 값을 반환합니다.

  • TopResolution- 슬롯에 대한 해상도 목록이 있는 경우 해상도 목록의 첫 번째 값을 반환합니다. 해결 목록이 없으면 null을 반환합니다.

를 지정하지 않은 경우valueSelectionSetting매개 변수, 기본값은 다음과 같습니다.OriginalValue.

유형: SlotValueSelectionSetting 객체

: 필수 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "botId": "string", "botVersion": "string", "creationDateTime": number, "description": "string", "externalSourceSetting": { "grammarSlotTypeSetting": { "source": { "kmsKeyArn": "string", "s3BucketName": "string", "s3ObjectKey": "string" } } }, "localeId": "string", "parentSlotTypeSignature": "string", "slotTypeId": "string", "slotTypeName": "string", "slotTypeValues": [ { "sampleValue": { "value": "string" }, "synonyms": [ { "value": "string" } ] } ], "valueSelectionSetting": { "advancedRecognitionSetting": { "audioRecognitionStrategy": "string" }, "regexFilter": { "pattern": "string" }, "resolutionStrategy": "string" } }

응답 요소

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

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

botId

슬롯 유형과 연결된 봇의 식별자입니다.

Type: 문자열

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

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

botVersion

슬롯 유형과 연결된 봇 버전입니다.

Type: 문자열

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

Pattern: ^DRAFT$

creationDateTime

슬롯 유형이 생성된 날짜와 시간의 타임스탬프입니다.

Type: 타임스탬프

description

슬롯 유형에 지정된 설명입니다.

Type: 문자열

길이 제약 조건: 최소 길이는 0이고, 최대 길이는 200입니다.

externalSourceSetting

슬롯 유형을 생성하는 데 사용되는 외부 정보 유형입니다.

유형: ExternalSourceSetting 객체

localeId

슬롯 유형에 대해 지정된 언어 및 로컬입니다.

Type: 문자열

parentSlotTypeSignature

슬롯 유형에 대해 지정된 기본 슬롯 유형의 서명입니다.

Type: 문자열

slotTypeId

슬롯 유형에 할당된 고유 식별자입니다. 이 옵션을 사용하여 에서 슬롯 유형을 식별할 수 있습니다.UpdateSlotTypeDeleteSlotType작업.

Type: 문자열

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

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

slotTypeName

슬롯 유형에 지정된 이름

Type: 문자열

길이 제약 조건: 최소 길이는 1이고, 최대 길이는 100입니다.

Pattern: ^([0-9a-zA-Z][_-]?)+$

slotTypeValues

슬롯 유형이 가정할 수 있는 값 목록입니다.

Type: 배열SlotTypeValue사물

배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 10000개입니다.

valueSelectionSetting

Amazon Lex가 가능한 값 목록에서 값을 선택하기 위해 사용하는 전략입니다.

유형: SlotValueSelectionSetting 객체

오류

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

ConflictException

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

HTTP 상태 코드: 409

InternalServerException

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

HTTP 상태 코드: 500

PreconditionFailedException

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

HTTP 상태 코드: 412

ServiceQuotaExceededException

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

HTTP 상태 코드: 402

ThrottlingException

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

HTTP 상태 코드: 429

ValidationException

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

HTTP 상태 코드: 400

참고 항목

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