View a markdown version of this page

Affichage des journaux de texte dans Amazon CloudWatch Logs depuis 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.

Affichage des journaux de texte dans Amazon CloudWatch Logs depuis Lex V2

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

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

  1. Ouvrez la console Amazon Lex V2 https://console.aws.amazon.com/lexv2.

  2. Dans la liste, choisissez un bot.

  3. Dans le menu de gauche, choisissez Analytics, puis choisissez CloudWatch Mesures.

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

Vous pouvez également utiliser la CloudWatch console ou l'API pour 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 journaux 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.

Contexte de l'énoncé

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 avec les robots Amazon Lex V2.

interprétations

Une liste d'intentions qui, selon Amazon Lex V2, pourraient satisfaire l'énoncé de l'utilisateur. Utiliser les scores de confiance pour améliorer la précision des conversations.

Source d'interprétation

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

sessionId

Identifiant de la session utilisateur en cours de conversation.

Transcription d'entrée

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

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

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

cru InputTranscript

La transcription brute de la saisie par l'utilisateur avant l'application de 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 données saisies par 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.

Transcription brute

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.

Émission manquée

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.

Developer Override

Indique si le flux de conversation a été mis à jour à l'aide d'un crochet de code de dialogue. Pour plus d'informations sur l'utilisation d'un crochet de code de dialogue, consultezIntégration d'une AWS Lambda fonction dans votre bot Amazon Lex V2.

Mode d'entrée

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

Attributs de la demande

Les attributs de demande utilisés lors du traitement de la saisie de l'utilisateur.

Propriétés audio

Si les journaux de conversations 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.

Péniche

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

Motif de la réponse

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 est sur le point d'être lancé

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

  • FulfillmentUpdateResponse— réponse périodique générée par le serveur pendant que le traitement est en cours

  • FulfillmentCompletedResponse— réponse générée par le serveur lorsque le traitement est terminé.

Nom de l'opération

L'API utilisée 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 de 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 autre intention 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.