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: come funziona.

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

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 a un nome di tipo di slot integrato con «AMAZON». rimosso. Ad esempio, poiché esiste un tipo di slot integrato chiamatoAMAZON.DATE, non è possibile creare un tipo di slot personalizzato chiamatoDATE.

Per un elenco dei tipi di slot integrati, consulta Slot Type Reference nell'Alexa Skills Kit.

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

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

Campo obbligatorio: sì

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

checksum

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'BadRequestExceptioneccezione.

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

Campo obbligatorio: no

createVersion

Se impostato su true una nuova versione numerata dello slot, viene creato un tipo di slot. Equivale a chiamare l'CreateSlotTypeVersionoperazione. Se non si specificacreateVersion, l'impostazione predefinita èfalse.

Tipo: Booleano

Campo obbligatorio: no

description

Una descrizione del tipo di slot.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

Campo obbligatorio: no

enumerationValues

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

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 articoli.

Campo obbligatorio: no

parentSlotTypeSignature

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: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

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

Campo obbligatorio: no

slotTypeConfigurations

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

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

Campo obbligatorio: no

valueSelectionStrategy

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 ilvalueSelectionStrategy, l'impostazione predefinita èORIGINAL_VALUE.

▬Tipo: stringa

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

Checksum della $LATEST versione del tipo di slot.

▬Tipo: stringa

createdDate

La data di creazione del tipo di slot.

Tipo: Timestamp

createVersion

Truese è 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

Una descrizione del tipo di slot.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 200.

enumerationValues

Un elenco di EnumerationValue oggetti che definisce i valori che il tipo di slot può assumere.

Tipo: matrice di oggetti EnumerationValue

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10000 elementi.

lastUpdatedDate

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

Il nome del tipo di slot.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

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

parentSlotTypeSignature

Il tipo di slot integrato utilizzato come elemento principale del tipo di slot.

▬Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 100.

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

slotTypeConfigurations

Informazioni di configurazione che estendono il tipo di slot integrato principale.

Tipo: matrice di oggetti SlotTypeConfiguration

Membri dell'array: numero minimo di 0 elementi. Numero massimo di 10 elementi.

valueSelectionStrategy

La strategia di risoluzione degli slot utilizzata da Amazon Lex per determinare il valore dello slot. Per ulteriori informazioni, consulta PutSlotType.

▬Tipo: stringa

Valori validi: ORIGINAL_VALUE | TOP_RESOLUTION

version

La versione del tipo di slot. Per un nuovo tipo di slot, la versione è sempre$LATEST.

▬Tipo: stringa

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 uno degli AWS SDK specifici della lingua, consulta quanto segue:

• Interfaccia a riga di comando AWS

• AWS SDK per.NET

• AWS SDK per C++

• AWS SDK per Go v2

• AWS SDK per Java V2

• AWS SDK per V3 JavaScript

• AWS SDK per PHP V3

• AWS SDK per Python

• AWS SDK per Ruby V3