Configuration des journaux de conversation - Amazon Lex V1
Activation des journaux de conversationDésactivation des journaux de conversation

Avis de fin de support : le 15 septembre 2025, le support pour Amazon Lex V1 AWS sera interrompu. Après le 15 septembre 2025, vous ne pourrez plus accéder à la console Amazon Lex V1 ni aux ressources Amazon Lex V1. Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.

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.

Configuration des journaux de conversation

Vous activez et désactivez les journaux de conversation à l'aide de la console ou du champ conversationLogs de l'opération PutBotAlias. Vous pouvez activer ou désactiver les journaux audio, les journaux de texte ou les deux. La journalisation démarre sur les nouvelles sessions de bot. Les modifications apportées aux paramètres du journal ne sont pas prises en compte pour les sessions actives.

Pour stocker des journaux de texte, utilisez un groupe de CloudWatch journaux Amazon Logs dans votre AWS compte. Vous pouvez utiliser n'importe quel groupe de journaux valide. Le groupe de journaux doit se trouver dans la même région que le bot Amazon Lex. Pour plus d'informations sur la création d'un groupe de CloudWatch journaux, consultez la section Working with Log Groups and Log Streams dans le guide de l'utilisateur Amazon CloudWatch Logs.

Pour stocker des journaux audio, utilisez un compartiment Amazon S3 dans votre AWS compte. Vous pouvez utiliser n'importe quel compartiment S3 valide. Le compartiment doit se trouver dans la même région que le bot Amazon Lex. Pour plus d'informations sur la création d'un compartiment S3, consultez la section Créer un compartiment dans le guide de démarrage Amazon Simple Storage Service.

Vous devez fournir un rôle IAM avec des politiques qui permettent à Amazon Lex d'écrire dans le groupe de journaux ou le compartiment configuré. Pour de plus amples informations, veuillez consulter Création d'un rôle IAM et de stratégies pour les journaux de conversation.

Si vous créez un rôle lié à un service à l'aide du AWS Command Line Interface, vous devez ajouter un suffixe personnalisé au rôle à l'aide de l'custom-suffixoption suivante :

aws iam create-service-linked-role \
    --aws-service-name lex.amazon.aws.com \
    --custom-suffix suffix

Le rôle IAM que vous utilisez pour activer les journaux de conversation doit disposer de cette iam:PassRole autorisation. La stratégie suivante doit être attachée au rôle.

JSON
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iam:PassRole",
            "Resource": "arn:aws:iam::111122223333:role/role"
        }
    ]
}

Activation des journaux de conversation

Pour activer les journaux à l'aide de la console

  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. Dans la liste des alias, choisissez l'icône des paramètres de l'alias pour lequel vous souhaitez configurer les journaux de conversation.

  5. Indiquez si vous souhaitez consigner du texte, de l’audio ou les deux.

  6. Pour l'enregistrement de texte, entrez le nom du groupe de CloudWatch journaux Amazon Logs.

  7. Pour la journalisation de données audio, entrez les informations du compartiment S3.

  8. Facultatif. Pour chiffrer les journaux audio, choisissez la AWS KMS clé à utiliser pour le chiffrement.

  9. Choisissez un rôle IAM doté des autorisations requises.

  10. Choisissez Save (Enregistrer) pour démarrer la journalisation des conversations.

Pour activer les journaux de texte à l'aide de l'API

  1. Appelez l'opération PutBotAlias avec une entrée dans le membre logSettings du champ conversationLogs.

    • Définissez le membre destination sur CLOUDWATCH_LOGS

    • Définissez le membre logType sur TEXT

    • Définissez le resourceArn membre sur l'Amazon Resource Name (ARN) du groupe de CloudWatch journaux Logs qui est la destination des journaux

  2. Définissez le iamRoleArn membre du conversationLogs champ sur le nom de ressource Amazon (ARN) d'un rôle IAM disposant des autorisations requises pour activer les journaux de conversation sur les ressources spécifiées.

Pour activer les journaux audio à l'aide de l'API

  1. Appelez l'opération PutBotAlias avec une entrée dans le membre logSettings du champ conversationLogs.

    • Définissez le membre destination sur S3

    • Définissez le membre logType sur AUDIO

    • Définissez le membre resourceArn sur l'ARN du compartiment Amazon S3 où les journaux audio sont stockés.

    • Facultatif. Pour chiffrer les journaux audio avec une AWS KMS clé spécifique, définissez le kmsKeyArn membre de l'ARN de la clé utilisée pour le chiffrement.

  2. Définissez le iamRoleArn membre du conversationLogs champ sur le nom de ressource Amazon (ARN) d'un rôle IAM disposant des autorisations requises pour activer les journaux de conversation sur les ressources spécifiées.

Désactivation des journaux de conversation

Pour désactiver les journaux à l'aide de la console

  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. Dans la liste des alias, choisissez l'icône des paramètres de l'alias pour lequel vous souhaitez configurer les journaux de conversation.

  5. Désactivez la vérification du texte, de l'audio ou des deux pour désactiver la journalisation.

  6. Choisissez Save (Enregistrer) pour arrêter la journalisation des conversations.

Pour désactiver les journaux à l'aide de l'API

  • Appelez l'opération PutBotAlias sans le champ conversationLogs.

Pour désactiver les journaux de texte à l'aide de l'API

    • Si vous journalisez les données audio

      • Appelez l'opération PutBotAlias avec une entrée logSettings uniquement pour AUDIO.

      • L'appel à l'opération PutBotAlias ne doit pas avoir d'entrée logSettings pour TEXT.

    • Si vous ne journalisez pas les données audio

      • Appelez l'opération PutBotAlias sans le champ conversationLogs.

Pour désactiver les journaux des données audio à l'aide de l'API

    • Si vous journalisez du texte

      • Appelez l'opération PutBotAlias avec une entrée logSettings uniquement pour TEXT.

      • L'appel à l'opération PutBotAlias ne doit pas avoir d'entrée logSettings pour AUDIO.

    • Si vous ne journalisez pas de texte

      • Appelez l'opération PutBotAlias sans le champ conversationLogs.