Formato del evento de entrada y de la respuesta de la función de Lambda

currentIntent: proporciona los campos name, slots, slotDetails y confirmationStatus de la intención.

nluIntentConfidenceScore es la confianza que Amazon Lex tiene en que la intención actual es la mejor para cumplir con la intención actual del usuario.

slots es una asignación de nombre de ranura, que se configura para la intención, para rellenar las ranuras con los valores que Amazon Lex ha reconocido en la conversación con el usuario. Un valor de slot es nulo hasta que el usuario proporciona un valor.

El valor de ranura del evento de entrada podría no coincidir con uno de los valores configurados para la ranura. Por ejemplo, si el usuario responde a la pregunta “¿Qué color de automóvil prefiere?”, con “pizza”, Amazon Lex devolverá “pizza” como valor de ranura. Su función debería validar los valores para asegurarse de que tienen sentido en el contexto.

slotDetails proporciona información adicional acerca de un valor de slot. La matriz resolutions contiene una lista de los valores adicionales que se reconocen para el slot. Cada slot puede tener un máximo de cinco valores.

El campo originalValue contiene el valor que el usuario ha introducido para el slot. Cuando el tipo de slot se configura para devolver el valor de resolución superior como valor de slot, originalValue podría ser diferente al valor del campo slots.

confirmationStatus proporciona la respuesta del usuario a un mensaje de confirmación, si existe. Por ejemplo, si Amazon Lex pregunta “¿Desea pedir una pizza de quesos grande?”, el valor de este campo puede ser Confirmed o Denied en función de la respuesta del usuario. De lo contrario, el valor de este campo es None.

Si el usuario confirma la intención, Amazon Lex establece el valor del campo en Confirmed. Si el usuario deniega la intención, Amazon Lex establece el valor del campo en Denied.

En la respuesta de confirmación, un enunciado del usuario puede proporcionar actualizaciones de slot. Por ejemplo, el usuario podría decir: "sí, cambiar el tamaño a mediana". En este caso, el evento de Lambda subsiguiente tendrá el valor de ranura actualizado y PizzaSize establecerá el valor en medium. Amazon Lex establece confirmationStatus en None porque el usuario ha modificado algunos datos de ranura, de modo que la función de Lambda tiene que validar los datos del usuario.

alternativeIntents: si ha habilitado las puntuaciones de confianza, Amazon Lex devuelve hasta cuatro intenciones alternativas. Cada intención incluye una puntuación que indica el nivel de confianza que Amazon Lex tiene en que la intención es la correcta, según el enunciado del usuario.

El contenido de las intenciones alternativas es el mismo que el contenido del campo currentIntent. Para obtener más información, consulte Uso de puntuaciones de confianza.

bot: información sobre el bot que ha procesado la solicitud.

userId: este valor lo proporciona la aplicación cliente. Amazon Lex simplemente lo pasa a la función de Lambda.

inputTranscript: texto que se utiliza para procesar la solicitud.

Si la entrada era texto, el campo inputTranscript contiene el texto que ha introducido el usuario.

Si la entrada era una transmisión de audio, el campo inputTranscript contiene el texto que se ha extraído de la transmisión de audio. Este es el texto que se procesa realmente para reconocer los valores de las intenciones y slot.

invocationSource: para indicar por qué Amazon Lex llama la función de Lambda, se establece en uno de los siguientes valores:

En la configuración de una intención puede haber dos funciones de Lambda distintas, una para inicializar y validar los datos de usuario y otra para cumplir con la intención. También puede utilizar una función de Lambda para ambas acciones. En ese caso, la función de Lambda puede utilizar el valor invocationSource para seguir la ruta de código correcta.

outputDialogMode: para cada entrada de usuario, el cliente envía la solicitud a Amazon Lex mediante una de las operaciones de la API en tiempo de ejecución: PostContent o PostText. Amazon Lex utiliza los parámetros de la solicitud para determinar si la respuesta al cliente es texto o voz y define el valor de este campo según corresponda.

La función de Lambda puede utilizar esta información para generar un mensaje apropiado. Por ejemplo, si el cliente espera una respuesta de voz, la función de Lambda podría responder en formato SSML (Speech Synthesis Markup Language) en lugar de con texto.

messageVersion: la versión del mensaje que identifica el formato de los datos de evento que se van a pasar a la función de Lambda y el formato que se espera en la respuesta de la función de Lambda.

sessionAttributes: atributos de la sesión específicos de la aplicación que el cliente envía en la solicitud. Si desea que Amazon Lex los incluya en la respuesta al cliente, la función de Lambda debe devolverlos a Amazon Lex en la respuesta. Para obtener más información, consultar Definición de atributos de la sesión

requestAttributes: atributos específicos de la solicitud que el cliente envía en la solicitud. Utilice los atributos de solicitud para pasar información que no tiene por qué persistir durante toda la sesión. Si no hay atributos de solicitud, el valor será nulo. Para obtener más información, consultar Definición de los atributos de solicitud

