Visualização de registros de texto no Amazon CloudWatch Logs

O Amazon Lex V2 armazena registros de texto para suas conversas no Amazon CloudWatch Logs. Para visualizar os registros, use o console ou a API de CloudWatch registros. Para obter mais informações, consulte Pesquisar dados de log usando padrões de filtro e sintaxe de consulta doCloudWatch Logs Insights no Guia do usuário do Amazon CloudWatch Logs.

Para visualizar os logs usando o Amazon Lex V2

1. Abra o console Amazon Lex V2 https://console.aws.amazon.com/lexv2.

2. Na lista, escolha um bot.

3. No menu à esquerda, escolha Análise e, em seguida, escolha CloudWatch métricas.

4. Veja as métricas do seu bot na página de CloudWatch métricas.

Você também pode usar o CloudWatch console ou a API para visualizar suas entradas de registro. Para localizar as entradas de log, navegue até o grupo de logs configurado para o alias. Você pode encontrar o prefixo do stream de registros para seus registros no console do Amazon Lex V2 ou usando a DescribeBotAliasoperação.

As entradas de registro para uma declaração do usuário são encontradas em vários fluxos de registro. Uma expressão na conversa tem uma entrada em um dos fluxos de log com o prefixo especificado. Uma entrada no fluxo de log contém as seguintes informações.

versão da mensagem

A versão do esquema de mensagens.

bot

Detalhes sobre o bot com o qual o cliente está interagindo.

messages

A resposta que o bot enviou de volta ao usuário.

Contexto do enunciado

Informações sobre o processamento desta declaração.

• runtimeHints—contexto de tempo de execução usado para transcrever e interpretar a entrada do usuário. Para obter mais informações, consulte Usando dicas de tempo de execução para melhorar o reconhecimento dos valores dos slots.

• slotElicitationStyle—Estilo de elicitação de slots usado para interpretar a entrada do usuário. Para obter mais informações, consulte Usando estilos de ortografia para capturar valores de slots.

Estado da sessão

O estado atual da conversa entre o usuário e o bot. Para obter mais informações, consulte Gerenciando conversas.

interpretações

Uma lista de intenções que o Amazon Lex V2 determinou que poderiam satisfazer a declaração do usuário. Usando pontuações de confiança.

sessionId

O identificador da sessão do usuário que está tendo a conversa.

inputTranscript

A transcrição da entrada do usuário usada para reconhecer a intenção e os valores do slot.

transcrições

Uma lista de possíveis transcrições da entrada do usuário. Para obter mais informações, consulte Usando pontuações de confiança na transcrição de voz.

Eutério perdido

Indica se o Amazon Lex V2 foi capaz de reconhecer a expressão do usuário.

requestId

ID de solicitação gerada pelo Amazon Lex V2 para a entrada do usuário.

timestamp

A data e hora da entrada do usuário.

Desenvolvedor Override

Indica se o fluxo da conversa foi atualizado usando um gancho de código de diálogo. Para obter mais informações sobre como usar um gancho de código de diálogo, consulteUsando umaAWS Lambda função.

Modo de entrada

Indica o tipo de entrada. Pode ser áudio, DTMF ou texto.

requestAttributes

Os atributos da solicitação usados ao processar a entrada do usuário.

Propriedades de áudio

Se os registros de conversas de áudio estiverem ativados e a entrada do usuário estiver em formato de áudio, incluirá a duração total da entrada de áudio, a duração da voz e a duração do silêncio no áudio. Ele também inclui um link para o arquivo de áudio.

BarGein

Indica se a entrada do usuário interrompeu a resposta anterior do bot.

Motivo da resposta

O motivo pelo qual uma resposta foi gerada. Pode ser um dos:

• UtteranceResponse— resposta à entrada do usuário

• StartTimeout— resposta gerada pelo servidor quando o usuário não forneceu a entrada

• StillWaitingResponse— resposta gerada pelo servidor quando o usuário solicita que o bot espere

• FulfillmentInitiated— resposta gerada pelo servidor de que o atendimento está prestes a ser iniciado

• FulfillmentStartedResponse— resposta gerada pelo servidor de que o atendimento começou

• FulfillmentUpdateResponse— resposta periódica gerada pelo servidor enquanto o atendimento está em andamento

• FulfillmentCompletedResponse— resposta gerada pelo servidor quando o atendimento é concluído.

operationName

A API usada para interagir com o bot. Pode ser um dosPutSessionRecognizeText,RecognizeUtterance, ouStartConversation.

