Verarbeitung von Antworten von einem AppInstanceBot - Amazon Chime SDK

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.

Verarbeitung von Antworten von einem AppInstanceBot

Wenn ein Benutzer eine Nachricht sendet, AppInstanceBot antwortet er mit einer Kanalnachricht. Sie können Kanalnachrichten auflisten, um die Antwort des Bots zu erhalten.

Das folgende Beispiel zeigt, wie Sie die CLI verwenden, um Kanalnachrichten aufzulisten.

aws chime-sdk-messaging list-channel-messages \
--chime-bearer caller_app_instance_user_arn \
--channel-arn channel_arn

Erfolgreiche Antworten von und AppInstanceBot haben das folgende Format. 

{
    "MessageId": "messageId",
    "Content": "*{\"Messages\":[{\"...\"}]}*",
    "ContentType": "application/amz-chime-lex-msgs",
    "MessageAttributes": {
        "CHIME.LEX.sessionState.intent.name": {
            "StringValues": [
                "lex_bot_intent_name"
            ]
        },
        "CHIME.LEX.sessionState.intent.state": {
            "StringValues": [
                "lex_bot_intent_fullfilment_status"
            ]
        },
        "CHIME.LEX.sessionState.originatingRequestId": {
            "StringValues": [
                "lex_bot_originating_request_id"
            ]
        },
        "CHIME.LEX.sessionState.sessionId": {
            "StringValues": [
                "lex_bot_session_id"
            ]
        }
    },
    "Sender": {
        "Arn": "app_instance_bot_arn",
        "Name": "app_instance_bot_name"
    },
    "Type": "STANDARD",
}
Content

Das Content Feld enthält eine Liste von Nachrichten, die vom Amazon Lex V2-Bot stammen. Weitere Informationen zu diesen Nachrichten finden Sie unter Nachrichten in der Amazon Lex RecognizeText V2-API.

Das folgende Beispiel zeigt, wie das Content Feld in einer Willkommensnachricht verwendet wird.

{
    "Messages":
    [
        {
            "Content": "Hello!",
            "ContentType": "PlainText"
        },
        {
            "ContentType": "ImageResponseCard",
            "ImageResponseCard":
            {
                "Title": "Hello! I'm BB, the Bank Bot.",
                "Subtitle": "I can help you with the following transactions",
                "Buttons":
                [
                    {
                        "Text": "Check balance",
                        "Value": "Check balance"
                    },
                    {
                        "Text": "Escalate to agent",
                        "Value": "Escalate to agent"
                    }
                ]
            }
        }
    ]
}

Bei einer Fehlerantwort enthält das Feld Inhalt eine Fehlermeldung und einen Code im folgenden Format:

{
    "Code": error_code
}
ContentType

Das ContentType bezieht sich auf den Typ der Nutzlast, die das Content Feld enthält, und muss aktiviert werden, um das Content Feld zu analysieren.

Anmerkung

Der Lex V2-Bot verwendet einen anderenContentType.

ContentTypeist application/amz-chime-lex-msgs für eine erfolgreiche Antwort oder application/amz-chime-lex-error für eine fehlgeschlagene Antwort auf eingestellt.

MessageAttributes

A MessageAttributeist eine Zuordnung von Zeichenkettenschlüsseln zu Zeichenkettenwerten. Eine Antwort von einem AppInstanceBot enthält die folgenden Nachrichtenattribute, die einer Antwort von einem Amazon Lex Lex-Bot zugeordnet sind.

  • chime.lex.sessionState.intent.name — Der Name der Lex-Bot-Absicht, die die Anfrage zu erfüllen versuchte.

  • chime.lex.sessionState.intent.state — Der aktuelle Status der Absicht. Zu den möglichen Werten gehören:, undFulfilled. InProgress Failed

  • chime.lex.SessionState. originatingRequestId— Eine eindeutige Kennung für eine bestimmte Anfrage an den Amazon Lex Lex-Bot. Dies ist auf die ursprüngliche MessageId Benutzernachricht gesetzt, die den ausgelöst hat AppInstanceBot.

  • chime.lex.sessionState.sessionId — Eine eindeutige Kennung für eine Konversation zwischen dem Benutzer und dem Bot. Wenn ein Benutzer einen Chat mit Ihrem Bot startet, erstellt Amazon Lex eine Sitzung.

Weitere Informationen zu Amazon Lex-Sitzungen und Sitzungsstatus finden Sie SessionStatein der Amazon Lex API-Referenz und unter Verwalten von Sitzungen im Amazon Lex V2 Developer Guide

Weitere Informationen zu den Attributen, die Amazon Lex V2 zurückgibt, finden Sie in den Amazon Lex Runtime V2-APIs.