Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Migration d'une fonction Lambda d'Amazon Lex V1 vers Amazon Lex V2

Amazon Lex V2 n'autorise qu'une seule fonction Lambda pour chaque langue dans un bot. La fonction Lambda et ses paramètres sont configurés pour l'alias de bot que vous utilisez lors de l'exécution.

La fonction Lambda est invoquée à toutes fins utiles dans cette langue si les hooks de dialogue et de code d'exécution sont activés à cette fin.

Les fonctions Lambda d'Amazon Lex V2 ont un format de message d'entrée et de sortie différent de celui d'Amazon Lex V1. Voici les différences entre le format d'entrée de la fonction Lambda.

Voici les différences entre le format de sortie de la fonction Lambda :

Lorsque vous créez un bot avec les API Amazon Lex V2, il n'existe qu'une seule fonction Lambda par alias de bot par langue au lieu d'une fonction Lambda pour chaque intention. Si vous souhaitez continuer à utiliser des fonctions distinctes, vous pouvez créer une fonction de routeur qui active une fonction distincte pour chaque intention. Voici une fonction du routeur que vous pouvez utiliser ou modifier pour votre application.

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

Liste des champs mis à jour

Les tableaux suivants fournissent des informations détaillées sur les champs mis à jour dans la demande et la réponse Lambda Amazon Lex V2. Vous pouvez utiliser ces tables pour mapper les champs entre les versions.

Demande

Les champs suivants ont été mis à jour dans le format de demande de fonction Lambda.

Contextes actifs

La activeContexts structure fait désormais partie de la sessionState structure.

Intentions alternatives

La liste des interprétations de l'indice 1 à N contient la liste des intentions alternatives prédites par Amazon Lex V2, ainsi que leurs scores de confiance. Le recentIntentSummaryView est supprimé de la structure de demande dans Amazon Lex V2. Pour voir les détails durecentIntentSummaryView, utilisez l'GetSessionopération.

Robot

Dans Amazon Lex V2, les robots et les alias possèdent des identifiants. L'ID du bot fait partie de l'entrée du codehook. L'ID d'alias est inclus, mais pas le nom de l'alias. Amazon Lex V2 prend en charge plusieurs paramètres régionaux pour le même bot. L'identifiant local est donc inclus.

Intention actuelle

La sessionState.intent structure contient les détails de l'intention active. Amazon Lex V2 renvoie également une liste de toutes les intentions, y compris les intentions alternatives, de la interpretations structure. Le premier élément de la liste d'interprétations est toujours le même quesessionState.intent.

Action de dialogue

Le confirmationStatus champ fait désormais partie de la sessionState structure.

Amazon Kendra

Le kendraResponse champ fait désormais partie des interpretations structures sessionState et.

Sentiment

La sentimentResponse structure est déplacée vers la nouvelle interpretations structure.

Emplacements

Amazon Lex V2 fournit un slots objet unique à l'intérieur de la sessionState.intent structure qui contient les valeurs résolues, les valeurs interprétées et la valeur d'origine de ce que l'utilisateur a dit. Amazon Lex V2 prend également en charge les emplacements à valeurs multiples en définissant le slotShape as List et en définissant la values liste. Les emplacements à valeur unique sont pris en charge par le value champ, leur forme est supposée l'êtreScalar.

Autres

Le sessionId champ Amazon Lex V2 est identique à celui userId d'Amazon Lex V1. Amazon Lex V2 envoie également le message inputMode de l'appelant : texte, DTMF ou discours.

Réponse

Les champs suivants ont été modifiés dans le format du message de réponse de la fonction Lambda.

Contextes actifs

La activeContexts structure a été déplacée vers la sessionState structure.

Action de dialogue

La dialogAction structure a été déplacée vers la sessionState structure. Vous pouvez désormais spécifier plusieurs messages dans une action de dialogue, et la genericAttachments structure est désormais la imageResponseCard structure.

Intentions et créneaux

Les champs Intent et slot qui faisaient partie de la dialogAction structure font désormais partie de la sessionState structure.

Autres

La sessionAttributes structure fait désormais partie de la sessionState structure. La recentIntentSummaryReview structure a été supprimée.