Afficher des journaux de texte dans Amazon CloudWatch Logs à partir de Lex V2 - Amazon Lex

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher des journaux de texte dans Amazon CloudWatch Logs à partir de Lex V2

Amazon Lex V2 stocke les journaux de texte de vos conversations dans Amazon CloudWatch Logs. Pour consulter les journaux, utilisez la console CloudWatch Logs ouAPI. Pour plus d'informations, consultez les données du journal de recherche à l'aide de modèles de filtres et la syntaxe de requête CloudWatch Logs Insights dans le guide de l'utilisateur Amazon CloudWatch Logs.

Pour consulter les journaux à l'aide de la console Amazon Lex V2

  1. Ouvrez la console Amazon Lex https://console---aws.amazon.com.rproxy.goskope.comV2/lexv2.

  2. Dans la liste, choisissez un bot.

  3. Dans le menu de gauche, choisissez Analytics, puis sélectionnez CloudWatch Metrics.

  4. Consultez les statistiques de votre bot sur la page CloudWatch des statistiques.

Vous pouvez également utiliser la CloudWatch console ou API consulter les entrées de votre journal. Pour rechercher des entrées de journal, accédez au groupe de journaux que vous avez configuré pour l'alias. Vous pouvez trouver le préfixe du flux de journal pour vos journaux dans la console Amazon Lex V2 ou en utilisant l'DescribeBotAliasopération.

Les entrées de journal correspondant à un énoncé d'utilisateur se trouvent dans plusieurs flux de journaux. Un énoncé dans la conversation comporte une entrée dans l'un des flux de journaux avec le préfixe spécifié. Une entrée du flux de journal contient les informations suivantes :

version du message

Version du schéma du message.

bot

Informations sur le bot avec lequel le client interagit.

messages

La réponse que le bot a renvoyée à l'utilisateur.

utteranceContext

Informations sur le traitement de cet énoncé.

sessionState

État actuel de la conversation entre l'utilisateur et le bot. Pour de plus amples informations, veuillez consulter Comprendre les conversations entre robots.

interprétations

Une liste d'intentions déterminées par Amazon Lex V2 pourrait satisfaire l'énoncé de l'utilisateur. Utiliser les scores de confiance pour améliorer la précision des conversations.

interpretationSource

Indique si un emplacement est résolu par Amazon Lex ou Amazon Bedrock. Valeurs : Lex | Bedrock

sessionId

Identifiant de la session utilisateur en cours de conversation.

inputTranscript

Une transcription de l'entrée de l'utilisateur.

  • Pour la saisie de texte, il s'agit du texte saisi par l'utilisateur. Pour la DTMF saisie, il s'agit de la clé saisie par l'utilisateur.

  • Pour la saisie vocale, il s'agit du texte en lequel Amazon Lex V2 convertit l'énoncé de l'utilisateur afin d'invoquer une intention ou de remplir un espace.

rawInputTranscript

Transcription brute des données saisies par l'utilisateur avant tout traitement de texte. Remarque : Le traitement de texte concerne uniquement les paramètres régionaux en-US et en-GB.

transcriptions

Une liste de transcriptions potentielles des entrées de l'utilisateur. Pour de plus amples informations, veuillez consulter Utiliser les scores de fiabilité de la transcription vocale pour améliorer les conversations avec votre robot Lex V2.

rawTranscription

Utilisation des scores de confiance de la transcription vocale. Pour de plus amples informations, veuillez consulter Utiliser les scores de fiabilité de la transcription vocale pour améliorer les conversations avec votre robot Lex V2.

missedUtterance

Indique si Amazon Lex V2 a pu reconnaître l'énoncé de l'utilisateur.

requestId

Amazon Lex V2 a généré un ID de demande pour la saisie par l'utilisateur.

timestamp

Horodatage de l'entrée de l'utilisateur.

developerOverride

Indique si le flux de conversation a été mis à jour à l'aide d'un crochet de dialogue. Pour plus d'informations sur l'utilisation d'un crochet de dialogue, consultezIntégrer un AWS Lambda fonctionne dans votre bot.

inputMode

Indique le type d'entrée. Il peut s'agir d'DTMFaudio ou de texte.

requestAttributes

Les attributs de demande utilisés lors du traitement de l'entrée de l'utilisateur.

audioProperties

Si les journaux de conversation audio sont activés et que l'entrée utilisateur était au format audio, inclut la durée totale de l'entrée audio, la durée de la voix et la durée du silence dans l'audio. Il inclut également un lien vers le fichier audio.

bargeIn

Indique si la saisie de l'utilisateur a interrompu la réponse précédente du bot.

responseReason

La raison pour laquelle une réponse a été générée. Les valeurs suivantes sont possibles :

  • UtteranceResponse— réponse aux entrées de l'utilisateur

  • StartTimeout— réponse générée par le serveur lorsque l'utilisateur n'a pas fourni d'entrée

  • StillWaitingResponse— réponse générée par le serveur lorsque l'utilisateur demande au bot d'attendre

  • FulfillmentInitiated— réponse générée par le serveur indiquant que le traitement des commandes est sur le point d'être lancé

  • FulfillmentStartedResponse— réponse générée par le serveur indiquant que l'expédition a commencé

  • FulfillmentUpdateResponse— réponse périodique générée par le serveur pendant que l'expédition est en cours

  • FulfillmentCompletedResponse— réponse générée par le serveur lorsque l'exécution est terminée.

operationName

Ils API sont utilisés pour interagir avec le bot. Cela peut être l'un des PutSessionRecognizeText,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": [
        {
            "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"
}

Le contenu de l'entrée du journal dépend du résultat d'une transaction et de la configuration du bot et de la demande.

  • Les champs intent, slots et slotToElicit n'apparaissent pas dans une entrée si le champ missedUtterance a la valeur true.

  • Le champ s3PathForAudio n'apparaît pas si les journaux audio sont désactivés ou si le champ inputDialogMode est Text.

  • Le champ responseCard n'apparaît que lorsque vous avez défini une carte de réponse pour le bot.

  • La carte requestAttributes n'apparaît que si vous avez spécifié des attributs de demande dans la demande.

  • Le kendraResponse champ n'est présent que lorsqu'il AMAZON.KendraSearchIntent fait une demande de recherche dans un index Amazon Kendra.

  • Le developerOverride champ est vrai lorsqu'une intention alternative a été spécifiée dans la fonction Lambda du bot.

  • La carte sessionAttributes n'apparaît que si vous avez spécifié des attributs de session dans la demande.

  • La carte sentimentResponse n'apparaît que si vous configurez le bot pour qu'il renvoie des valeurs de sentiment.

Note

Le format d'entrée peut changer sans modification correspondante dans messageVersion. Le code ne devrait pas générer une erreur si de nouveaux champs sont présents.