요청 구문 URI 요청 파라미터 요청 본문 응답 구문 응답 요소 오류 참고 항목

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"
   }
}