Gérer la capture sélective des journaux de conversation

À l'aide de la console Lex, vous pouvez activer les paramètres de capture sélective des journaux de conversation et choisir les emplacements pour lesquels vous souhaitez activer la capture sélective des journaux de conversation.

Activez la capture sélective du journal des conversations dans la console Amazon Lex V2 :

1. Connectez-vous à la console Amazon Lex V2 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/lexv2/home.

2. Sélectionnez Bots dans les panneaux de gauche et choisissez le bot pour lequel vous souhaitez activer la capture sélective du journal des conversations. Utilisez un bot existant ou créez-en un nouveau.

3. Choisissez les alias pour le bot que vous avez sélectionné dans la section Déploiement sur le panneau de gauche.

4. Choisissez l'alias de votre bot, puis sélectionnez Gérer les journaux de conversation.

5. Dans le panneau Gérer les journaux de conversation, pour les journaux de texte, choisissez si les journaux de texte sont activés ou désactivés en sélectionnant le bouton radio. Si vous choisissez Activé pour les journaux de texte, vous devez saisir un nom de groupe de journaux ou choisir un nom de groupe de journaux existant dans le menu déroulant. Cochez la case pour enregistrer les énoncés de manière sélective si vous enregistrez des fichiers texte de manière sélective.

   Note

   Activez les journaux texte et/ou audio en cochant la case Enregistrer les énoncés de manière sélective dans les paramètres des journaux de conversation (texte et/ou audio) dans les paramètres d'heure BotAliasde construction. Vous devez configurer le groupe de CloudWatch journaux et le compartiment Amazon S3 pour sélectionner cette option.

6. Dans la section Journaux audio, choisissez si les journaux audio sont activés ou désactivés en sélectionnant le bouton radio. Si vous choisissez Activé pour les journaux audio, vous devez spécifier l'emplacement du compartiment Amazon S3 et (facultatif) la clé KMS pour chiffrer vos données audio. Cochez la case pour enregistrer les énoncés de manière sélective si vous enregistrez des fichiers audio de manière sélective.

   

7. Sélectionnez Enregistrer dans le coin inférieur droit du panneau pour enregistrer vos paramètres de capture sélectifs du journal des conversations.

Activez la capture sélective du journal des conversations dans la console Lex :

1. Accédez à Intentions et sélectionnez le nom de l'intention, la réponse initiale, les paramètres avancés, les valeurs définies et les attributs de session.

2. Définissez les attributs suivants en fonction des intentions et des créneaux pour lesquels vous souhaitez activer la capture sélective des journaux de conversation :

   • x-amz-lex:enable-audio-logging:intent:slot = "true"

   • x-amz-lex:enable-text-logging:intent:slot = "true"

   

   Note

   x-amz-lex:enable-audio-logging:intent:slot = "true"Réglé pour capturer les énoncés qui ne contiennent qu'un créneau spécifique de la conversation. L'action d'enregistrement d'un énoncé dépend de l'évaluation de l'intention : emplacement dans l'énoncé, par rapport aux expressions des attributs de session, et valeur de l'indicateur correspondant. Pour enregistrer un énoncé, au moins une expression de l'attribut de session doit l'autoriser, l'indicateur d'activation de la journalisation étant défini sur. true La valeur de l'intention et du créneau peut "*" également l'être. Si la valeur d'emplacement et/ou d'intention est égale à cette valeur"*", cela signifie que tout emplacement et/ou valeur d'intention de "*" correspondra à cette valeur. De mêmex-amz-lex:enable-audio-logging, un nouvel attribut de session appelé x-amz-lex:enable-text-logging sera utilisé pour contrôler les journaux de texte.

3. Sélectionnez Options de mise à jour et créez le bot pour inclure les paramètres mis à jour.

Note

Votre rôle IAM doit disposer d'une autorisation d'accès pour vous permettre d'écrire des données dans le compartiment Amazon S3 et d'utiliser une clé KMS pour chiffrer les données. Lex mettra à jour votre rôle IAM avec les autorisations Lex pour accéder au groupe de CloudWatch journaux Logs et au compartiment Amazon S3 sélectionné.

Instructions relatives à l'utilisation de la capture sélective des journaux de conversation :

Vous ne pouvez activer la capture sélective des journaux de conversation pour les journaux texte et/ou audio que lorsque vous avez activé les journaux texte et/ou audio dans les paramètres du journal des conversations. En activant la capture sélective des journaux de conversation pour les journaux texte et/ou audio, vous désactivez la journalisation pour toutes les fins et tous les créneaux de la conversation. Pour générer des journaux de conversation textuels et/ou audio pour des objectifs et des emplacements particuliers, vous devez définir les attributs de session de capture de journaux de conversation sélectifs en texte et/ou audio pour ces intentions et ces emplacements sur « true ».

• Si la capture sélective du journal des conversations est activée et qu'aucun attribut de session portant le préfixe «  x-amz-lex : » enable-audio-logging n'est présent, la journalisation sera désactivée par défaut pour tous les énoncés. Ce scénario est également vrai en ce qui concerne : enable-text-logging x-amz-lex.

• Les journaux d'énoncés seront stockés exclusivement pour les segments de texte et/ou de conversation audio si au moins une expression de l'attribut de session le permet.

• Les configurations pour la capture sélective du texte et/ou de l'audio dans le journal des conversations, telles que définies dans les attributs de session, ne seront efficaces que lorsque la capture sélective du journal des conversations pour le texte et/ou le son est activée dans les paramètres du journal des conversations dans l'alias du bot ; sinon, les attributs de session ne seront pas pris en compte.

• Lorsque la capture sélective du journal des conversations est activée, toutes les valeurs de créneau dans SessionState les interprétations et les transcriptions pour lesquelles la journalisation n'est pas activée à l'aide des attributs de session seront masquées dans le journal de texte généré.

• La décision de produire des journaux audio et/ou textuels est évaluée en faisant correspondre le créneau obtenu par le bot aux attributs de session de capture sélective des journaux de conversation, à l'exception du tour d'obtention d'intention où l'utilisateur peut fournir des valeurs d'intervalle ainsi que l'obtention d'intentions. Lors d'un tour d'obtention d'intention, les créneaux remplis au tour actuel sont comparés aux attributs de session de capture sélective du journal des conversations.

• Les créneaux considérés comme remplis sont dérivés de l'état de la session à la fin du tour. Par conséquent, toute modification apportée par le Dialog Codehook Lambda aux emplacements dans l'état de session influencera le comportement de la capture sélective des journaux de conversation.

• Lors d'un tour d'obtention d'intention, si plusieurs valeurs de créneaux sont fournies par l'utilisateur, le journal texte et/ou audio ne sera généré que si les attributs de session texte/audio autorisent la journalisation de tous les créneaux remplis lors de ce tour.

• L'approche opérationnelle recommandée consiste à définir l'attribut de session de capture sélective du journal des conversations au début de la session et à ne pas le modifier pendant la session.

• Si des emplacements contiennent des données sensibles, vous devez toujours activer l'obfuscation des emplacements.