Adjunte una AWS Lambda función a un bot mediante las operaciones de la API - Amazon Lex

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.

Adjunte una AWS Lambda función a un bot mediante las operaciones de la API

Para poder invocar una función de Lambda, primero debe asociarla a su alias de bot. Recuerde que puede asociar cada alias de bot como máximo a una función de Lambda. Realice estos pasos para asociar la función de Lambda mediante operaciones de API.

Si va a crear un nuevo alias de bot, utilice la CreateBotAliasoperación para adjuntar una función Lambda. Para adjuntar una función Lambda a un alias de bot existente, utilice la UpdateBotAliasoperación. Modifique el campo botAliasLocaleSettings para que contenga la configuración correcta:

{ "botAliasLocaleSettings" : { locale: { "codeHookSpecification": { "lambdaCodeHook": { "codeHookInterfaceVersion": "1.0", "lambdaARN": "arn:aws:lambda:region:account-id:function:function-name" } }, "enabled": true }, ... } }
  1. El campo botAliasLocaleSettings se asigna a un objeto cuyas claves son las configuraciones regionales en las que desea adjuntar la función de Lambda. Consulte Idiomas y configuraciones regionales compatibles para obtener una lista de las configuraciones regionales compatibles y los códigos que son claves válidas.

  2. lambdaARNPara buscar la función Lambda, abre la AWS Lambda consola en https://console.aws.amazon.com/lambda/casa, selecciona Funciones en la barra lateral izquierda y selecciona la función que deseas asociar al alias del bot. En el lado derecho de la Descripción de la función, busque el lambdaARN de la Función de ARN. Debe contener una región, un ID de cuenta y el nombre de la función.

  3. Para permitir que Amazon Lex V2 invoque la función de Lambda para el alias, defina el campo enabled en true.

Definición de una intención de invocar una función de Lambda mediante operaciones de API

Para configurar la invocación de la función Lambda durante una intención, utilice la CreateIntentoperación si está creando una nueva intención o la UpdateIntentoperación si está invocando la función en una intención existente. Los campos que controlan la invocación de la función de Lambda en las operaciones de intención son dialogCodeHook, initialResponseSetting, intentConfirmationSetting y fulfillmentCodeHook.

Si invoca la función durante la generación de una ranura, utilice la CreateSlotoperación si va a crear una nueva ranura o utilice la UpdateSlotoperación para invocar la función en una ranura existente. El campo que controla la invocación de la función de Lambda en las operaciones de slot es la slotCaptureSetting del objeto valueElicitationSetting.

  1. Para configurar el enlace de código del cuadro de diálogo de Lambda para que se ejecute después de cada turno de la conversación, defina el enabled campo del siguiente DialogCodeHookSettingsobjeto del dialogCodeHook campo en: true

    "dialogCodeHook": { "enabled": boolean }
  2. Como alternativa, puede configurar el enlace de código de diálogo Lambda para que se ejecute solo en puntos específicos de las conversaciones modificando el campo codeHook y/o elicitationCodeHook dentro de las estructuras que corresponden a las etapas de la conversación en las que desea invocar la función. Para utilizar el enlace de códigos del cuadro de diálogo Lambda para el cumplimiento de la intención, utilice el fulfillmentCodeHook campo de la operación CreateIntento UpdateIntent. Las estructuras y los usos de estos tres tipos de enlaces de código son los siguientes:

El campo codeHook define los ajustes para que el enlace de código se ejecute en una etapa determinada de la conversación. Es un DialogCodeHookInvocationSettingobjeto con la siguiente estructura:

"codeHook": { "active": boolean, "enableCodeHookInvocation": boolean, "invocationLabel": string, "postCodeHookSpecification": PostDialogCodeHookInvocationSpecification object, }
  • Cambie el campo active a true para que Amazon Lex V2 llame al enlace de código en ese momento de la conversación.

  • Cambie el campo enableCodeHookInvocation a true para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca como false, Amazon Lex V2 actúa como si el enlace de código se hubiera devuelto correctamente.

  • La invocationLabel indica el paso de diálogo desde el que se invoca el enlace de código.

  • Utilice el campo postCodeHookSpecification para especificar las acciones y los mensajes que se producen después de que el enlace de código se ejecute correctamente, falle o se agote el tiempo de espera.

El campo elicitationCodeHook define la configuración del enlace de código que se ejecutará en caso de que sea necesario volver a activar una o varios slots. Este escenario puede ocurrir si la no se logra la obtención de slots o si se deniega la confirmación de intención. El elicitationCodeHook campo es un ElicitationCodeHookInvocationSettingobjeto con la siguiente estructura:

"elicitationCodeHook": { "enableCodeHookInvocation": boolean, "invocationLabel": string }
  • Cambie el campo enableCodeHookInvocation a true para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca como false, Amazon Lex V2 actúa como si el enlace de código se hubiera devuelto correctamente.

  • La invocationLabel indica el paso de diálogo desde el que se invoca el enlace de código.

