CreateBotVersion

Crea una nueva versión del bot basada en la versión $LATEST. Si la versión $LATEST de este recurso no ha cambiado desde que creó la última versión, Amazon Lex no crea una nueva versión. Devuelve la última versión creada.

nota

Puede actualizar únicamente la versión $LATEST del bot. No puede actualizar las versiones numeradas que ha creado con la operación CreateBotVersion.

Al crear la primera versión de un bot, Amazon Lex establece la versión en 1. Las versiones subsiguientes se incrementan en 1. Para obtener más información, consulte Control de versiones.

Esta operación necesita permiso para la acción lex:CreateBotVersion.

Sintaxis de la solicitud

POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

name

El nombre del bot a partir del cual desea crear una nueva versión. El nombre distingue entre mayúsculas y minúsculas.

Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 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 especifica de la versión $LATEST del bot. Si especifica una suma de comprobación y la versión $LATEST del bot tiene una suma de comprobación diferente, se devuelve una excepción PreconditionFailedException y Amazon Lex no publica una nueva versión. Si no especifica una suma de comprobación, Amazon Lex publica la versión $LATEST.

Tipo: cadena

Requerido: no

Sintaxis de la respuesta

HTTP/1.1 201
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}

Elementos de respuesta

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

El servicio devuelve los datos siguientes en formato JSON.

abortStatement

El mensaje que Amazon Lex utiliza para cancelar una conversación. Para obtener más información, consulte PutBot.

Tipo: objeto Statement

checksum

La suma de comprobación que identifica la versión del bot que se ha creado.

Tipo: cadena

childDirected

Para cada bot de Amazon Lex creado con el Servicio de creación de modelos de Amazon Lex, debe especificar si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que esté dirigido, total o parcialmente, a niños menores de 13 años y esté sujeto a la Ley de protección de la privacidad infantil en línea (COPPA, por sus siglas en inglés). Para ello, especifique true o false en el campo childDirected. Al especificar true en el campo childDirected, confirma que el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. Al especificar false en el campo childDirected, confirma que el uso de Amazon Lex no está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA. No puede especificar un valor predeterminado en el campo childDirected que no indique de forma precisa si el uso de Amazon Lex está relacionado o no con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años y está sujeto a la COPPA.

Si el uso de Amazon Lex está relacionado con un sitio web, un programa u otro tipo de aplicación que está dirigido, total o parcialmente, a niños menores de 13 años, debe obtener un consentimiento parental verificable, obligatorio en virtud de la COPPA. Para obtener información acerca del uso de Amazon Lex con relación a sitios web, programas u otras aplicaciones dirigidos, total o parcialmente, a niños menores de 13 años, consulte las Preguntas frecuentes de Amazon Lex.

Tipo: Booleano

clarificationPrompt

El mensaje que Amazon Lex utiliza cuando no comprende la solicitud del usuario. Para obtener más información, consulte PutBot.

Tipo: objeto Prompt

createdDate

La fecha en que se creó la versión del bot.

Tipo: marca temporal

description

La descripción del bot.

Tipo: cadena

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

detectSentiment

Indica si los enunciados que ha introducido el usuario deben enviarse a Amazon Comprehend con fines de análisis de opiniones.

Tipo: Booleano

enableModelImprovements

Indica si el bot utiliza mejoras en la precisión. true indica que el bot utiliza las mejoras y false, lo contrario.

Tipo: Booleano

failureReason

Si status es FAILED, Amazon Lex proporciona el motivo por el que no se ha podido crear el bot.

Tipo: cadena

idleSessionTTLInSeconds

El tiempo máximo que Amazon Lex retiene los datos recopilados en una conversación, en segundos. Para obtener más información, consulte PutBot.

Tipo: entero

Rango válido: valor mínimo de 60. Valor máximo de 86 400.

intents

Una matriz de objetos Intent. Para obtener más información, consulte PutBot.

Tipo: matriz de objetos Intent

lastUpdatedDate

La fecha en la que se actualizó la versión $LATEST de este bot.

Tipo: marca temporal

locale

Especifica la configuración regional de destino para el bot.

Tipo: cadena

Valores válidos: de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

name

El nombre del bot.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 50 caracteres.

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

status

Cuando envía una solicitud para crear o actualizar un bot, Amazon Lex establece el elemento de respuesta status en BUILDING. Una vez que Amazon Lex ha creado el bot, se establece status en READY. Si Amazon Lex no puede crear el bot, se establece status en FAILED. Amazon Lex devuelve el motivo del error en el elemento de respuesta failureReason.

Tipo: cadena

Valores válidos: BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT

version

La versión del bot.

Tipo: string

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

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

voiceId

El ID de voz de Amazon Polly que Amazon Lex utiliza para las interacciones de voz con el usuario.

Tipo: cadena

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

NotFoundException

No se ha encontrado el recurso especificado en la solicitud. Compruebe si el recurso existe e inténtelo de nuevo.

Código de estado HTTP: 404

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:

• Interfaz de la línea de comandos de AWS

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go v2

• AWS SDK para Java V2

• AWS SDK para JavaScript V3

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3