Afficher les journaux textuels dans Amazon CloudWatch Logs - Amazon Lex V1

Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

 

Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.

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 les journaux textuels dans Amazon CloudWatch Logs

Amazon Lex stocke les journaux de texte de vos conversations dans Amazon CloudWatch Logs. Pour consulter les journaux, vous pouvez utiliser la console CloudWatch Logs ou l'API. 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

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

  2. Dans la liste, choisissez un bot.

  3. Choisissez l'onglet Settings (Paramètres) puis dans le menu de gauche, choisissez Conversation logs (Journaux de conversation).

  4. Cliquez sur le lien sous Journaux de texte pour afficher les journaux de l'alias dans la CloudWatch console.

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 trouverez le préfixe du flux de journal pour vos journaux dans la console Amazon Lex ou en utilisant l'GetBotAliasopération.

Les entrées de journal d'un énoncé 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 dans le flux de journaux contient les informations suivantes.

{
   "messageVersion": "1.0",
   "botName": "bot name",
   "botAlias": "bot alias",
   "botVersion": "bot version",
   "inputTranscript": "text used to process the request",
   "botResponse": "response from the bot",
   "intent": "matched intent",
   "nluIntentConfidence": "number",
   "slots": {
       "slot name": "slot value",
       "slot name": null,
       "slot name": "slot value"
       ...
   },
   "alternativeIntents": [
       {
           "name": "intent name",
           "nluIntentConfidence": "number",
           "slots": {
               "slot name": slot value,
               "slot name": null,
               "slot name": slot value
               ...
           }
       },
       {
           "name": "intent name",
           "nluIntentConfidence": number,
           "slots": {}
       }
   ],
   "developerOverride": "true" | "false",
   "missedUtterance": true | false,
   "inputDialogMode": "Text" | "Speech",
   "requestId": "request ID",
   "s3PathForAudio": "S3 path to audio file",
   "userId": "user ID",
   "sessionId": "session ID",
   "sentimentResponse": {
       "sentimentScore": "{Positive: number, Negative: number, Neutral: number, Mixed: number}",
       "sentimentLabel": "Positive" | "Negative" | "Neutral" | "Mixed"
   },
   "slotToElicit": "slot name",
   "dialogState": "ElicitIntent" | "ConfirmIntent" | "ElicitSlot" | "Fulfilled" | "ReadyForFulfillment" | "Failed",
   "responseCard": {
       "genericAttachments": [
           ...
       ],
       "contentType": "application/vnd.amazonaws.card.generic",
       "version": 1
    },
   "locale": "locale",
   "timestamp": "ISO 8601 UTC timestamp",
   "kendraResponse": {
      "totalNumberOfResults": number,
      "resultItems": [
          {
              "id": "query ID",
              "type": "DOCUMENT" | "QUESTION_ANSWER" | "ANSWER",
              "additionalAttributes": [
                  {
                     ...
                  }
              ],
              "documentId": "document ID",
              "documentTitle": {
                  "text": "title",
                  "highlights": null
              },
              "documentExcerpt": {
                  "text": "text",
                  "highlights": [
                      {
                          "beginOffset": number,
                          "endOffset": number,
                          "topAnswer": true | false
                      }
                  ]
              },
              "documentURI": "URI",
              "documentAttributes": []
          }  
      ],
      "facetResults": [],
      "sdkResponseMetadata": {
          "requestId": "request ID"
      },
      "sdkHttpMetadata": {
          "httpHeaders": {
              "Content-Length": "number",
              "Content-Type": "application/x-amz-json-1.1",
              "Date": "date and time",
              "x-amzn-RequestId": "request ID"
          },
          "httpStatusCode": 200
      },
      "queryId": "query ID"
   },
   "sessionAttributes": {
       "attribute name": "attribute value"
       ...
    },
   "requestAttributes": {
       "attribute name": "attribute value"
       ...
    }
}

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 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.

Vous devez disposer d'un rôle et d'un ensemble de politiques pour permettre à Amazon Lex d'écrire dans CloudWatch Logs. Pour plus d’informations, consultez Politiques IAM pour les journaux de conversation.