CreateIntentVersion - 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.

CreateIntentVersion

Crea una nueva versión de una intención basada en la versión $LATEST de la intención. Si la versión $LATEST de esta intención no ha cambiado desde que se actualizó por última vez, Amazon Lex no crea una nueva versión. Devuelve la última versión creada.

nota

Puede actualizar únicamente la versión $LATEST de la intención. No puede actualizar las versiones numeradas que ha creado con la operación CreateIntentVersion.

Al crear una versión de una intención, 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.

Esto operación requiere permisos para realizar la acción lex:CreateIntentVersion.

Sintaxis de la solicitud

POST /intents/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 de la intención 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 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

La suma de comprobación de la versión $LATEST de la intención que se debe utilizar para crear la nueva versión. Si especifica una suma de comprobación y la versión $LATEST de la intención tiene una suma de comprobación diferente, Amazon Lex devuelve una excepción PreconditionFailedException y 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

{
   "checksum": "string",
   "conclusionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "confirmationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "dialogCodeHook": { 
      "messageVersion": "string",
      "uri": "string"
   },
   "followUpPrompt": { 
      "prompt": { 
         "maxAttempts": number,
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      },
      "rejectionStatement": { 
         "messages": [ 
            { 
               "content": "string",
               "contentType": "string",
               "groupNumber": number
            }
         ],
         "responseCard": "string"
      }
   },
   "fulfillmentActivity": { 
      "codeHook": { 
         "messageVersion": "string",
         "uri": "string"
      },
      "type": "string"
   },
   "inputContexts": [ 
      { 
         "name": "string"
      }
   ],
   "kendraConfiguration": { 
      "kendraIndex": "string",
      "queryFilterString": "string",
      "role": "string"
   },
   "lastUpdatedDate": number,
   "name": "string",
   "outputContexts": [ 
      { 
         "name": "string",
         "timeToLiveInSeconds": number,
         "turnsToLive": number
      }
   ],
   "parentIntentSignature": "string",
   "rejectionStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "sampleUtterances": [ "string" ],
   "slots": [ 
      { 
         "defaultValueSpec": { 
            "defaultValueList": [ 
               { 
                  "defaultValue": "string"
               }
            ]
         },
         "description": "string",
         "name": "string",
         "obfuscationSetting": "string",
         "priority": number,
         "responseCard": "string",
         "sampleUtterances": [ "string" ],
         "slotConstraint": "string",
         "slotType": "string",
         "slotTypeVersion": "string",
         "valueElicitationPrompt": { 
            "maxAttempts": number,
            "messages": [ 
               { 
                  "content": "string",
                  "contentType": "string",
                  "groupNumber": number
               }
            ],
            "responseCard": "string"
         }
      }
   ],
   "version": "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.

checksum

La suma de comprobación de la versión de la intención creada.

Tipo: cadena

conclusionStatement

Una vez que la función de Lambda especificada en el campo fulfillmentActivity cumple con la intención, Amazon Lex transmite esta afirmación al usuario.

Tipo: objeto Statement

confirmationPrompt

Si se define, la solicitud que Amazon Lex utiliza para confirmar la intención del usuario antes de cumplirla.

Tipo: objeto Prompt

createdDate

La fecha en que se creó la intención.

Tipo: marca temporal

description

Una descripción de la intención.

Tipo: cadena

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

dialogCodeHook

Si está definida, Amazon Lex invoca esta función de Lambda para cada entrada del usuario.

Tipo: objeto CodeHook

followUpPrompt

Si se define, Amazon Lex utiliza esta solicitud para solicitar actividad adicional del usuario una vez que se ha cumplido con la intención.

Tipo: objeto FollowUpPrompt

fulfillmentActivity

Describe cómo se cumple con la intención.

Tipo: objeto FulfillmentActivity

inputContexts

Una matriz de objetos InputContext que enumera los contextos que deben estar activos para que Amazon Lex elija la intención en una conversación con el usuario.

Tipo: matriz de objetos InputContext

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

kendraConfiguration

Información sobre la configuración necesaria, si procede, para conectar un índice de Amazon Kendra con la intención AMAZON.KendraSearchIntent.

Tipo: objeto KendraConfiguration

lastUpdatedDate

La fecha de actualización de la intención.

Tipo: marca temporal

name

El nombre de la intención.

Tipo: string

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

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

outputContexts

Una matriz de objetos OutputContext que enumera los contextos en los que la intención se activa cuando esta se cumple.

Tipo: matriz de objetos OutputContext

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

parentIntentSignature

Un identificador único para una intención integrada.

Tipo: cadena

rejectionStatement

Si el usuario responde “no” a la pregunta definida en confirmationPrompt, Amazon Lex responde con esta afirmación para confirmar que la intención se ha cancelado.

Tipo: objeto Statement

sampleUtterances

Una matriz de ejemplos de enunciados configurados para la intención.

Tipo: matriz de cadenas

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

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

slots

Una matriz de tipos de ranura que define la información necesaria para cumplir con la intención.

Tipo: matriz de objetos Slot

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

version

El número de versión asignado a la nueva versión de la intención.

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

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: