Request Syntax URI 요청 파라미터 요청 본문 응답 구문 응답 요소 Errors 참고

PutSlotType

사용자 지정 슬롯 유형을 생성하거나 기존 사용자 지정 슬롯 유형을 교체합니다.

사용자 정의 슬롯 유형을 생성하려면 슬롯 유형의 이름과 이 유형의 슬롯이 가정할 수 있는 값인 열거 값 세트를 지정합니다. 자세한 내용은 Amazon Lex: 작동 방식을 참조하세요.

기존 슬롯 유형의 이름을 지정하는 경우, 요청의 필드가 슬롯 유형의 $LATEST 버전의 기존 값을 대체합니다. Amazon Lex는 요청에서 제공하지 않은 필드를 제거합니다. 필수 필드 값을 지정하지 않으면 Amazon Lex에서 예외가 발생합니다. 슬롯 유형의 $LATEST 버전을 업데이트할 때 봇이 슬롯 유형을 포함하는 의도 $LATEST 버전을 사용하는 경우 봇의 status 필드는 NOT_BUILT로 설정됩니다.

이 작업에는 lex:PutSlotType 액션에 대한 권한이 필요합니다.

Request Syntax


PUT /slottypes/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string"
}

URI 요청 파라미터

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

name

슬롯 유형의 이름. 이름은 대/소문자를 구분하지 않습니다.

이름은 기본 제공 의도 이름 또는 "AMAZON"이라고 표시된 기본 제공 의도 이름과 일치할 수 없습니다. 제거됨. 예를 들어 AMAZON.DATE라는 기본 제공 슬롯 유형이 있기 때문에 DATE 라는 사용자 지정 슬롯 유형을 생성할 수 없습니다.

사용 가능한 기본 제공 슬롯 유형의 목록은 Alexa Skills Kit의 슬롯 유형 참고 자료를 참조하십시오.

길이 제약: 최소 길이 1. 최대 길이는 100.

패턴: ^([A-Za-z]_?)+$

필수 사항 여부: Yes

요청 본문

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

checksum

$LATEST 버전의 특정 개정 버전을 식별합니다.

새 봇을 만들 때는 checksum 필드를 비워 두십시오. 체크섬을 지정하면 BadRequestException 예외가 발생합니다.

봇을 업데이트하려면 checksum 필드를 해당 버전의 $LATEST 버전의 최신 개정의 체크섬으로 설정하십시오. checksum 필드를 지정하지 않거나 체크섬이 $LATEST 버전과 일치하지 않으면 PreconditionFailedException 예외가 발생합니다.

타입: 문자열

필수사항: 아니요

createVersion

true로 설정하면 번호가 매겨진 새 버전의 슬롯 유형이 생성됩니다. 이는 CreateSlotTypeVersion 작업을 호출하는 것과 같습니다. createVersion를 지정하지 않으면 기본값은 false입니다.

타입: 부울

필수 항목 여부: 아니요

description

슬롯 유형에 대한 설명.

타입: 문자열

길이 제한: 최소 길이는 0. 최대 길이는 200.

필수 여부: 아니요

enumerationValues

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

정규 표현식 슬롯 유형에는 열거형 값이 필요하지 않습니다. 다른 모든 슬롯 유형에는 열거값 목록이 필요합니다.

Amazon Lex는 슬롯 값을 확인할 때 슬롯에 사용할 수 있는 값을 최대 5개까지 포함하는 확인 목록을 생성합니다. Lambda 함수를 사용하는 경우 이 확인 목록이 함수에 전달됩니다. Lambda 함수를 사용하지 않는 경우 사용자가 입력한 값을 반환하거나 확인 목록의 첫 번째 값을 슬롯 값으로 반환하도록 선택할 수 있습니다. valueSelectionStrategy 필드는 사용할 옵션을 나타냅니다.

유형: EnumerationValue객체 어레이

배열 멤버: 최소 항목 수 0개. 최대 항목 수 10,000개.

필수 여부: 아니요

parentSlotTypeSignature

이 슬롯 유형의 상위 슬롯 유형으로 사용되는 기본 제공 슬롯 유형. 상위 슬롯 유형을 정의하면 새 슬롯 유형은 상위 슬롯 유형과 구성이 모두 동일합니다.

AMAZON.AlphaNumeric만 지원됩니다.

유형: 문자열

길이 제약: 최소 길이는 1. 최대 길이는 100.

패턴: ^((AMAZON\.)_?|[A-Za-z]_?)+

Required: No

slotTypeConfigurations

상위 기본 제공 슬롯 유형을 확장하는 구성 정보. 구성이 상위 슬롯 유형의 설정에 추가됩니다.

유형: SlotTypeConfiguration객체 어레이

배열 멤버: 최소 항목 수는 0개. 최대 항목 수 10개.

필수 여부: 아니요

valueSelectionStrategy

Amazon Lex가 슬롯 유형 값을 반환하는 데 사용하는 슬롯 확인 전략을 결정합니다. 다음 값 중 하나로 필드를 설정할 수 있습니다.

ORIGINAL_VALUE - 사용자 값이 슬롯 값과 유사한 경우 사용자가 입력한 값을 반환합니다.
TOP_RESOLUTION - 슬롯에 대한 확인 목록이 있는 경우 확인 목록의 첫 번째 값을 슬롯 유형 값으로 반환합니다. 확인 목록이 없으면 null이 반환됩니다.

valueSelectionStrategy를 지정하지 않으면 기본값은 ORIGINAL_VALUE입니다.

타입: 문자열

유효 값: ORIGINAL_VALUE | TOP_RESOLUTION

필수 항목 여부: 아니요

응답 구문


HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}