Verwaltung von Sitzungen mit der Amazon Lex API

Fokusmodus

Verwaltung von Sitzungen mit der Amazon Lex API - Amazon Lex V 1

Wechseln von Absichten Fortsetzen einer vorherigen Absicht Starten einer neuen Sitzung Validieren der Slot-Werte

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.

Wenn ein Benutzer eine Konversation mit Ihrem Bot beginnt, erstellt Amazon Lex eine Sitzung. Die zwischen Ihrer Anwendung und Amazon Lex ausgetauschten Informationen bilden den Sitzungsstatus für die Konversation. Wenn Sie eine Anforderung absenden, wird die Sitzung anhand einer Kombination aus dem Bot-Namen und einer von Ihnen angegebenen Benutzer-ID identifiziert. Weitere Informationen über die Benutzer-ID finden Sie im Feld userId in der Operation PostContent oder PostText.

Die Antwort aus einer Sitzungsoperation enthält eine eindeutige Sitzungs-ID, anhand der eine bestimmte Sitzung mit einem Benutzer identifiziert wird. Sie können diese Kennung beim Testen oder zum Beheben von Problemen mit Ihrem Bot verwenden.

Sie können den zwischen Ihrer Anwendung und Ihrem Bot gesendeten Sitzungsstatus ändern. Beispielsweise können Sie Sitzungsattribute erstellen und ändern, die benutzerdefinierte Informationen zur Session enthalten. Außerdem können Sie den Gesprächsablauf ändern, indem Sie den Dialogkontext für die Interpretation der nächste Äußerung festlegen.

Es gibt zwei Möglichkeiten, wie Sie den Sitzungsstatus aktualisieren können. Die erste besteht darin, eine Lambda-Funktion mit der PostText Operation PostContent or zu verwenden, die nach jeder Runde der Konversation aufgerufen wird. Weitere Informationen finden Sie unter Verwendung von Lambda-Funktionen. Die andere Möglichkeit besteht darin, die Amazon Lex Lex-Laufzeit-API in Ihrer Anwendung zu verwenden, um Änderungen am Sitzungsstatus vorzunehmen.

Die Amazon Lex Runtime API bietet Operationen, mit denen Sie Sitzungsinformationen für eine Konversation mit Ihrem Bot verwalten können. Hierzu gehören die Operation PutSession, die Operation GetSession und die Operation DeleteSession. Sie können mit diesen Operationen Informationen über den Status der Sitzung Ihres Benutzers mit Ihrem Bot anfordern und eine differenzierte Kontrolle über den Status erlangen.

Verwenden Sie die Operation GetSession, wenn Sie den aktuellen Status der Sitzung anfordern möchten. Die Operation gibt den aktuellen Status der Sitzung, einschließlich des Status des Dialogs mit Ihrem Benutzer und aller festgelegten Sitzungsattribute und Slot-Werte für die letzten drei Absichten zurück, mit denen der Benutzer interagiert hat.

Die Operation PutSession ermöglicht es Ihnen, den aktuellen Sitzungsstatus direkt zu bearbeiten. Sie können die Art von Dialogaktion festlegen, die der Bot als Nächstes ausführen wird. Dadurch haben Sie Kontrolle über den Gesprächsablauf mit dem Bot. Stellen Sie das type Dialogaktionsfeld Delegate auf ein, damit Amazon Lex die nächste Aktion für den Bot bestimmt.

Sie können mit der Operation PutSession eine neue Sitzung mit einem Bot erstellen und die Absicht festlegen, mit der der Bot beginnen soll. Sie können mit der Operation PutSession auch von einer Absicht zu einer anderen wechseln. Wenn Sie eine Sitzung erstellen oder die Absicht ändern, können Sie auch den Sitzungsstatus, wie z. B. Slot-Werte und Sitzungsattribute, festlegen. Wenn die neue Absicht abgeschlossen ist, haben Sie die Möglichkeit, die vorherige Absicht neu zu starten. Sie können den GetSession Vorgang verwenden, um den Dialogstatus der vorherigen Absicht von Amazon Lex abzurufen und anhand der Informationen den Dialogstatus der Absicht festzulegen.

