CreateSlot - Amazon Lex

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

CreateSlot

인텐트에 슬롯을 만듭니다. 슬롯은 의도를 이행하는 데 필요한 변수입니다. 예:OrderPizza의도에는 피자 크기, 크러스트 및 개수에 대한 슬롯이 필요할 수 있습니다. 각 슬롯에 대해 Amazon Lex가 사용자로부터 응답을 이끌어내는 데 사용하는 하나 이상의 발언을 정의합니다.

요청 구문

PUT /bots/botId/botversions/botVersion/botlocales/localeId/intents/intentId/slots/ HTTP/1.1 Content-type: application/json { "description": "string", "multipleValuesSetting": { "allowMultipleValues": boolean }, "obfuscationSetting": { "obfuscationSettingType": "string" }, "slotName": "string", "slotTypeId": "string", "valueElicitationSetting": { "defaultValueSpecification": { "defaultValueList": [ { "defaultValue": "string" } ] }, "promptSpecification": { "allowInterrupt": boolean, "maxRetries": number, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] }, "sampleUtterances": [ { "utterance": "string" } ], "slotConstraint": "string", "waitAndContinueSpecification": { "active": boolean, "continueResponse": { "allowInterrupt": boolean, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] }, "stillWaitingResponse": { "allowInterrupt": boolean, "frequencyInSeconds": number, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ], "timeoutInSeconds": number }, "waitingResponse": { "allowInterrupt": boolean, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] } } } }

URI 요청 파라미터

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

botId

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

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

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

: 필수 예

botVersion

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

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

Pattern: ^DRAFT$

: 필수 예

intentId

슬롯을 포함하는 인텐트의 식별자입니다.

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

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

: 필수 예

localeId

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

: 필수 예

요청 본문

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

description

슬롯에 대한 설명입니다. 이 옵션을 사용하면 목록에서 슬롯을 식별할 수 있습니다.

Type: 문자열

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

: 필수 아니요

multipleValuesSetting

슬롯이 하나의 응답으로 여러 값을 반환하는지 여부를 나타냅니다. 다중 값 슬롯은 en-US 로캘에서만 사용할 수 있습니다. 이 값을 로 설정한 경우true다른 로케일에서는 Amazon Lex가ValidationException.

만약multipleValuesSetting는 설정되지 않습니다. 기본값은 다음과 같습니다.false.

유형: MultipleValuesSetting 객체

: 필수 아니요

obfuscationSetting

Amazon CloudWatch 로그에서 슬롯 값이 사용되는 방법을 결정합니다. 의 값인 경우obfuscationSetting매개 변수는DefaultObfuscation, 슬롯 값은 로그 출력에서 난독화됩니다. 값이 다음과 같을 경우None로그 출력에 실제 값이 있습니다.

기본값은 CloudWatch 로그의 값을 난독화하는 것입니다.

유형: ObfuscationSetting 객체

: 필수 아니요

slotName

슬롯의 이름 슬롯이 포함된 봇에서 슬롯 이름이 고유해야 합니다.

Type: 문자열

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

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

: 필수 예

slotTypeId

이 슬롯과 연관된 슬롯 유형에 대한 고유 식별자입니다. 슬롯 유형에 따라 슬롯에 입력할 수 있는 값이 결정됩니다.

Type: 문자열

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

Pattern: ^((AMAZON\.)[a-zA-Z_]+?|[0-9a-zA-Z]+)$

: 필수 예

valueElicitationSetting

슬롯 값을 제공하는 응답을 유도하기 위해 Amazon Lex가 사용자에게 보내는 프롬프트를 지정합니다.

유형: SlotValueElicitationSetting 객체

: 필수 예

응답 구문

HTTP/1.1 200 Content-type: application/json { "botId": "string", "botVersion": "string", "creationDateTime": number, "description": "string", "intentId": "string", "localeId": "string", "multipleValuesSetting": { "allowMultipleValues": boolean }, "obfuscationSetting": { "obfuscationSettingType": "string" }, "slotId": "string", "slotName": "string", "slotTypeId": "string", "valueElicitationSetting": { "defaultValueSpecification": { "defaultValueList": [ { "defaultValue": "string" } ] }, "promptSpecification": { "allowInterrupt": boolean, "maxRetries": number, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] }, "sampleUtterances": [ { "utterance": "string" } ], "slotConstraint": "string", "waitAndContinueSpecification": { "active": boolean, "continueResponse": { "allowInterrupt": boolean, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] }, "stillWaitingResponse": { "allowInterrupt": boolean, "frequencyInSeconds": number, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ], "timeoutInSeconds": number }, "waitingResponse": { "allowInterrupt": boolean, "messageGroups": [ { "message": { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } }, "variations": [ { "customPayload": { "value": "string" }, "imageResponseCard": { "buttons": [ { "text": "string", "value": "string" } ], "imageUrl": "string", "subtitle": "string", "title": "string" }, "plainTextMessage": { "value": "string" }, "ssmlMessage": { "value": "string" } } ] } ] } } } }

응답 요소

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

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

botId

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

Type: 문자열

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

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

botVersion

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

Type: 문자열

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

Pattern: ^DRAFT$

creationDateTime

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

Type: 타임스탬프

description

슬롯과 연관된 설명입니다.

Type: 문자열

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

intentId

슬롯과 연결된 의도의 고유 식별자입니다.

Type: 문자열

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

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

localeId

슬롯에 지정된 언어 및 로컬입니다.

Type: 문자열

multipleValuesSetting

슬롯이 하나의 응답으로 여러 값을 반환하는지 여부를 나타냅니다.

유형: MultipleValuesSetting 객체

obfuscationSetting

슬롯이 Amazon CloudWatch 로그에서 값을 난독화하도록 구성되었는지 여부를 나타냅니다.

유형: ObfuscationSetting 객체

slotId

슬롯과 연결된 고유 식별자입니다. 슬롯을 업데이트하거나 삭제할 때 슬롯을 식별하려면 이 옵션을 사용합니다.

Type: 문자열

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

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

slotName

슬롯에 지정된 이름

Type: 문자열

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

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

slotTypeId

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

Type: 문자열

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

Pattern: ^((AMAZON\.)[a-zA-Z_]+?|[0-9a-zA-Z]+)$

valueElicitationSetting

슬롯에 대해 지정된 값 유도 설정입니다.

유형: SlotValueElicitationSetting 객체

오류

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

ConflictException

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

HTTP 상태 코드: 409

InternalServerException

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

HTTP 상태 코드: 500

PreconditionFailedException

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

HTTP 상태 코드: 412

ServiceQuotaExceededException

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

HTTP 상태 코드: 402

ThrottlingException

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

HTTP 상태 코드: 429

ValidationException

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

HTTP 상태 코드: 400

참고 항목

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