Bearbeitung von Antworten von einem AppInstanceBot

Wenn ein Benutzer eine Nachricht sendet, AppInstanceBot antwortet er mit einer Kanalnachricht. Du kannst 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

Erfolgsantworten 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",
}

Inhalt

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"
                    }
                ]
            }
        }
    ]
}

Für eine Fehlerreaktion enthält das Feld Inhalt eine Fehlermeldung und einen Code im folgenden Format:

{
    "Code": error_code
}

ContentType

Das ContentType bezieht sich auf die Art 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 Erfolgsreaktion oder application/amz-chime-lex-error für eine Fehlerreaktion auf aktiviert.

MessageAttributes

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

• Chime.Lex.SessionState.Intent.Name — Der Name der Lex-Bot-Absicht, die mit der Anfrage zu erfüllen versucht wurde.

• Chime.Lex.SessionState.Intent.State — Der aktuelle Status der Absicht. Zu den möglichen Werten gehören: FulfilledInProgress, undFailed.

• chime.lex.Sitzungsstatus. originatingRequestId— Eine eindeutige Kennung für eine bestimmte Anfrage an den Amazon Lex-Bot. Dies wird auf den Wert MessageId der ursprünglichen Benutzernachricht gesetzt, die die ausgelöst hatAppInstanceBot.

• 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 Managing Sessions im Amazon Lex V2-Entwicklerleitfaden

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