Die Antwort von der Operation PutSession enthält die gleichen Informationen wie die von der Operation PostContent. Sie können diese Informationen, genauso wie die Antwort von der Operation PostContent, verwenden, um vom Benutzer die nächste Teilinformation anzufordern.

Sie können mit der Operation DeleteSession eine vorhandene Sitzung entfernen und mit einer neuen Sitzung ganz von vorne beginnen. Wenn Sie beispielsweise Ihren Bot testen, können Sie mit der Operation DeleteSession Testsitzungen von Ihrem Bot entfernen.

Die Sitzungsvorgänge funktionieren mit Ihren Fulfillment-Lambda-Funktionen. Wenn Ihre Lambda-Funktion beispielsweise Failed als Erfüllungsstatus zurückkehrt, können Sie die PutSession Operation verwenden, um den Aktionstyp des Dialogs auf close und fulfillmentState auf festzulegen, um den Erfüllungsschritt erneut ReadyForFulfillment zu versuchen.

Es folgen einige Aufgaben, die Sie mit den Sitzungsoperationen ausführen können:

Veranlassen des Bots zum Starten einer Konversation, anstatt auf den Benutzer zu warten.
Wechseln von Absichten während einer Konversation.
Zurückkehren zur einer vorherigen Absicht.
Starten oder Neustarten einer Konversation während der Interaktion.
Validieren von Slot-Werten und Veranlassen des Bots, für ungültige Werte neue Werte anzufordern.

Jede dieser Aufgaben wird im Folgenden beschrieben.

Wechseln von Absichten

Sie können mit der Operation PutSession von einer Absicht zu einer anderen wechseln. Sie können mit ihr auch zu einer vorherigen Absicht zurückwechseln. Sie können mit der Operation PutSession Sitzungsattribute oder Slot-Werte für die neue Absicht einstellen.

Aufrufen der PutSession-Operation. Legen Sie als Absichtsnamen den Namen der neuen Absicht und als Dialogaktion Delegate fest. Sie können auch alle für die neue Absicht erforderlichen Slot-Werte oder Sitzungsattribute festlegen.
Amazon Lex beginnt eine Konversation mit dem Benutzer, der die neue Absicht verwendet.

Fortsetzen einer vorherigen Absicht

Um eine vorherige Absicht fortzusetzen, fordern Sie mit der Operation GetSession eine Zusammenfassung der Absicht an und legen Sie mit der Operation PutSession dann wieder den vorherigen Dialogstatus der Absicht fest.

Aufrufen der GetSession-Operation. Die Antwort von der Operation enthält eine Zusammenfassung des Dialogstatus der letzten drei Absichten, mit denen der Benutzer interagiert hat.
Rufen Sie mittels der Informationen aus der Absichtszusammenfassung die Operation PutSession auf. Dadurch gelangt der Benutzer wieder zur vorherigen Absicht an der gleichen Stelle im Gespräch.

In einigen Fällen kann es erforderlich sein, dass die Konversation Ihres Benutzers mit Ihrem Bot fortgesetzt wird. Angenommen, Sie haben einen Kundenservice-Bot erstellt. Ihre Anwendung stellt fest, dass der Benutzer mit einem Kundendienstmitarbeiter sprechen muss. Nach der Unterhaltung mit dem Benutzer kann der Mitarbeiter das Gespräch mit den vom ihm erfassten Informationen wieder an den Bot weiterleiten.

Um eine Sitzung fortzusetzen, verwenden Sie Schritte ähnlich wie diese:

