PutSlotType

焦點模式

PutSlotType - Amazon Lex V1

支援終止通知：在 2025 年 9 月 15 日， AWS 將停止對 Amazon Lex V1 的支援。2025 年 9 月 15 日之後，您將無法再存取 Amazon Lex V1 主控台或 Amazon Lex V1 資源。如果您使用的是 Amazon Lex V2，請改參閱 Amazon Lex V2 指南。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立自訂插槽類型或取代現有的自訂插槽類型。

若要建立自訂插槽類型，請指定插槽類型的名稱和一組列舉值，這些是此類型插槽可擔任的值。如需詳細資訊，請參閱Amazon Lex：運作方式。

如果您指定現有插槽類型的名稱，請求中的欄位會取代插槽類型$LATEST版本中的現有值。Amazon Lex 會移除您在請求中未提供的欄位。如果您未指定必要欄位，Amazon Lex 會擲回例外狀況。當您更新插槽類型的$LATEST版本時，如果機器人使用包含插槽類型的意圖$LATEST版本，機器人status的欄位會設定為 NOT_BUILT。

這項操作需要 lex:PutSlotType 動作的許可。

請求語法


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]_?)+$

必要：是

請求主體

請求接受採用 JSON 格式的下列資料。

checksum

識別 $LATEST版本的特定修訂。

當您建立新的插槽類型時，請將checksum欄位保留空白。如果您指定檢查總和，您會收到BadRequestException例外狀況。

當您想要更新插槽類型時，請將 checksum 欄位設定為最新版本的檢查總和$LATEST。如果您未指定 checksum 欄位，或者檢查總和與$LATEST版本不相符，則會收到PreconditionFailedException例外狀況。

類型：字串

必要：否

createVersion

當設定為true新編號版本的槽類型時，即會建立。這與呼叫 CreateSlotTypeVersion操作相同。如果您未指定 createVersion，則預設為 false。

類型：布林值

必要：否

description

位置類型的描述。

類型：字串

長度限制：長度下限為 0。長度上限為 200。

必要：否

enumerationValues

定義槽類型可採用之值的EnumerationValue物件清單。每個值都可以有一個清單synonyms，這些值有助於訓練機器學習模型有關其針對插槽解析的值。

規則表達式槽類型不需要列舉值。所有其他槽類型都需要列舉值的清單。

當 Amazon Lex 解析槽值時，會產生解析度清單，其中包含最多五個槽的可能值。如果您使用 Lambda 函數，此解析清單會傳遞給函數。如果您未使用 Lambda 函數，您可以選擇傳回使用者輸入的值，或解析清單中的第一個值作為槽值。valueSelectionStrategy 欄位指出要使用的選項。

類型：EnumerationValue 物件陣列

陣列成員：項目數下限為 0。10000 個項目的數量上限。

必要：否

parentSlotTypeSignature

做為插槽類型父項的內建插槽類型。當您定義父槽類型時，新的槽類型與父槽類型具有所有相同的組態。

僅支援 AMAZON.AlphaNumeric。

類型：字串

長度限制：長度下限為 1。長度上限為 100。

模式：^((AMAZON\.)_?|[A-Za-z]_?)+

必要：否

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