管理选择性对话日志捕获 - Amazon Lex

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

管理选择性对话日志捕获

使用 Lex 控制台，您可以启用选择性对话日志捕获设置，并选择要为哪些槽位启用选择性对话日志捕获功能。

在 Amazon Lex V2 控制台中激活选择性对话日志捕获：

  1. 登录 AWS Management Console 并打开 Amazon Lex V2 主机，网址为 https://console.aws.amazon.com/lexv2/home。

  2. 从左侧面板中选择机器人，然后选择要启用选择性对话日志捕获的机器人。选择一个现有机器人，或创建一个新的机器人。

  3. 在左侧面板的部署部分下为所选机器人选择别名。

  4. 选择你的机器人的别名，然后选择管理对话日志。

  5. 在管理对话日志面板中，对于文本日志，点击单选按钮以选择是启用还是禁用文本日志。如果选择启用文本日志，则需要输入日志组名称或从下拉菜单中选择现有的日志组名称。如果您选择性地对文本文件进行日志记录，请选中选择性地对言语进行日志记录复选框。

    注意

    通过在构建时间设置中的对话日志设置（文本和/或音频）中选中选择性记录话语复选框来启用文本和/或音频日志。BotAlias您必须配置 CloudWatch 日志组和 Amazon S3 存储桶才能选择此选项。

  6. 在音频日志部分中，点击单选按钮以选择是启用还是禁用音频日志。如果您选择启用音频日志，则需要指定 Amazon S3 存储桶位置以及（可选）用于加密音频数据的 KMS 密钥。如果您选择性地对音频文件进行日志记录，请选中选择性地对言语进行日志记录复选框。

    用于管理对话日志的面板。

  7. 选择面板右下角的保存以保存您的选择性对话日志捕获设置。

在 Lex 控制台中激活选择性对话日志捕获：

  1. 转到意图，选择意图名称、初始响应、高级设置、设置值、会话属性。

  2. 根据要为其启用选择性对话日志捕获的意图和槽位，完成以下属性设置：

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

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

    用于添加选择性会话属性的面板。
    注意

    设置 x-amz-lex:enable-audio-logging:intent:slot = "true" 以捕获对话中仅包含特定槽位的言语。言语的日志记录操作作取决于在与会话属性表达式相比较的同时对言语内 intent:slot 进行的评估，以及相应的标志值。要对言语进行日志记录，会话属性中必须有至少一个表达式允许该日志记录操作，并且启用日志记录标志需要设置为 true。intent 和 slot 的值也可以是 "*"。如果槽位和/或意图值为 "*"，则表示的任何槽位和/或意图值 "*" 都将与其匹配。与 x-amz-lex:enable-audio-logging 类似，名为 x-amz-lex:enable-text-logging 的新会话属性将用于控制文本日志。

  3. 选择更新选项，然后构建机器人以包含更新的设置。

注意

您的 IAM 角色必须具有访问权限，才能允许您向 Amazon S3 存储桶写入数据并使用 KMS 密钥加密数据。Lex 将更新您的 IAM 角色，使其具有 Lex 访问 CloudWatch 日志组和选定的 Amazon S3 存储桶的权限。

选择性对话日志捕获的使用指南：

只有已在对话日志设置中启用文本和/或音频日志后，才能为文本和/或音频日志启用选择性对话日志捕获。您可以为文本和/或音频日志启用选择性对话日志捕获，从而禁用对话中所有意图和槽位的日志记录。要为特定意图和槽位生成文本和/或音频日志，必须将这些意图和槽位的文本或/和音频选择性对话日志捕获会话属性设置为 true。

  • 如果启用了选择性对话日志捕获，并且不存在带前缀 x-amz-lex:的会话属性，enable-audio-logging 则默认情况下，所有话语的日志记录都将处于禁用状态。这种情况在:启用文本记录方面也是如此。 x-amz-lex

  • 如果会话属性中至少有一个表达式允许，则将专门存储文本和/或音频对话片段的言语日志。

  • 只有已在机器人别名的“对话日志设置”中启用文本和/或音频的选择性对话日志捕获之后，会话属性中定义的文本和/或音频的选择性对话日志捕获配置才会生效；否则，会话属性将被忽略。

  • 启用选择性对话日志捕获后，“解释” 和 “转录” 中 SessionState未使用会话属性启用日志记录的任何时隙值都将在生成的文本日志中进行模糊处理。

  • 除用户可以提供槽位值以及意图引发的意图引发回合之外，将通过将机器人引发的槽位与选择性对话日志捕获会话属性进行匹配来对生成音频和/或文本日志的决定进行评估。在意图引发回合中，将当前回合中被填充的槽位与选择性对话日志捕获会话属性进行匹配

  • 被认为已填充的槽位来自回合结束时的会话状态。因此，Dialog Codehook Lambda 对处于会话状态的槽位所做的任何更改都将影响选择性对话日志捕获的行为。

  • 在意图引发回合中，如果用户给出了多个槽位值，则只有当文本/音频会话属性允许对该回合中被填充的所有槽位进行日志记录时，才会生成文本和/或音频日志。

  • 推荐的操作方法是在会话开始时设置选择性对话日志捕获会话属性，并且避免在会话期间对其进行修改。

  • 如果任何槽位包含敏感数据，则应始终启用槽位模糊处理。