{
    "message-version": "2.0",
    "bot": {
        "id": "string",
        "name": "string",
        "aliasId": "string",
        "aliasName": "string",
        "localeId": "string",
        "version": "string"
    },
    "messages": [
        {
            "contentType": "PlainText | SSML | CustomPayload | ImageResponseCard",
            "content": "string",
            "imageResponseCard": {
                "title": "string",
                "subtitle": "string",
                "imageUrl": "string",
                "buttonsList": [
                    {
                        "text": "string",
                        "value": "string"
                    }
                ]
            }
        }
    ],
    "utteranceContext": {
        "activeRuntimeHints": {
            "slotHints": {
                "string": {
                    "string": {
                        "runtimeHintValues": [
                            {
                                "phrase": "string"
                            },
                            {
                                "phrase": "string"
                            }
                        ]
                    }
                }
            }
        },
        "slotElicitationStyle": "string"
    },
    "sessionState": {
        "dialogAction": {
            "type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
            "slotToElicit": "string"
        },
        "intent": {
            "name": "string",
            "slots": {
                "string" : { 
                    "value": { 
                       "interpretedValue": "string",
                       "originalValue": "string",
                       "resolvedValues": [ "string" ]
                    }
                 },  
                "string": {
                    "shape": "List",
                    "value": {
                        "originalValue":"string",
                        "interpretedValue":"string",
                        "resolvedValues":[ "string" ]
                    },
                    "values": [
                        {
                            "shape": "Scalar",
                            "value": {
                                "originalValue": "string",
                                "interpretedValue": "string",
                                "resolvedValues": [ "string" ]
                            }
                        },
                        {
                            "shape": "Scalar",
                            "value": {
                                "originalValue": "string",
                                "interpretedValue": "string",
                                "resolvedValues": [ "string" ]
                            }
                        }
                    ]
                }
            },
            "kendraResponse": {
                // Only present when intent is KendraSearchIntent. For details, see 
                // https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
                },
            "state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
            "confirmationState": "Confirmed | Denied | None"
        },
        "originatingRequestId": "string",
        "sessionAttributes": {
            "string": "string"
        },
        "runtimeHints": {
            "slotHints": {
                "string": {
                    "string": {
                        "runtimeHintValues": [
                            {
                                "phrase": "string"
                            },
                            {
                                "phrase": "string"
                            }
                        ]
                    }
                }
            }
        }
    },
   “dialogEventLogs”: [
        {
	  // only for conditional
     "conditionalEvaluationResult":[
      // all the branches until true

     {
     "conditionalBranchName": “String”,
     "expressionString": "String”
     "evaluatedExpression": " String”
     "evaluationResult": true/false
     }
    ],
  "dialogCodeHookInvocationLabel": String,
  "response": String,
  "nextStep": {
        "dialogAction": {
            "type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
            "slotToElicit": "string"
        },
	      "intent": {
                          "name": "string",
           "slots": {
               }
        }
       }
    ]
    "interpretations": [
        {
            "nluConfidence": "string",
            "intent": {
                "name": "string",
                "slots": {
                    "string": {
                        "value": {
                            "originalValue": "string",
                            "interpretedValue": "string",
                            "resolvedValues": [ "string" ]
                        }
                    },
                    "string": {
                        "shape": "List",
                        "value": {
                            "interpretedValue": "string",
                            "originalValue": "string",
                            "resolvedValues": [ "string" ]
                        },
                        "values": [
                            {
                                "shape": "Scalar",
                                "value": {
                                    "interpretedValue": "string",
                                    "originalValue": "string",
                                    "resolvedValues": [ "string" ]
                                }
                            },
                            {
                                "shape": "Scalar",
                                "value": {
                                    "interpretedValue": "string",
                                    "originalValue":"string",
                                    "resolvedValues": [ "string" ]
                                }

                            }
                        ]
                    }
                },
                "kendraResponse": {
                    // Only present when intent is KendraSearchIntent. For details, see 
                    // https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
                    },
                "state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
                "confirmationState": "Confirmed | Denied | None"
                },
            "sentimentResponse": {
                "sentiment": "string",
                "sentimentScore": {
                    "positive": "string",
                    "negative": "string",
                    "neutral": "string",
                    "mixed": "string"
                }
            }
        }
    ],
    "sessionId": "string",
    "inputTranscript": "string",
    "transcriptions": [
        {
            "transcription": "string",
            "transcriptionConfidence": {
                "score": "number"
            },
            "resolvedContext": {
                "intent": "string"
            },
            "resolvedSlots": {
                "string": {
                    "name": "slotName",
                    "shape": "List",
                    "value": { 
                        "originalValue": "string",
                        "resolvedValues": [
                            "string"
                        ]
                    }
                }
            }
        }
    ],
    "missedUtterance": "bool",
    "requestId": "string",
    "timestamp": "string",
    "developerOverride": "bool",
    "inputMode": "DTMF | Speech | Text",
    "requestAttributes": {
        "string": "string"
    },
    "audioProperties": {
        "contentType": "string",
        "s3Path": "string",
        "duration": {
            "total": "integer",
            "voice": "integer",
            "silence": "integer"
        }
    },
    "bargeIn": "string",
    "responseReason": "string",
    "operationName": "string"
}

O conteúdo da entrada de registro depende do resultado de uma transação e da configuração do bot e da solicitação.

• Os campos intent, slots e slotToElicit não aparecerão em uma entrada se o campo missedUtterance for true.

• O campo s3PathForAudio não aparecerá se os logs de áudio estiverem desativados ou se o campo inputDialogMode for Text.

• O campo responseCard só aparecerá quando você tiver definido um cartão de resposta para o bot.

• O mapa requestAttributes só aparecerá se você tiver especificado atributos de solicitação na solicitação.

• OkendraResponse campo só está presente quando eleAMAZON.KendraSearchIntent faz uma solicitação para pesquisar um índice do Amazon Kendra.

• OdeveloperOverride campo é verdadeiro quando uma intenção alternativa foi especificada na função Lambda do bot.

• O mapa sessionAttributes só aparecerá se você tiver especificado atributos de sessão na solicitação.

• O mapa sentimentResponse só aparecerá se você configurar o bot para retornar valores de sentimento.

nota

O formato de entrada pode mudar sem uma alteração correspondente em messageVersion. Seu código não deve gerar um erro se novos campos estiverem presentes.