recentIntentSummaryView: información acerca del estado de una intención. Puede consultar información acerca de las tres últimas intenciones que se hayan utilizado. Puede utilizar esta información para establecer los valores de la intención o para volver a una intención anterior. Para obtener más información, consulte Administración de sesiones con la API de Amazon Lex.

sentimentResponse: el resultado de un análisis de opiniones de Amazon Comprehend del último enunciado. Puede utilizar esta información para administrar el flujo de la conversación del bot en función del sentimiento expresado por el usuario. Para obtener más información, consulte Análisis de opiniones.

kendraResponse: el resultado de una consulta en un índice de Amazon Kendra. Solo está presente en la entrada de un enlace de código de cumplimentación y solo cuando la intención es más amplia que la intención de AMAZON.KendraSearchIntent incorporada. El campo contiene toda la respuesta de la búsqueda de Amazon Kendra. Para obtener más información, consulte AMAZON.KendraSearchIntent.

activeContexts: uno o más contextos activos durante este turno de una conversación con el usuario.

Para obtener más información, consulte Establecimiento del contexto de la intención.

Close: indica a Amazon Lex que no debe esperar una respuesta del usuario. Por ejemplo, "Your pizza order has been placed" no requiere una respuesta.

El campo fulfillmentState es obligatorio. Amazon Lex utiliza este valor para definir el campo dialogState en la respuesta PostContent o PostText a la aplicación cliente. Los campos message y responseCard son opcionales. Si no especifica un mensaje, Amazon Lex usa el mensaje de despedida o el mensaje de seguimiento que se ha configurado para la intención.

"dialogAction": {
    "type": "Close",
    "fulfillmentState": "Fulfilled or Failed",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Thanks, your pizza has been ordered."
    },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }

ConfirmIntent: informa a Amazon Lex que se espera que el usuario dé una respuesta afirmativa o negativa para confirmar o denegar la intención actual.

Debe incluir los campos intentName y slots. El campo slots debe incluir una entrada por cada uno de los slots de la intención especificada que se han rellenado. No es necesario que incluya en el campo slots una entrada para los slots sin rellenar. Debe incluir el campo message si el campo confirmationPrompt de intención es nulo. El contenido del campo message devuelto por la función de Lambda tiene prioridad sobre el objeto confirmationPrompt especificado en la intención. El campo responseCard es opcional.

"dialogAction": {
    "type": "ConfirmIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, Are you sure you want a large pizza?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }
                         

Delegate: indica a Amazon Lex que elija el siguiente paso en función de la configuración del bot. Si la respuesta no incluye atributos de sesión, Amazon Lex mantiene los atributos de sesión existentes. Si desea que un valor de slot sea nulo, no debe incluir el campo de slot en la solicitud. Se producirá una excepción DependencyFailedException si la función de cumplimentación devuelve la acción de diálogo Delegate sin eliminar ningún slot.

Los campos kendraQueryFilterString y kendraQueryRequestPayload son opcionales y solo se utilizan cuando la intención procede de la intención integrada en AMAZON.KendraSearchIntent. Para obtener más información, consulte AMAZON.KendraSearchIntent.

  "dialogAction": {
   "type": "Delegate",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "kendraQueryRequestPayload": "Amazon Kendra query",
   "kendraQueryFilterString": "Amazon Kendra attribute filters"
  }

ElicitIntent: indica a Amazon Lex que se espera que el usuario responda con un enunciado que incluya una intención. Por ejemplo, "I want a large pizza", que indica la intención OrderPizzaIntent. Por otra parte, el enunciado “large” no es suficiente para que Amazon Lex deduzca la intención del usuario.

Los campos message y responseCard son opcionales. Si no proporciona un mensaje, Amazon Lex utiliza una de las preguntas aclaratorias del bot. Si no hay ninguna pregunta aclaratoria definida, Amazon Lex devuelve la excepción 400 de solicitud errónea.

{
  "dialogAction": {
    "type": "ElicitIntent",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What can I help you with?"
    },
    "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
    }
 }                       
                        

ElicitSlot: indica a Amazon Lex que se espera que el usuario proporcione un valor de ranura en la respuesta.

Los campos intentName, slotToElicit y slots son obligatorios. Los campos message y responseCard son opcionales. Si no especifica un mensaje, Amazon Lex utiliza una de las solicitudes para obtener valores de ranura configuradas para la ranura.

  "dialogAction": {
    "type": "ElicitSlot",
    "message": {
      "contentType": "PlainText or SSML or CustomPayload",
      "content": "Message to convey to the user. For example, What size pizza would you like?"
    },
   "intentName": "intent-name",
   "slots": {
      "slot-name": "value",
      "slot-name": "value",
      "slot-name": "value"  
   },
   "slotToElicit" : "slot-name",
   "responseCard": {
      "version": integer-value,
      "contentType": "application/vnd.amazonaws.card.generic",
      "genericAttachments": [
          {
             "title":"card-title",
             "subTitle":"card-sub-title",
             "imageUrl":"URL of the image to be shown",
             "attachmentLinkUrl":"URL of the attachment to be associated with the card",
             "buttons":[ 
                 {
                    "text":"button-text",
                    "value":"Value sent to server on button click"
                 }
              ]
           } 
       ] 
     }
  }