Gerenciar a captura seletiva de log de conversa

Usando o console do Lex, você pode ativar as configurações de captura seletiva de registros de conversas e escolher em quais slots deseja habilitar a captura seletiva de log de conversas.

Ative a captura seletiva de logs de conversas no console Amazon Lex V2:

1. Faça login AWS Management Console e abra o console Amazon Lex V2 em https://console.aws.amazon.com/lexv2/home.

2. Selecione Bots nos painéis laterais esquerdos e escolha o bot que você deseja para ativar a captura seletiva do log de conversas. Use um bot existente ou crie um novo.

3. Escolha Aliases para o bot selecionado na seção Implantação no painel lateral esquerdo.

4. Escolha o alias do seu bot e selecione Gerenciar logs de conversas.

5. No painel Gerenciar logs de conversas, em Logs de texto, escolha se os logs de texto estão ativados ou desativados selecionando o botão de opção. Se você escolher Ativado para logs de texto, precisará inserir um Nome de grupo de logs ou escolher um nome de grupo de logs existente no menu suspenso. Marque a caixa de seleção Log seletivo de enunciados se você estiver criando logs seletivamente de arquivos de texto.

   nota

   Ative registros de texto e/ou áudio marcando a caixa de seleção Registrar frases seletivamente nas configurações de registros de conversação (texto e/ou áudio) nas configurações de tempo de construção. BotAlias Você deve configurar o grupo de CloudWatch logs e o bucket do Amazon S3 para selecionar essa opção.

6. Na seção Logs de áudio, escolha se os logs de áudio estão ativados ou desativados selecionando o botão de opção. Se você escolher Ativado para logs de áudio, precisará especificar a localização do bucket do Amazon S3 e (opcional) a chave KMS para criptografar seus dados de áudio. Marque a caixa de seleção Log seletivo de enunciados se você estiver criando logs seletivamente de arquivos de áudio.

   

7. Selecione Salvar no canto inferior direito do painel para salvar suas configurações de captura seletiva de log de conversas.

Ative a captura seletiva de logs de conversas no console Lex:

1. Vá até Intenções e selecione o Nome da intenção, Resposta inicial, Configurações avançadas, os Valores definidos e Atributos da sessão.

2. Defina os seguintes atributos com base nas intenções e nos slots para os quais você deseja ativar a captura seletiva do log de conversas:

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

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

   

   nota

   Defina x-amz-lex:enable-audio-logging:intent:slot = "true" para capturar enunciados que contenham somente um slot específico na conversa. A ação para criar log de um enunciado depende da avaliação de intenção: slot dentro do enunciado, em comparação com os enunciados do atributo da sessão, e o valor do sinalizador correspondente. Para criar log de um enunciado, pelo menos um enunciado no atributo de sessão deve permitir isso, com o sinalizador Ativar log definido como true. O valor da intenção e do slot também pode ser "*". Se o valor do slot e/ou da intenção for "*", significa que qualquer slot e/ou valor de intenção de "*" corresponderá a ele. Semelhante a x-amz-lex:enable-audio-logging, um novo atributo de sessão chamado x-amz-lex:enable-text-logging será usado para controlar logs de texto.

3. Selecione Opções de atualização e crie o bot para incluir as configurações atualizadas.

nota

Seu perfil do IAM deve ter permissão de acesso para permitir que você grave dados no bucket do Amazon S3 e use uma chave KMS para criptografar os dados. Lex atualizará sua função do IAM com as permissões do Lex para acessar o grupo de CloudWatch registros de registros e o bucket Amazon S3 selecionado.

Diretrizes para usar a captura seletiva de logs de conversas:

Você só pode ativar a captura seletiva de logs de conversas para logs de texto e/ou áudio quando tiver habilitado logs de texto e/ou áudio nas Configurações de logs de conversa. Ao ativar a captura seletiva de logs de conversas para logs de texto e/ou áudio, você desativa a criação de logs para todas as intenções e slots na conversa. Para gerar logs de texto e/ou áudio para intenções e slots específicos, você deve definir os atributos da sessão de captura seletiva de log de conversas de texto e/ou áudio para essas intenções e slots como “verdadeiros”.

• Se a captura seletiva do registro de conversação estiver ativada e nenhum atributo de sessão com o prefixo x-amz-lex: enable-audio-logging estiver presente, o registro será desativado por padrão para todos os enunciados. Esse cenário também é verdadeiro em relação x-amz-lex a:enable-text-logging.

• Os logs de enunciados serão armazenados exclusivamente para os segmentos de conversa em texto e/ou áudio, se pelo menos um enunciado no atributo de sessão permitir.

• As configurações para captura seletiva de log de conversas de texto e/ou áudio, conforme definido nos atributos da sessão, serão efetivas somente quando a captura seletiva do log de conversas para texto e/ou áudio estiver ativada nas Configurações do logs de conversa dentro do alias do bot; caso contrário, os atributos da sessão serão desconsiderados.

• Quando a captura seletiva do registro de conversas estiver ativada, quaisquer valores de slot em SessionState, Interpretações e Transcrições para os quais o registro não esteja ativado usando atributos de sessão serão ofuscados no registro de texto gerado.

• A decisão de produzir logs de áudio e/ou texto é avaliada combinando o slot obtido pelo bot com os atributos da sessão de captura seletiva do log de conversa, exceto pelo turno de elicitação de intenção, em que o usuário pode fornecer valores de slot junto com a elicitação de intenção. Em um turno de elicitação de intenção, os slots preenchidos no turno atual são comparados com os atributos da sessão de captura seletiva do log de conversas.

• Os slots considerados preenchidos são derivados do estado da sessão no final do turno. Portanto, quaisquer alterações feitas pelo Hook de código de diálogo do Lambda nos slots no estado da sessão influenciarão o comportamento da captura seletiva do log de conversa.

• Em um turno de elicitação de intenção, se vários valores de slot forem fornecidos pelo usuário, o log de texto e/ou áudio só será gerado se os atributos da sessão de texto/áudio permitirem a criação de log de todos os slots preenchidos nesse turno.

• A abordagem operacional recomendada é definir o atributo da sessão de captura seletiva do log de conversas no início da sessão e evitar modificá-lo durante a sessão.

• Se algum slot contiver dados confidenciais, você deve sempre habilitar a ofuscação do slot.