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 }, ... } }
-
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. -
lambdaARN
Para 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. -
Para permitir que Amazon Lex V2 invoque la función de Lambda para el alias, defina el campo
enabled
entrue
.
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
.
-
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 deldialogCodeHook
campo en:true
"dialogCodeHook": { "enabled":
boolean
} -
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/oelicitationCodeHook
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 elfulfillmentCodeHook
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
atrue
para que Amazon Lex V2 llame al enlace de código en ese momento de la conversación. -
Cambie el campo
enableCodeHookInvocation
atrue
para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca comofalse
, 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
atrue
para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca comofalse
, 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
atrue
para que Amazon Lex V2 llame al enlace de código en ese momento de la conversación. -
Cambie el campo
enabled
atrue
para que Amazon Lex V2 permita que el enlace de código se ejecute con normalidad. Si lo marca comofalse
, 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.