PutSlotType - Amazon Lex V1
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.

 

Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

PutSlotType

Crea un tipo de ranura personalizado o sustituye un tipo de ranura personalizado existente.

Para crear un tipo de ranura personalizado, especifique un nombre para el tipo de ranura y un conjunto de valores de enumeración, que son los valores que puede asumir una ranura de este tipo. Para obtener más información, consulte Funcionamiento de Amazon Lex.

Si especifica el nombre de un tipo de ranura existente, los campos de la solicitud reemplazan los valores existentes en la versión $LATEST del tipo de ranura. Amazon Lex elimina los campos que no ha proporcionado en la solicitud. Si no especifica los campos obligatorios, Amazon Lex devuelve una excepción. Al actualizar la versión $LATEST de un tipo de ranura, si el bot utiliza la versión $LATEST de una intención que contiene el tipo de ranura, el campo status del bot se establece en NOT_BUILT.

Esta operación necesita permisos para la acción lex:PutSlotType.

Sintaxis de la solicitud

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

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

name

El nombre del tipo de slot. El nombre no distingue entre mayúsculas y minúsculas.

El nombre no puede coincidir con el nombre de un tipo de ranura integrado o con el nombre de un tipo de ranura integrado con la parte “AMAZON.” eliminada. Por ejemplo, como hay un tipo de ranura integrado con el nombre AMAZON.DATE, no puede crear un tipo de ranura personalizado con el nombre DATE.

Para obtener una lista con los tipos de ranura integrados, consulte Referencia del tipo de ranura en Alexa Skills Kit.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

Patrón: ^([A-Za-z]_?)+$

Obligatorio: sí

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

checksum

Identifica una revisión específica de la versión $LATEST.

Si crea un nuevo tipo de ranura, deje el campo checksum vacío. Si especifica una suma de comprobación, obtendrá una excepción BadRequestException.

Cuando quiera actualizar un tipo de ranura, establezca el campo checksum en la suma de comprobación de la revisión más reciente de la versión $LATEST. Si no especifica el campo checksum o si la suma de comprobación no coincide con la versión $LATEST, obtendrá una excepción PreconditionFailedException.

Tipo: cadena

Requerido: no

createVersion

Cuando se establece en true, se crea una nueva versión numerada del tipo de ranura. Se produce lo mismo que al llamar a la operación CreateSlotTypeVersion. Si no especifica createVersion, el valor predeterminado es false.

Tipo: Booleano

Obligatorio: no

description

Una descripción del tipo de slot.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

Obligatorio: no

enumerationValues

Una lista de objetos EnumerationValue que define los valores que puede tomar el tipo de ranura. Cada valor puede tener una lista de synonyms, que son valores adicionales que ayudan a entrenar el modelo de machine learning sobre los valores que resuelve para una ranura.

Un tipo de ranura de expresión regular no requiere valores de enumeración. Todos los demás tipos de ranuras requieren una lista de valores de enumeración.

Cuando Amazon Lex resuelve el valor de una ranura, genera una lista de resoluciones que contiene hasta cinco valores posibles para la ranura. Si utiliza una función de Lambda, esta lista de resoluciones se pasa a la función. Si no utiliza una función de Lambda, puede elegir que devuelva el valor que el usuario ha introducido o el primer valor de la lista de resoluciones como el valor de la ranura. El campo valueSelectionStrategy indica la opción que se utiliza.

Tipo: matriz de objetos EnumerationValue

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.

Obligatorio: no

parentSlotTypeSignature

El tipo de ranura integrado que se utiliza como principal para este tipo de ranura. Al definir un tipo de ranura principal, el nuevo tipo de ranura tiene la misma configuración que el tipo de ranura principal.

Solo se admite AMAZON.AlphaNumeric.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

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

Obligatorio: no

slotTypeConfigurations

Información sobre la configuración que amplía el tipo de ranura integrado principal. La configuración se agrega a la configuración del tipo de ranura principal.

Tipo: matriz de objetos SlotTypeConfiguration

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

Obligatorio: no

valueSelectionStrategy

Determina la estrategia de resolución de ranura que Amazon Lex utiliza para devolver valores de tipo de ranura. El campo se puede establecer en uno de los siguientes valores:

  • ORIGINAL_VALUE: devuelve el valor que ha introducido el usuario, si el valor del usuario es similar a un valor de ranura.

  • TOP_RESOLUTION: si hay una lista de resoluciones para la ranura, devuelve el primer valor de la lista de resoluciones como el valor del tipo de ranura. Si no hay lista de resoluciones, se devuelve un valor null (nulo).

Si no especifica valueSelectionStrategy, el valor predeterminado es ORIGINAL_VALUE.

Tipo: cadena

Valores válidos: ORIGINAL_VALUE | TOP_RESOLUTION

Obligatorio: no

Sintaxis de la respuesta

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

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

checksum

La suma de comprobación de la versión $LATEST del tipo de ranura.

Tipo: cadena

createdDate

La fecha de creación del tipo de ranura.

Tipo: marca temporal

createVersion

Es True si se ha creado una nueva versión del tipo de ranura. Si el campo createVersion no se ha especificado en la solicitud, el campo createVersion se establece en “false” en la respuesta.

Tipo: Booleano

description

Una descripción del tipo de slot.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 200 caracteres.

enumerationValues

Una lista de objetos EnumerationValue que define los valores que puede tomar el tipo de ranura.

Tipo: matriz de objetos EnumerationValue

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 10 000 elementos.

lastUpdatedDate

La fecha de actualización del tipo de ranura. Cuando se crea un tipo de recurso, la fecha de creación y la fecha de la última actualización son la misma.

Tipo: marca temporal

name

El nombre del tipo de slot.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

Patrón: ^([A-Za-z]_?)+$

parentSlotTypeSignature

El tipo de ranura integrado que se utiliza como principal para este tipo de ranura.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.

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

slotTypeConfigurations

Información sobre la configuración que amplía el tipo de ranura integrado principal.

Tipo: matriz de objetos SlotTypeConfiguration

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 10 artículos.

valueSelectionStrategy

La estrategia de resolución de ranura que Amazon Lex utiliza para determinar el valor de la ranura. Para obtener más información, consulte PutSlotType.

Tipo: cadena

Valores válidos: ORIGINAL_VALUE | TOP_RESOLUTION

version

La versión del tipo de ranura. En el caso de un tipo de ranura nuevo, la versión es siempre $LATEST.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: \$LATEST|[0-9]+

Errores

BadRequestException

La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.

Código de estado HTTP: 400

ConflictException

Se ha producido un conflicto al procesar la solicitud. Intente volver a realizar la solicitud.

Código de estado HTTP: 409

InternalFailureException

Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.

Código de estado HTTP: 500

LimitExceededException

La solicitud ha superado un límite. Intente volver a realizar la solicitud.

Código de estado HTTP: 429

PreconditionFailedException

La suma de comprobación del recurso que intenta modificar no coincide con la suma de comprobación de la solicitud. Revise la suma de comprobación del recurso e inténtelo de nuevo.

Código de estado HTTP: 412

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: