Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

 

Wenn Sie Amazon Lex V1 verwenden, empfehlen wir, Ihre Bots auf Amazon Lex V2 zu aktualisieren. Wir fügen V1 keine neuen Funktionen mehr hinzu und empfehlen dringend, V2 für alle neuen Bots zu verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Migration einer Lambda-Funktion von Amazon Lex V1 auf Amazon Lex V2

Amazon Lex V2 erlaubt nur eine Lambda-Funktion für jede Sprache in einem Bot. Die Lambda-Funktion und ihre Einstellungen sind für den Bot-Alias konfiguriert, den Sie zur Laufzeit verwenden.

Die Lambda-Funktion wird in dieser Sprache in jeder Hinsicht aufgerufen, wenn Dialog- und Fulfillment-Code-Hooks für die Absicht aktiviert sind.

Amazon Lex V2 Lambda-Funktionen haben ein anderes Eingabe- und Ausgabe-Nachrichtenformat als Amazon Lex V1. Dies sind die Unterschiede im Eingabeformat der Lambda-Funktion.

Dies sind die Unterschiede im Ausgabeformat der Lambda-Funktion:

Wenn Sie einen Bot mit den Amazon Lex V2-APIs erstellen, gibt es nur eine Lambda-Funktion pro Bot-Alias pro Sprache anstelle einer Lambda-Funktion für jede Absicht. Wenn Sie weiterhin separate Funktionen verwenden möchten, können Sie eine Routerfunktion erstellen, die für jede Absicht eine separate Funktion aktiviert. Im Folgenden finden Sie eine Routerfunktion, die Sie für Ihre Anwendung verwenden oder ändern können.

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 der aktualisierten Felder

Die folgenden Tabellen enthalten detaillierte Informationen zu den aktualisierten Feldern in der Amazon Lex V2 Lambda-Anfrage und -Antwort. Sie können diese Tabellen verwenden, um Felder zwischen den Versionen zuzuordnen.

Anfrage

Die folgenden Felder wurden im Format der Lambda-Funktionsanforderung aktualisiert.

Aktive Kontexte

DieactiveContexts Struktur ist jetzt Teil dersessionState Struktur.

Alternative Absichten

Die Interpretationsliste von Index 1 bis N enthält die Liste der von Amazon Lex V2 vorhergesagten alternativen Absichten sowie deren Konfidenzwerte. DasrecentIntentSummaryView wird aus der Anforderungsstruktur in Amazon Lex V2 entfernt. Um die Details von zu sehenrecentIntentSummaryView, verwenden Sie dieGetSession Operation.

Bot

In Amazon Lex V2 haben Bots und Aliase Identifikatoren. Die Bot-ID ist Teil der Codehook-Eingabe. Die Alias-ID ist enthalten, aber nicht der Aliasname. Amazon Lex V2 unterstützt mehrere Gebietsschemas für denselben Bot, sodass die Gebietsschema-ID enthalten ist.

Aktuelle Absicht

DiesessionState.intent Struktur enthält die Details der aktiven Absicht. Amazon Lex V2 gibt außerdem eine Liste aller Intents, einschließlich alternativer Intents, in derinterpretations Struktur zurück. Das erste Element in der Interpretationsliste ist immer dasselbe wiesessionState.intent.

Aktion „Dialog“

DasconfirmationStatus Feld ist jetzt Teil dersessionState Struktur.

Amazon Kendra

DaskendraResponse Feld ist jetzt Teil dersessionState undinterpretations -Strukturen.

Stimmung

DiesentimentResponse Struktur wird in die neueinterpretations Struktur verschoben.

Slots

Amazon Lex V2 stellt ein einzelnesslots Objekt innerhalb dersessionState.intent Struktur bereit, das die aufgelösten Werte, den interpretierten Wert und den ursprünglichen Wert dessen, was der Benutzer gesagt hat, enthält. Amazon Lex V2 unterstützt auch Steckplätze mit mehreren Werten, indemslotShape es die alsList und dievalues Liste festlegt. Steckplätze mit einem Wert werden vomvalue Feld unterstützt, ihre Form wird angenommenScalar.

Weitere

Das Amazon LexsessionId V2-Feld ist dasselbe wie dasuserId Feld in Amazon Lex V1. Amazon Lex V2 sendet auch dieinputMode des Anrufers: Text, DTMF oder Sprache.

Antwort

Die folgenden Felder wurden im Antwortnachrichtenformat der Lambda-Funktion geändert.

Aktive Kontexte

DieactiveContexts Struktur wurde in diesessionState Struktur verschoben.

Aktion „Dialog“

DiedialogAction Struktur wurde in diesessionState Struktur verschoben. Sie können jetzt mehrere Nachrichten in einer Dialogaktion angeben, und diegenericAttachments Struktur ist jetzt dieimageResponseCard Struktur.

Absichten und Slots

Absichts- und Slot-Felder, die Teil derdialogAction Struktur waren, sind jetzt Teil dersessionState Struktur.

Weitere

DiesessionAttributes Struktur ist jetzt Teil dersessionState Struktur. DierecentIntentSummaryReview Struktur wurde entfernt.