Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # PutSlotType Crea un tipo di slot personalizzato o sostituisce un tipo di slot personalizzato esistente. Per creare un tipo di slot personalizzato, specificate un nome per il tipo di slot e un set di valori di enumerazione, che sono i valori che uno slot di questo tipo può assumere. Per ulteriori informazioni, consulta [Amazon Lex: come funziona](how-it-works.md). Se specificate il nome di un tipo di slot esistente, i campi della richiesta sostituiscono i valori esistenti nella `$LATEST` versione del tipo di slot. Amazon Lex rimuove i campi che non fornisci nella richiesta. Se non specifichi i campi obbligatori, Amazon Lex genera un'eccezione. Quando aggiorni la `$LATEST` versione di un tipo di slot, se un bot utilizza la `$LATEST` versione di un intento che contiene il tipo di slot, il `status` campo del bot viene impostato su. `NOT_BUILT` Questa operazione richiede le autorizzazioni per l'operazione `lex:PutSlotType`. ## Sintassi della richiesta ``` 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" } ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [name](#API_PutSlotType_RequestSyntax) ** Il nome del tipo di slot. Il nome *non* fa distinzione tra maiuscole e minuscole. Il nome non può corrispondere al nome di un tipo di slot integrato o al nome di un tipo di slot integrato con «AMAZON». rimosso. Ad esempio, poiché esiste un tipo di slot integrato chiamato`AMAZON.DATE`, non è possibile creare un tipo di slot personalizzato chiamato`DATE`. Per un elenco dei tipi di slot integrati, consulta [Slot Type Reference](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/built-in-intent-ref/slot-type-reference) nell'*Alexa Skills Kit*. Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100. Modello: `^([A-Za-z]_?)+$` Obbligatorio: sì ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [checksum](#API_PutSlotType_RequestSyntax) ** Identifica una revisione specifica della versione. `$LATEST` Quando crei un nuovo tipo di slot, lascia il `checksum` campo vuoto. Se si specifica un checksum si ottiene un'`BadRequestException`eccezione. Quando desideri aggiornare un tipo di slot, imposta il `checksum` campo sul checksum della revisione più recente della versione. `$LATEST` Se non specifichi il ` checksum` campo o se il checksum non corrisponde alla `$LATEST` versione, ottieni un'eccezione. `PreconditionFailedException` ▬Tipo: stringa Obbligatorio: no ** [createVersion](#API_PutSlotType_RequestSyntax) ** Se impostato su `true` una nuova versione numerata dello slot, viene creato un tipo di slot. Equivale a chiamare l'`CreateSlotTypeVersion`operazione. Se non si specifica`createVersion`, l'impostazione predefinita è`false`. Tipo: Booleano Obbligatorio: no ** [description](#API_PutSlotType_RequestSyntax) ** Una descrizione del tipo di slot. Tipo: String Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200. Obbligatorio: no ** [enumerationValues](#API_PutSlotType_RequestSyntax) ** Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere. Ogni valore può avere un elenco di `synonyms` valori aggiuntivi che aiutano ad addestrare il modello di apprendimento automatico sui valori che risolve per uno slot. Un tipo di slot per espressioni regolari non richiede valori di enumerazione. Tutti gli altri tipi di slot richiedono un elenco di valori di enumerazione. Quando Amazon Lex risolve un valore di slot, genera un elenco di risoluzione che contiene fino a cinque valori possibili per lo slot. Se si utilizza una funzione Lambda, questo elenco di risoluzioni viene passato alla funzione. Se non si utilizza una funzione Lambda, è possibile scegliere di restituire il valore immesso dall'utente o il primo valore nell'elenco delle risoluzioni come valore dello slot. Il `valueSelectionStrategy` campo indica l'opzione da utilizzare. Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 articoli. Obbligatorio: no ** [parentSlotTypeSignature](#API_PutSlotType_RequestSyntax) ** Il tipo di slot integrato utilizzato come elemento principale del tipo di slot. Quando si definisce un tipo di slot principale, il nuovo tipo di slot presenta la stessa configurazione dello slot principale. Solo `AMAZON.AlphaNumeric`è supportata. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100. Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+` Obbligatorio: no ** [slotTypeConfigurations](#API_PutSlotType_RequestSyntax) ** Informazioni di configurazione che estendono il tipo di slot integrato principale. La configurazione viene aggiunta alle impostazioni per il tipo di slot principale. Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi. Obbligatorio: no ** [valueSelectionStrategy](#API_PutSlotType_RequestSyntax) ** Determina la strategia di risoluzione degli slot utilizzata da Amazon Lex per restituire i valori del tipo di slot. Il campo può essere impostato su uno dei seguenti valori: + `ORIGINAL_VALUE`- Restituisce il valore inserito dall'utente, se il valore utente è simile al valore dello slot. + `TOP_RESOLUTION`- Se esiste un elenco di risoluzioni per lo slot, restituisce il primo valore nell'elenco delle risoluzioni come valore del tipo di slot. Se non è presente un elenco di risoluzioni, viene restituito null. Se non si specifica il`valueSelectionStrategy`, l'impostazione predefinita è`ORIGINAL_VALUE`. Tipo: String Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION` Campo obbligatorio: no ## Sintassi della risposta ``` 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" } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [checksum](#API_PutSlotType_ResponseSyntax) ** Checksum della `$LATEST` versione del tipo di slot. Tipo: String ** [createdDate](#API_PutSlotType_ResponseSyntax) ** La data di creazione del tipo di slot. Tipo: Timestamp ** [createVersion](#API_PutSlotType_ResponseSyntax) ** `True`se è stata creata una nuova versione del tipo di slot. Se il `createVersion` campo non è stato specificato nella richiesta, il `createVersion` campo è impostato su false nella risposta. Tipo: Booleano ** [description](#API_PutSlotType_ResponseSyntax) ** Una descrizione del tipo di slot. Tipo: String Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200. ** [enumerationValues](#API_PutSlotType_ResponseSyntax) ** Un elenco di `EnumerationValue` oggetti che definisce i valori che il tipo di slot può assumere. Tipo: matrice di oggetti [EnumerationValue](API_EnumerationValue.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 elementi. ** [lastUpdatedDate](#API_PutSlotType_ResponseSyntax) ** La data in cui il tipo di slot è stato aggiornato. Quando si crea un tipo di slot, la data di creazione e la data dell'ultimo aggiornamento coincidono. Tipo: Timestamp ** [name](#API_PutSlotType_ResponseSyntax) ** Il nome del tipo di slot. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100. Modello: `^([A-Za-z]_?)+$` ** [parentSlotTypeSignature](#API_PutSlotType_ResponseSyntax) ** Il tipo di slot integrato utilizzato come elemento principale del tipo di slot. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100. Modello: `^((AMAZON\.)_?|[A-Za-z]_?)+` ** [slotTypeConfigurations](#API_PutSlotType_ResponseSyntax) ** Informazioni di configurazione che estendono il tipo di slot integrato principale. Tipo: matrice di oggetti [SlotTypeConfiguration](API_SlotTypeConfiguration.md) Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi. ** [valueSelectionStrategy](#API_PutSlotType_ResponseSyntax) ** La strategia di risoluzione degli slot utilizzata da Amazon Lex per determinare il valore dello slot. Per ulteriori informazioni, consulta [PutSlotType](#API_PutSlotType). Tipo: String Valori validi: `ORIGINAL_VALUE | TOP_RESOLUTION` ** [version](#API_PutSlotType_ResponseSyntax) ** La versione del tipo di slot. Per un nuovo tipo di slot, la versione è sempre`$LATEST`. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `\$LATEST|[0-9]+` ## Errori ** BadRequestException ** La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova. Codice di stato HTTP: 400 ** ConflictException ** Si è verificato un conflitto nell'elaborazione della richiesta. Riprova la richiesta. Codice di stato HTTP: 409 ** InternalFailureException ** Si è verificato un errore interno di Amazon Lex. Riprova la richiesta. Codice di stato HTTP: 500 ** LimitExceededException ** La richiesta ha superato il limite. Riprova la richiesta. Codice di stato HTTP: 429 ** PreconditionFailedException ** Il checksum della risorsa che stai cercando di modificare non corrisponde al checksum della richiesta. Controlla il checksum della risorsa e riprova. Codice di stato HTTP: 412 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/PutSlotType) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/PutSlotType) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/PutSlotType) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/PutSlotType) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/PutSlotType) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/PutSlotType) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/PutSlotType) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/PutSlotType) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/PutSlotType) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/PutSlotType)