Hinweis zum Ende des Supports: Am 15. September 2025 AWS wird der Support für Amazon Lex V1 eingestellt. Nach dem 15. September 2025 können Sie nicht mehr auf die Amazon Lex V1-Konsole oder die Amazon Lex V1-Ressourcen zugreifen. Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.
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.
Schritt 5 (optional): Prüfen der Details des Informationsflusses (Konsole)
In diesem Abschnitt wird der Informationsfluss zwischen dem Client und Amazon Lex für jede Benutzereingabe erläutert, einschließlich der Integration der Lambda-Funktion.
Anmerkung
In diesem Abschnitt wird davon ausgegangen, dass der Client Anfragen über die PostText Runtime-API an Amazon Lex sendet, und zeigt die Anfrage- und Antwortdetails entsprechend an. Ein Beispiel für den Informationsfluss zwischen dem Client und Amazon Lex, bei dem der Client die PostContent API verwendet, finden Sie unterSchritt 2a (optional): Prüfen der Details des Informationsflusses gesprochener Inhalte (Konsole) .
Weitere Informationen über die PostText-Laufzeit-API und weitere Details zu den Anforderungen und Antworten, die in den folgenden Schritten gezeigt werden, finden Sie unter PostText.
-
Benutzer: Ich möchte einige Blumen bestellen.
-
Der Client (Konsole) sendet die folgende PostText-Anforderung an Amazon Lex:
POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text "Content-Type":"application/json" "Content-Encoding":"amz-1.0" { "inputText": "I would like to order some flowers", "sessionAttributes": {} }Sowohl die Anforderungs-URI als auch der Text stellen Amazon Lex Informationen zur Verfügung:
-
Anfrage-URI — Stellt den Bot-Namen (
OrderFlowers), den Bot-Alias ($LATEST) und den Benutzernamen (eine zufällige Zeichenfolge zur Identifizierung des Benutzers) bereit. Der abschließendetextzeigt an, dass es sich um einePostText-API-Anforderung handelt (und nicht umPostContent). -
Anforderungsinhalt: Enthält die Benutzereingabe (
inputText) und leeresessionAttributes. Wenn der Client die erste Anforderung stellt, gibt es keine Sitzungsattribute. Die Lambda-Funktion initiiert sie später.
-
-
Anhand
inputTextvon erkennt Amazon Lex die Absicht (OrderFlowers). Diese Absicht ist mit einer Lambda-Funktion als Code-Hook für die Initialisierung und Validierung von Benutzerdaten konfiguriert. Daher ruft Amazon Lex diese Lambda-Funktion auf, indem es die folgenden Informationen als Ereignisdaten weitergibt:{ "messageVersion": "1.0", "invocationSource": "DialogCodeHook", "userId": "ignw84y6seypre4xly5rimopuri2xwnd", "sessionAttributes": {}, "bot": { "name": "OrderFlowers", "alias": null, "version": "$LATEST" }, "outputDialogMode": "Text", "currentIntent": { "name": "OrderFlowers", "slots": { "PickupTime": null, "FlowerType": null, "PickupDate": null }, "confirmationStatus": "None" } }Weitere Informationen finden Sie unter Eingabe-Ereignis-Format.
Zusätzlich zu den Informationen, die der Kunde gesendet hat, enthält Amazon Lex auch die folgenden zusätzlichen Daten:
-
messageVersion— Derzeit unterstützt Amazon Lex nur die Version 1.0. -
invocationSource— Zeigt den Zweck des Aufrufs der Lambda-Funktion an. In diesem Fall ist es die Durchführung der Initialisierung und Validierung von Benutzerdaten. Derzeit weiß Amazon Lex, dass der Benutzer nicht alle Slot-Daten bereitgestellt hat, um die Absicht zu erfüllen. -
currentIntent-Daten, wobei alle Slot-Werte auf Null gesetzt sind.
-
-
Zu diesem Zeitpunkt sind alle Slot-Werte auf Null gesetzt. Die Lambda-Funktion muss nichts validieren. Die Lambda-Funktion gibt die folgende Antwort an Amazon Lex zurück:
{ "sessionAttributes": {}, "dialogAction": { "type": "Delegate", "slots": { "PickupTime": null, "FlowerType": null, "PickupDate": null } } }Weitere Informationen über das Antwortformat finden Sie unter Reaktion-Format.
Beachten Sie Folgendes:
-
dialogAction.type— Wenn Sie diesen Wert auf setzenDelegate, delegiert die Lambda-Funktion die Verantwortung für die Entscheidung über die nächste Vorgehensweise an Amazon Lex.Anmerkung
Wenn die Lambda-Funktion etwas in der Benutzerdatenvalidierung erkennt, weist sie Amazon Lex an, was als Nächstes zu tun ist, wie in den nächsten Schritten gezeigt.
-
-
Laut dem
dialogAction.typeentscheidet Amazon Lex über die nächste Vorgehensweise. Da keiner der Slots ausgefüllt ist, entscheidet es, den Wert für den SlotFlowerTypezu erfragen. Es wählt auch eine der Aufforderungen zur Angabe von Werten für diesen Slot aus ("Welche Art Blumen möchten Sie bestellen?") und sendet dann die folgende Antwort an den Client zurück:
Der Client zeigt die Mitteilung in der Antwort an.
-
-
Benutzer: Rosen
-
Der Client sendet die folgende PostText Anfrage an Amazon Lex:
POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text "Content-Type":"application/json" "Content-Encoding":"amz-1.0" { "inputText": "roses", "sessionAttributes": {} }Im Anforderungstext liefert der
inputTextdie Benutzereingabe. DiesessionAttributesbleiben leer. -
Amazon Lex interpretiert das zunächst
inputTextim Kontext der aktuellen Absicht. Der Service "erinnert sich" daran, den spezifischen Benutzer nach Informationen über den SlotFlowerTypegefragt zu haben. Es aktualisiert den Slot-Wert in der aktuellen Absicht und ruft die Lambda-Funktion mit den folgenden Ereignisdaten auf:{ "messageVersion": "1.0", "invocationSource": "DialogCodeHook", "userId": "ignw84y6seypre4xly5rimopuri2xwnd", "sessionAttributes": {}, "bot": { "name": "OrderFlowers", "alias": null, "version": "$LATEST" }, "outputDialogMode": "Text", "currentIntent": { "name": "OrderFlowers", "slots": { "PickupTime": null, "FlowerType": "roses", "PickupDate": null }, "confirmationStatus": "None" } }Beachten Sie Folgendes:
-
invocationSource: Ist immer nochDialogCodeHook(wir validieren einfach Benutzerdaten). -
currentIntent.slots— Amazon Lex hat denFlowerTypeSlot auf Rosen aktualisiert.
-
-
Je nach
invocationSourceWert vonDialogCodeHookführt die Lambda-Funktion eine Benutzerdatenvalidierung durch. Es wirdrosesals gültiger Slot-Wert erkannt (undPriceals Sitzungsattribut festgelegt) und gibt die folgende Antwort an Amazon Lex zurück.{ "sessionAttributes": { "Price": 25 }, "dialogAction": { "type": "Delegate", "slots": { "PickupTime": null, "FlowerType": "roses", "PickupDate": null } } }Beachten Sie Folgendes:
-
sessionAttributes— Die Lambda-Funktion hatPrice(von den Rosen) als Sitzungsattribut hinzugefügt. -
dialogAction.type: Wird aufDelegategesetzt. Die Benutzerdaten waren gültig, sodass die Lambda-Funktion Amazon Lex anweist, die nächste Vorgehensweise zu wählen.
-
-
Laut dem
dialogAction.typewählt Amazon Lex die nächste Vorgehensweise. Amazon Lex weiß, dass mehr Steckplatzdaten benötigt werden, und wählt daher den nächsten unbesetzten Steckplatz (PickupDate) mit der höchsten Priorität entsprechend der Absichtskonfiguration aus. Amazon Lex wählt eine der Eingabeaufforderungen zur Wertermittlung aus: „An welchem Tag sollen die Rosen abgeholt werden?“ — für diesen Slot entsprechend der Intent-Konfiguration und sendet dann die folgende Antwort zurück an den Client:
Der Client zeigt einfach die Mitteilung in der Antwort an: "An welchem Tag möchten Sie die Rosen abholen?"
-
-
Benutzer: morgen
-
Der Client sendet die folgende PostText Anfrage an Amazon Lex:
POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text "Content-Type":"application/json" "Content-Encoding":"amz-1.0" { "inputText": "tomorrow", "sessionAttributes": { "Price": "25" } }Im Anforderungstext liefert
inputTextdie Benutzereingabe und der Client gibt die Sitzungsattribute an den Service zurück. -
Amazon Lex erinnert sich an den Kontext — dass es Daten für den Slot abgerufen hat.
PickupDateIn diesem Kontext weiß es, dass der WertinputTextfür den SlotPickupDateist. Amazon Lex ruft dann die Lambda-Funktion auf, indem es das folgende Ereignis sendet:{ "messageVersion": "1.0", "invocationSource": "DialogCodeHook", "userId": "ignw84y6seypre4xly5rimopuri2xwnd", "sessionAttributes": { "Price": "25" }, "bot": { "name": "OrderFlowersCustomWithRespCard", "alias": null, "version": "$LATEST" }, "outputDialogMode": "Text", "currentIntent": { "name": "OrderFlowers", "slots": { "PickupTime": null, "FlowerType": "roses", "PickupDate": "2017-01-05" }, "confirmationStatus": "None" } }Amazon Lex hat das aktualisiert,
currentIntent.slotsindem es denPickupDateWert festgelegt hat. Beachten Sie auch, dass der Dienst dassessionAttributesunverändert an die Lambda-Funktion weitergibt. -
Gemäß dem
invocationSourceWert vonDialogCodeHookführt die Lambda-Funktion eine Benutzerdatenvalidierung durch. Es erkennt, dass derPickupDateSlot-Wert gültig ist, und gibt die folgende Antwort an Amazon Lex zurück:{ "sessionAttributes": { "Price": 25 }, "dialogAction": { "type": "Delegate", "slots": { "PickupTime": null, "FlowerType": "roses", "PickupDate": "2017-01-05" } } }Beachten Sie Folgendes:
-
sessionAttributes: Keine Änderung. -
dialogAction.type: Wird aufDelegategesetzt. Die Benutzerdaten waren gültig, und die Lambda-Funktion weist Amazon Lex an, die nächste Vorgehensweise zu wählen.
-
-
Laut dem
dialogAction.typewählt Amazon Lex die nächste Vorgehensweise. Amazon Lex weiß, dass mehr Steckplatzdaten benötigt werden, und wählt daher den nächsten unbesetzten Steckplatz (PickupTime) mit der höchsten Priorität entsprechend der Absichtskonfiguration aus. Amazon Lex wählt eine der Aufforderungsnachrichten aus („Um welche Uhrzeit am 05.01.2017 sollen die Rosen geliefert werden?“) für diesen Slot entsprechend der Intent-Konfiguration und sendet die folgende Antwort zurück an den Client:
Der Client zeigt in der Antwort die folgende Meldung an: „Um welche Uhrzeit sollen die Rosen am 05.01.2017 geliefert werden?“
-
-
Benutzer: 16 Uhr
-
Der Client sendet die folgende PostText Anfrage an Amazon Lex:
POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text "Content-Type":"application/json" "Content-Encoding":"amz-1.0" { "inputText": "4 pm", "sessionAttributes": { "Price": "25" } }Im Anforderungstext liefert der
inputTextdie Benutzereingabe. Der Client übergibt diesessionAttributesin der Anforderung. -
Amazon Lex versteht den Kontext. Es versteht, dass es Daten für den Slot
PickupTimeerfragt hat. In diesem Zusammenhang weiß es, dass derinputTextWert für denPickupTimeSlot gilt. Amazon Lex ruft dann die Lambda-Funktion auf, indem es das folgende Ereignis sendet:{ "messageVersion": "1.0", "invocationSource": "DialogCodeHook", "userId": "ignw84y6seypre4xly5rimopuri2xwnd", "sessionAttributes": { "Price": "25" }, "bot": { "name": "OrderFlowersCustomWithRespCard", "alias": null, "version": "$LATEST" }, "outputDialogMode": "Text", "currentIntent": { "name": "OrderFlowers", "slots": { "PickupTime": "16:00", "FlowerType": "roses", "PickupDate": "2017-01-05" }, "confirmationStatus": "None" } }Amazon Lex hat das aktualisiert,
currentIntent.slotsindem es denPickupTimeWert festgelegt hat. -
Je nach
invocationSourceWert vonDialogCodeHookführt die Lambda-Funktion eine Benutzerdatenvalidierung durch. Es erkennt, dass derPickupDateSlot-Wert gültig ist, und gibt die folgende Antwort an Amazon Lex zurück.{ "sessionAttributes": { "Price": 25 }, "dialogAction": { "type": "Delegate", "slots": { "PickupTime": "16:00", "FlowerType": "roses", "PickupDate": "2017-01-05" } } }Beachten Sie Folgendes:
-
sessionAttributes: Keine Änderung am Sitzungsattribut. -
dialogAction.type: Wird aufDelegategesetzt. Die Benutzerdaten waren gültig, sodass die Lambda-Funktion Amazon Lex anweist, die nächste Vorgehensweise zu wählen.
-
-
Derzeit weiß Amazon Lex, dass es über alle Slot-Daten verfügt. Diese Absicht wurde mit einer Bestätigungsaufforderung konfiguriert. Daher sendet Amazon Lex die folgende Antwort an den Benutzer mit der Bitte um Bestätigung, bevor die Absicht erfüllt wird:
Der Client zeigt einfach die Mitteilung in der Antwort an und wartet auf die Antwort des Benutzers.
-
-
Benutzer: Ja
-
Der Client sendet die folgende PostText Anfrage an Amazon Lex:
POST /bot/OrderFlowers/alias/$LATEST/user/ignw84y6seypre4xly5rimopuri2xwnd/text "Content-Type":"application/json" "Content-Encoding":"amz-1.0" { "inputText": "yes", "sessionAttributes": { "Price": "25" } } -
Amazon Lex interpretiert das
inputTextim Zusammenhang mit der Bestätigung der aktuellen Absicht. Amazon Lex geht davon aus, dass der Benutzer mit der Bestellung fortfahren möchte. Diesmal ruft Amazon Lex die Lambda-Funktion auf, um die Absicht zu erfüllen, indem das folgende Ereignis gesendet wird, dasFulfillmentCodeHookin dem Ereignis, dasinvocationSourcean die Lambda-Funktion gesendet wird, auf setzt. Amazon Lex legt auch dasconfirmationStatusauf festConfirmed.{ "messageVersion": "1.0", "invocationSource": "FulfillmentCodeHook", "userId": "ignw84y6seypre4xly5rimopuri2xwnd", "sessionAttributes": { "Price": "25" }, "bot": { "name": "OrderFlowersCustomWithRespCard", "alias": null, "version": "$LATEST" }, "outputDialogMode": "Text", "currentIntent": { "name": "OrderFlowers", "slots": { "PickupTime": "16:00", "FlowerType": "roses", "PickupDate": "2017-01-05" }, "confirmationStatus": "Confirmed" } }Beachten Sie Folgendes:
-
invocationSource— Diesmal hat Amazon Lex diesen Wert auf gesetzt und die Lambda-Funktion angewiesenFulfillmentCodeHook, die Absicht zu erfüllen. -
confirmationStatus: Wird aufConfirmedgesetzt.
-
-
Diesmal erfüllt die Lambda-Funktion die
OrderFlowersAbsicht und gibt die folgende Antwort zurück:{ "sessionAttributes": { "Price": "25" }, "dialogAction": { "type": "Close", "fulfillmentState": "Fulfilled", "message": { "contentType": "PlainText", "content": "Thanks, your order for roses has been placed and will be ready for pickup by 16:00 on 2017-01-05" } } }Beachten Sie Folgendes:
-
Legt fest
dialogAction.type— Die Lambda-Funktion setzt diesen Wert auf und weist Amazon Lex anClose, keine Benutzerantwort zu erwarten. -
dialogAction.fulfillmentState: ist auf Fulfilled eingestellt und enthält eine geeignetemessagezur Übermittlung an den Benutzer.
-
-
Amazon Lex überprüft das
fulfillmentStateund sendet die folgende Antwort an den Kunden zurück.Amazon Lex gibt dann Folgendes an den Client zurück:
Beachten Sie:
-
dialogState— Amazon Lex legt diesen Wert auf festfulfilled. -
message— ist dieselbe Nachricht, die die Lambda-Funktion bereitgestellt hat.
Der Client zeigt die Mitteilung an.
-
-
-
Testen Sie nun den Bot erneut. Um einen neuen (Benutzer-)Kontext zu etablieren, wählen Sie den Link Clear im Testfenster aus. Geben Sie jetzt ungültige Slot-Daten für die Absicht
OrderFlowersan. Diesmal führt die Lambda-Funktion die Datenvalidierung durch, setzt den ungültigen Slot-Datenwert auf Null zurück und fordert Amazon Lex auf, den Benutzer zur Eingabe gültiger Daten aufzufordern. Versuchen Sie zum Beispiel Folgendes:-
Jasmin als Blumenart (zählt nicht zu den unterstützten Blumenarten)
-
Gestern als den Tag, an dem Sie die Blumen abholen möchten
-
Nachdem Sie Ihre Bestellung aufgegeben haben, geben Sie eine andere Blumensorte ein, statt zur Bestätigung der Bestellung mit "Ja" zu antworten. Als Reaktion darauf aktualisiert die Lambda-Funktion das Attribut
Pricein der Sitzung und behält so die laufende Gesamtzahl der Blumenbestellungen bei.
Die Lambda-Funktion führt auch die Fulfillment-Aktivität durch.
-
Nächster Schritt
Schritt 6: Aktualisieren der Absichtskonfiguration zum Hinzufügen einer Äußerung (Konsole)