Visualización de registros de texto en Amazon CloudWatch Logs

Amazon Lex V2 almacena los registros de texto de sus conversaciones en Amazon CloudWatch Logs. Para ver los registros, utilice la consola o la API de CloudWatch Logs. Para obtener más información, consulte Búsqueda de datos de registro mediante patrones de filtro y Sintaxis de consultas de CloudWatch Logs Insights en la Guía del usuario de Amazon CloudWatch Logs.

Ver los registros mediante la consola de Amazon Lex V2

1. Abra la consola de Amazon Lex V2 en https://console.aws.amazon.com/ecs/v2.

2. En la lista, seleccione un bot.

3. En el menú de la izquierda, selecciona Analytics y, a continuación, selecciona CloudWatch métricas.

4. Consulta las métricas de tu bot en la página de CloudWatch métricas.

También puedes usar la CloudWatch consola o la API para ver tus entradas de registro. Para buscar las entradas de registro, desplácese hasta el grupo de registros que configuró para el alias. Puede encontrar el prefijo de flujo de registro de sus registros en la consola Amazon Lex V2 o mediante la operación DescribeBotAlias.

Las entradas de registro para un enunciado de usuario se encuentran en varios flujos de registro. Un enunciado en la conversación tiene una entrada en uno de los flujos de registro con el prefijo especificado. Una entrada en el flujo de registro contiene la siguiente información:

versión-del-mensaje

Versión del esquema de mensajes.

bot

Detalles sobre el bot con el que interactúa el cliente.

mensajes

La respuesta que el bot envió al usuario.

Contexto del enunciado

Información sobre el procesamiento de este enunciado.

• runtimeHints—contexto de tiempo de ejecución utilizado para transcribir e interpretar la entrada del usuario. Para obtener más información, consulte Mejorar el reconocimiento de los valores de los slots con sugerencias en tiempo de ejecución.

• slotElicitationStyle—Estilo de obtención de slots utilizado para interpretar las entradas del usuario. Para obtener más información, consulte Capturar valores de slot con deletreo.

Estado de la sesión

El estado actual de la conversación entre el usuario y el bot. Para obtener más información, consulte Administrar conversaciones.

Interpretaciones

Una lista de intenciones que Amazon Lex V2 determinó que podían satisfacer el enunciado del usuario. Usar puntuaciones de confianza.

interpretationSource

Indica si Amazon Lex o Amazon Bedrock resuelven un slot. Valores: Lex | Bedrock

sessionId

El identificador de la sesión de usuario en la que se está manteniendo la conversación.

Transcripción de entrada

Una transcripción de la entrada del usuario.

• Para la entrada de texto, este es el texto que escribió el usuario. Para la entrada DTMF, esta es la clave que introdujo el usuario.

• En el caso de entrada de voz, este es el texto en el que Amazon Lex V2 convierte el enunciado del usuario para invocar una intención o llenar un slot.

sin procesar InputTranscript

La transcripción sin procesar de la entrada del usuario antes de aplicar cualquier procesamiento de texto. Nota: El procesamiento de texto es solo para las configuraciones regionales en-US y en-GB.

Transcripciones

Una lista de posibles transcripciones de las entradas del usuario. Para obtener más información, consulte Usar puntuaciones de confianza en la transcripción de voz.

Transcripción sin procesar

Usar puntuaciones de confianza en la transcripción de voz. Para obtener más información, consulte Usar puntuaciones de confianza en la transcripción de voz.

Enunciado perdido

Indica si Amazon Lex V2 ha podido reconocer el enunciado del usuario.

ID de solicitud

Amazon Lex V2 generó el ID de solicitud para la entrada del usuario.

Marca de tiempo

La marca temporal de la entrada del usuario.

Anulación del desarrollador

Indica si el flujo de la conversación se actualizó mediante un enlace de código de diálogo. Para obtener más información sobre el uso de un enlace de código de diálogo, consulte Habilitar la lógica personalizada con funciones de AWS Lambda.

Modo de entrada

Indica el tipo de campo de entrada. Puede ser audio, DTMF o texto.

Atributos de solicitud

Los atributos de solicitud utilizados al procesar la entrada del usuario.

Propiedades de audio

Si los registros de conversaciones de audio están habilitados y la entrada del usuario estaba en formato de audio, incluye la duración total de la entrada de audio, la duración de la voz y la duración del silencio en el audio. También incluye un enlace al archivo de audio.

BargeIn

Indica si la entrada del usuario interrumpió la respuesta anterior del bot.

Motivo de la respuesta

Motivo por el que se generó una respuesta. Puede ser uno de los siguientes:

• UtteranceResponse – respuesta a la entrada del usuario

• StartTimeout – respuesta generada por el servidor cuando el usuario no proporcionó información

• StillWaitingResponse – respuesta generada por el servidor cuando el usuario solicita al bot que espere

• FulfillmentInitiated – respuesta generada por el servidor de que el procesamiento está a punto de iniciarse

• FulfillmentStartedResponse – respuesta generada por el servidor en la que se indica que se ha iniciado el procesamiento

• FulfillmentUpdateResponse – respuesta periódica generada por el servidor mientras el procesamiento está en curso

• FulfillmentCompletedResponse – respuesta generada por el servidor cuando se completa el procesamiento.

Nombre de operación

La API utilizada para interactuar con el bot. Puede ser PutSession, RecognizeText, RecognizeUtterance o StartConversation.

{
    "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": [
        {
            "interpretationSource": "Bedrock | Lex",
            "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",
    "rawInputTranscript": "string",
    "transcriptions": [
        {
            "transcription": "string",
            "rawTranscription": "string",
            "transcriptionConfidence": "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"
}

El contenido de la entrada de registro depende del resultado de una transacción y de la configuración del bot y la solicitud.

• Los campos intent, slots y slotToElicit no aparecen en una entrada si el campo missedUtterance es true.

• El campo s3PathForAudio no aparece si los registros de audio están deshabilitados o si el campo inputDialogMode es Text.

• El campo responseCard solo aparece cuando se ha definido una tarjeta de respuesta para el bot.

• El mapa requestAttributes solo aparece si ha especificado atributos de solicitud en la solicitud.

• El campo kendraResponse solo está presente cuando AMAZON.KendraSearchIntent realiza una solicitud para buscar en un índice de Amazon Kendra.

• El campo developerOverride es verdadero cuando se especificó una intención alternativa en la función de Lambda del bot.

• El mapa sessionAttributes solo aparece si ha especificado atributos de sesión en la solicitud.

• El mapa sentimentResponse solo aparece si configura el bot para que devuelva valores de opinión.

nota

El formato de entrada puede cambiar sin un cambio correspondiente en la messageVersion. El código no debería devolver un error si hay nuevos campos.