CreateSlotType - Amazon Lex

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

CreateSlotType

커스텀 슬롯 유형을 생성합니다.

사용자 정의 슬롯 유형을 만들려면 슬롯 유형의 이름과 해당 유형의 슬롯이 가정할 수 있는 열거 값 세트를 지정합니다.

요청 구문

PUT /bots/botId/botversions/botVersion/botlocales/localeId/slottypes/ HTTP/1.1 Content-type: application/json { "compositeSlotTypeSetting": { "subSlots": [ { "name": "string", "slotTypeId": "string" } ] }, "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입니다.

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

필수 예

botVersion

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

길이 제약: 고정 길이 5.

패턴: ^DRAFT$

필수 예

localeId

슬롯 유형에 사용될 언어 및 로캘의 식별자입니다. 문자열은 지원되는 로캘 중 하나와 일치해야 합니다. 슬롯 유형에서 사용하는 모든 봇, 인텐트 및 슬롯은 동일한 로케일을 가져야 합니다. 자세한 내용을 알아보려면 다음 섹션을 참조하세요.지원되는 언어.

필수 예

요청 본문

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

compositeSlotTypeSetting

컴포지트 슬롯 유형의 사양

유형: CompositeSlotTypeSetting 객체

필수 아니요

description

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

Type: 문자열

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

필수 아니요

externalSourceSetting

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

유형: ExternalSourceSetting 객체

필수 아니요

parentSlotTypeSignature

이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형입니다. 상위 슬롯 유형을 정의하면 새 슬롯 유형에 상위 슬롯 유형의 구성이 있습니다.

AMAZON.AlphaNumeric만 지원됩니다.

Type: 문자열

필수 아니요

slotTypeName

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

Type: 문자열

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

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

필수 예

slotTypeValues

의 목록입니다SlotTypeValue슬롯 유형이 사용할 수 있는 값을 정의하는 각 값에는 슬롯에 대해 확인하는 값에 대해 기계 학습 모델을 훈련시키는 데 도움이 되는 추가 값인 동의어 목록이 있을 수 있습니다.

Type: 배열SlotTypeValue사물

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

필수 아니요

valueSelectionSetting

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

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

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

을 지정하지 않으면valueSelectionSetting파라미터, 디폴트 값은OriginalValue.

유형: SlotValueSelectionSetting 객체

필수 아니요

응답 구문

HTTP/1.1 200 Content-type: application/json { "botId": "string", "botVersion": "string", "compositeSlotTypeSetting": { "subSlots": [ { "name": "string", "slotTypeId": "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입니다.

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

botVersion

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

Type: 문자열

길이 제약: 고정 길이 5.

패턴: ^DRAFT$

compositeSlotTypeSetting

컴포지트 슬롯 유형의 사양

유형: CompositeSlotTypeSetting 객체

creationDateTime

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

Type: 타임스탬프

description

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

Type: 문자열

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

externalSourceSetting

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

유형: ExternalSourceSetting 객체

localeId

슬롯 유형에 지정된 언어 및 로컬 지정

Type: 문자열

parentSlotTypeSignature

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

Type: 문자열

slotTypeId

슬롯 유형에 할당된 고유 식별자입니다. 이UpdateSlotTypeDeleteSlotType작업.

Type: 문자열

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

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

slotTypeName

슬롯 유형에 지정된 이름입니다.

Type: 문자열

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

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

slotTypeValues

슬롯 유형이 사용할 수 있는 값의 목록입니다.

Type: 배열SlotTypeValue사물

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

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 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.