Ihre Anwendung stellt fest, dass der Benutzer mit einem Kundendienstmitarbeiter sprechen muss.
Fordern Sie mit der Operation GetSession den aktuellen Dialogstatus der Absicht an.
Der Kundendienstmitarbeiter spricht mit dem Benutzer und löst das Problem.
Legen Sie mit der Operation PutSession den Dialogstatus der Absicht fest. Hierzu gehören möglicherweise Festlegen von Slot-Werten, Einstellen von Sitzungsattributen oder Ändern der Absicht.
Der Bot setzt die Konversation mit dem Benutzer fort.

Sie können den checkpointLabel-Parameter der PutSession-Operation verwenden, um eine Absicht zu beschriften, damit Sie sie später finden können. Beispielsweise kann ein Bot, der einen Kunden um Informationen bittet, eine Waiting-Absicht eingehen, während der Kunde die Informationen zusammenträgt. Der Bot erstellt eine Prüfpunktbeschriftung für die aktuelle Absicht und startet die Waiting-Absicht dann. Wenn der Kunde zurückkehrt, kann der Bot die vorherige Absicht mithilfe der Prüfpunktbeschriftung finden und zurückschalten.

Die Absicht muss in der recentIntentSummaryView-Struktur vorhanden sein, die von der GetSession-Operation zurückgegeben wird. Wenn Sie in der GetSession-Vorgangsanforderung eine Prüfpunktbeschriftung angeben, werden maximal drei Absichten mit dieser Prüfpunktbeschriftung zurückgegeben.

Verwenden Sie den GetSession-Vorgang, um den aktuellen Status der Sitzung abzurufen.
Verwenden Sie den PutSession-Vorgang, um der letzten Absicht eine Prüfpunktbeschriftung hinzuzufügen. Bei Bedarf können Sie diesen PutSession-Aufruf verwenden, um zu einer anderen Absicht zu wechseln.
Wenn es an der Zeit ist, zur beschrifteten Absicht zurückzukehren, rufen Sie den GetSession-Vorgang auf, um eine aktuelle Absichtsliste zurückzugeben. Sie können den checkpointLabelFilter Parameter verwenden, sodass Amazon Lex nur Absichten mit der angegebenen Checkpoint-Bezeichnung zurückgibt.

Starten einer neuen Sitzung

Wenn Sie möchten, dass der Bot die Konversation mit Ihrem Benutzer startet, können Sie dazu Operation PutSession verwenden.

Erstellen Sie eine Begrüßungsabsicht ohne Slots und eine abschließende Nachricht, die den Benutzer auffordert, eine Absicht zu nennen. Beispiel: „Was möchten Sie bestellen? Sie können Folgendes sagen: 'Ein Getränk bestellen' oder 'Eine Pizza bestellen'.“
Aufrufen der PutSession-Operation. Legen Sie als Absichtsnamen den Namen Ihrer Begrüßungsabsicht und als Dialogaktion Delegate fest.
Amazon Lex antwortet mit der Aufforderung von Your Welcome Intent, die Konversation mit Ihrem Benutzer zu beginnen.

Validieren der Slot-Werte

Sie können Antworten an Ihren Bot mit Ihrer Client-Anwendung validieren. Wenn die Antwort nicht gültig ist, können Sie mit der Operation PutSession eine neue Antwort von Ihrem Benutzer anfordern. Angenommen, Ihr Bot zur Aufnahme von Blumenbestellungen kann nur Rosen, Tulpen und Lilien verkaufen. Wenn der Benutzer Nelken bestellt, kann Ihre Anwendung wie folgt vorgehen:

Untersuchen des Slot-Wertes, der von der Antwort PostText oder PostContent zurückgegeben wird.
Wenn der Slot-Wert nicht gültig ist, Aufrufen der Operation PutSession. Ihre Anwendung sollte den Slot-Wert löschen, das Feld slotToElicit festlegen und den Wert dialogAction.type auf elicitSlot einstellen. Optional können Sie die messageFormat Felder message und festlegen, wenn Sie die Nachricht ändern möchten, die Amazon Lex verwendet, um den Slot-Wert zu ermitteln.