Elaborazione delle risposte da un AppInstanceBot

Quando un utente invia un messaggio, AppInstanceBot risponde con un messaggio di canale. Puoi elencare i messaggi del canale per ottenere la risposta del bot.

L'esempio seguente mostra come utilizzare la CLI per elencare i messaggi del canale.

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

Le risposte di successo di un utente AppInstanceBot assumono il seguente formato.

{
    "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

Il Content campo contiene un elenco di messaggi provenienti dal bot Amazon Lex V2. Per ulteriori informazioni su questi messaggi, consulta la sezione Messaggi nell'RecognizeTextAPI Amazon Lex V2.

L'esempio seguente mostra come utilizzare il Content campo in un messaggio di benvenuto.

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

Per una risposta di errore, il campo Contenuto contiene un messaggio di errore e un codice nel seguente formato:

{
    "Code": error_code
}

ContentType

ContentTypeSi riferisce al tipo di payload contenuto nel Content campo e deve essere selezionato per analizzare il Content campo.

Nota

Il bot Lex V2 utilizza un altroContentType.

ContentTypeè impostato application/amz-chime-lex-msgs per una risposta di successo o application/amz-chime-lex-error per una risposta di errore.

MessageAttribute

A MessageAttributeè una mappa di chiavi di stringa in valori di stringa. Una risposta di an AppInstanceBot contiene i seguenti attributi del messaggio mappati a una risposta di un bot Amazon Lex.

• chime.lex.sessionState.intent.name — Il nome dell'intento del bot Lex che la richiesta ha cercato di soddisfare.

• chime.lex.SessionState.intent.state — Lo stato attuale dell'intento. I valori possibili includono:, Fulfilled e InProgressFailed.

• chime.lex.SessionState. originatingRequestId— Un identificatore univoco per una richiesta specifica al bot Amazon Lex. Viene impostato sul messaggio dell'utente MessageId di origine che ha attivato il. AppInstanceBot

• chime.lex.sessionstate.sessionID — Un identificatore univoco per una conversazione tra l'utente e il bot. Quando un utente avvia una chat con il tuo bot, Amazon Lex crea una sessione.

Per ulteriori informazioni sulle sessioni e gli stati delle sessioni di Amazon Lex, consulta Amazon Lex API Reference e Managing sessions nella Amazon Lex V2 Developer Guide SessionState

Per ulteriori informazioni sugli attributi restituiti da Amazon Lex V2, consulta le API Amazon Lex Runtime V2.