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.

Migración de una función de Lambda de Amazon Lex V1 a Amazon Lex V2

Amazon Lex V2 solo admite una función de Lambda para cada idioma en un bot. La función de Lambda y sus valores se configuran para el alias del bot que se utiliza en tiempo de ejecución.

La función de Lambda se invoca para todas las intenciones en el idioma correspondiente si los enlaces de código de diálogo y de cumplimiento están habilitados para la intención.

Las funciones de Lambda de Amazon Lex V2 tienen un formato de mensaje de entrada y de salida diferente al de Amazon Lex V1. A continuación se indican las diferencias en lo que respecta al formato de entrada de las funciones de Lambda.

A continuación se indican las diferencias en lo que respecta al formato de salida de las funciones de Lambda.

Cuando crea un bot con las API de Amazon Lex V2, solo puede haber una función de Lambda en cada alias de bot por idioma, en vez de una función de Lambda para cada intención. Si desea continuar usando funciones distintas, puede crear una función de enrutamiento que active una función distinta para cada intención. A continuación se muestra un ejemplo de función de enrutamiento que puede utilizar o modificar en su aplicación.

import os
import json
import boto3

# reuse client connection as global
client = boto3.client('lambda') 

def router(event):
    intent_name = event['sessionState']['intent']['name']
    fn_name = os.environ.get(intent_name)
    print(f"Intent: {intent_name} -> Lambda: {fn_name}")
    if (fn_name):
        # invoke lambda and return result
        invoke_response = client.invoke(FunctionName=fn_name, Payload = json.dumps(event))
        print(invoke_response)
        payload = json.load(invoke_response['Payload'])
        return payload
    raise Exception('No environment variable for intent: ' + intent_name)
    
def lambda_handler(event, context):
    print(event)
    response = router(event)
    return response

Lista de campos actualizados

En las siguientes tablas se incluye información detallada sobre los campos actualizados en el formato de solicitud y respuesta de Lambda para Amazon Lex V2. Utilice las tablas para asignar campos entre versiones.

Solicitud

Los campos siguientes se han actualizado en el formato de solicitud de las funciones de Lambda.

Contextos activos

La estructura activeContexts ahora forma parte de la estructura sessionState.

Intenciones alternativas

La lista de interpretaciones del índice 1 al N contiene la lista de intenciones alternativas que Amazon Lex V2 ha predicho, junto con las puntuaciones de confianza correspondientes. recentIntentSummaryView se ha eliminado de la estructura de solicitud en Amazon Lex V2. Para obtener información acerca de recentIntentSummaryView, utilice la operación GetSession.

Bot

En Amazon Lex V2, los bots y los alias cuentan con identificadores. El ID del bot forma parte de la entrada del enlace de código. Se incluye el ID del alias, pero no su nombre. Amazon Lex V2 admite varias configuraciones regionales para el mismo bot, por lo que se incluye el ID de la configuración regional.

Intención actual

La estructura sessionState.intent contiene los detalles de la intención activa. Amazon Lex V2 también devuelve una lista con todas las intenciones, incluidas intenciones alternativas, en la estructura interpretations. El primer elemento de la lista de interpretaciones coincide con el primer elemento de sessionState.intent.

Acción de diálogo

El campo confirmationStatus ahora forma parte de la estructura sessionState.

Amazon Kendra

El campo kendraResponse ahora forma parte de las estructuras sessionState y interpretations.

Opinión

La estructura sentimentResponse se mueve a la nueva estructura interpretations.

Slots

Amazon Lex V2 proporciona un solo objeto slots en el interior de la estructura sessionState.intent que contiene los valores resueltos, el valor interpretado y el valor original de lo que ha dicho el usuario. Amazon Lex V2 también admite ranuras con múltiples valores si se establece slotShape como List y si se configura la lista values. El campo value admite ranuras con un solo valor y se asume que su forma es Scalar.

Otros

El campo sessionId de Amazon Lex V2 es el mismo que el campo userId de Amazon Lex V1. Amazon Lex V2 también envía el objeto inputMode de la persona que llama: texto, DTMF o voz.

Respuesta

Los campos siguientes se han modificado en el formato de mensaje de respuesta de las funciones de Lambda.

Contextos activos

La estructura activeContexts se mueve a la estructura sessionState.

Acción de diálogo

La estructura dialogAction se mueve a la estructura sessionState. Ahora puede especificar varios mensajes en una acción de diálogo. La estructura genericAttachments es ahora la estructura imageResponseCard.

Intenciones y ranuras

Los campos de intención y ranura que formaban parte de la estructura dialogAction ahora forman parte de la estructura sessionState.

Otros

La estructura sessionAttributes ahora forma parte de la estructura sessionState. La estructura recentIntentSummaryReview se ha eliminado.