El campo fulfillmentCodeHook define la configuración para que el enlace de código se ejecute para cumplir la intención. Se asigna al siguiente FulfillmentCodeHookSettingsobjeto:

"fulfillmentCodeHook": { "active": boolean, "enabled": boolean, "fulfillmentUpdatesSpecification": FulfillmentUpdatesSpecification object, "postFulfillmentStatusSpecification": PostFulfillmentStatusSpecification object }
  • Cambie el campo active a true para que Amazon Lex V2 llame al enlace de código en ese momento de la conversación.

  • Cambie el campo enabled a true para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca como false, Amazon Lex V2 actúa como si el enlace de código se hubiera devuelto correctamente.

  • Utilice el campo fulfillmentUpdatesSpecification para especificar los mensajes que parecen para actualizar al usuario durante el cumplimiento de la intención y tiempo asociado a ellos.

  • Utilice el campo postFulfillmentStatusSpecification para especificar los mensajes y las acciones que se producen después de que el enlace de código se ejecute correctamente, falle o se agote el tiempo de espera.

Puede invocar el enlace de código Lambda en los siguientes puntos de una conversación configurando los campos active y enableCodeHookInvocation/enabled en true:

Para invocar la función Lambda en la respuesta inicial después de reconocer la intención, utilice codeHook la estructura del campo de initialResponse CreateIntentla UpdateIntentoperación o. El initialResponse campo se asigna al siguiente objeto: InitialResponseSetting

"initialResponse": { "codeHook": { "active": boolean, "enableCodeHookInvocation": boolean, "invocationLabel": string, "postCodeHookSpecification": PostDialogCodeHookInvocationSpecification object, }, "initialResponse": FulfillmentUpdatesSpecification object, "nextStep": PostFulfillmentStatusSpecification object, "conditional": ConditionalSpecification object }

Para invocar la función Lambda después de obtener un valor de ranura, utilice slotCaptureSetting el campo dentro del campo de valueElicitation CreateSlotla operación o. UpdateSlot El slotCaptureSetting campo se asigna al siguiente objeto: SlotCaptureSetting

"slotCaptureSetting": { "captureConditional": ConditionalSpecification object, "captureNextStep": DialogState object, "captureResponse": ResponseSpecification object, "codeHook": { "active": true, "enableCodeHookInvocation": true, "invocationLabel": string, "postCodeHookSpecification": PostDialogCodeHookInvocationSpecification object, }, "elicitationCodeHook": { "enableCodeHookInvocation": boolean, "invocationLabel": string }, "failureConditional": ConditionalSpecification object, "failureNextStep": DialogState object, "failureResponse": ResponseSpecification object }
  • Para invocar la función de Lambda después de que la obtención de slots se haya realizado correctamente, utilice el campo codeHook.

  • Para invocar la función de Lambda después de que se produzca un error en la obtención de slots y Amazon Lex V2 intente volver a intentar la obtención de slots, utilice el campo elicitationCodeHook.

Para invocar la función Lambda al confirmar una intención, utilice intentConfirmationSetting el campo de CreateIntentla UpdateIntentoperación o. El intentConfirmation campo se asigna al siguiente objeto: IntentConfirmationSetting

"intentConfirmationSetting": { "active": boolean, "codeHook": { "active": boolean, "enableCodeHookInvocation": boolean, "invocationLabel": string, "postCodeHookSpecification": PostDialogCodeHookInvocationSpecification object, }, "confirmationConditional": ConditionalSpecification object, "confirmationNextStep": DialogState object, "confirmationResponse": ResponseSpecification object, "declinationConditional": ConditionalSpecification object, "declinationNextStep": FulfillmentUpdatesSpecification object, "declinationResponse": PostFulfillmentStatusSpecification object, "elicitationCodeHook": { "enableCodeHookInvocation": boolean, "invocationLabel": string, }, "failureConditional": ConditionalSpecification object, "failureNextStep": DialogState object, "failureResponse": ResponseSpecification object, "promptSpecification": PromptSpecification object }
  • Para invocar la función de Lambda después de que el usuario confirme la intención y sus slots, utilice el campo codeHook.

  • Para invocar la función de Lambda después de que el usuario rechace la confirmación de la intención y Amazon Lex V2 intente volver a intentar la obtención de slots, utilice el campo elicitationCodeHook.

Para invocar la función Lambda para cumplir una intención, utilice fulfillmentCodeHook el campo de la operación o. CreateIntentUpdateIntent El fulfillmentCodeHook campo se asigna al siguiente objeto: FulfillmentCodeHookSettings

{ "active": boolean, "enabled": boolean, "fulfillmentUpdatesSpecification": FulfillmentUpdatesSpecification object, "postFulfillmentStatusSpecification": PostFulfillmentStatusSpecification object }

3. Una vez que haya establecido las etapas de conversación en las que se invocará la función de Lambda, utilice la operación BuildBotLocale para volver a compilar el bot para probar la función.