Configurar logs de conversa - Amazon Lex V1

Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Depois de 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 ou os recursos do Amazon Lex V1. Se você estiver usando o Amazon Lex V2, consulte o guia do Amazon Lex V2 em vez disso.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar logs de conversa

Habilite e desabilite os logs de conversa usando o console ou o campo conversationLogs da operação PutBotAlias. É possível ativar ou desativar logs de áudio, logs de texto ou ambos. O registro em log começa em novas sessões do bot. As alterações nas configurações de log não são refletidas nas sessões ativas.

Para armazenar registros de texto, use um grupo de CloudWatch registros do Amazon Logs em sua AWS conta. É possível usar qualquer grupo de logs válido. O grupo de logs deve estar na mesma região que o bot do Amazon Lex. Para obter mais informações sobre a criação de um grupo de CloudWatch registros de registros, consulte Como trabalhar com grupos de registros e fluxos de registros no Guia do usuário do Amazon CloudWatch Logs.

Para armazenar registros de áudio, use um bucket do Amazon S3 em sua AWS conta. É possível usar qualquer bucket válido do S3. O bucket deve estar na mesma região que o bot do Amazon Lex. Para obter mais informações sobre como criar um bucket do Amazon S3, consulte Criar um bucket no Guia de conceitos básicos do Amazon Simple Storage Service.

É necessário fornecer um perfil do IAM com políticas que permitam ao Amazon Lex gravar no grupo de logs ou no bucket configurado. Para obter mais informações, consulte Criar um perfil e políticas do IAM para logs de conversa.

Se você criar uma função vinculada ao serviço usando o AWS Command Line Interface, deverá adicionar um sufixo personalizado à função usando a custom-suffix opção a seguir:

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

O perfil do IAM utilizado para habilitar logs de conversa deve ter a permissão iam:PassRole. A política a seguir deve ser anexada ao perfil.

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

Ativar logs de conversa

Para ativar os logs usando o console
  1. Abra o console do Amazon Lex https://console.aws.amazon.com/lex.

  2. Na lista, escolha um bot.

  3. Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.

  4. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.

  5. Selecione se deseja registrar texto, áudio ou ambos.

  6. Para registro de texto, insira o nome do grupo de CloudWatch registros do Amazon Logs.

  7. Para registro de áudio em log, insira as informações do bucket do S3.

  8. Opcional. Para criptografar registros de áudio, escolha a AWS KMS chave a ser usada para criptografia.

  9. Escolha uma perfil do IAM com as permissões necessárias.

  10. Escolha Salvar para iniciar o registro em log de conversas.

Como ativar logs de texto usando a API
  1. Chame a operação PutBotAlias com uma entrada no membro logSettings do campo conversationLogs

    • Defina o membro destination como CLOUDWATCH_LOGS

    • Defina o membro logType como TEXT

    • Defina o resourceArn membro como o Amazon Resource Name (ARN) do grupo de CloudWatch registros de registros que é o destino dos registros

  2. Defina o membro iamRoleArn do campo conversationLogs como o nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as permissões necessárias para habilitar logs de conversa nos recursos especificados.

Como ativar logs de áudio usando a API
  1. Chame a operação PutBotAlias com uma entrada no membro logSettings do campo conversationLogs

    • Defina o membro destination como S3

    • Defina o membro logType como AUDIO

    • Defina o membro resourceArn como o ARN do bucket do Amazon S3 onde os logs de áudio são armazenados

    • Opcional. Para criptografar registros de áudio com uma AWS KMS chave específica, defina o kmsKeyArn membro do ARN da chave usada para criptografia.

  2. Defina o membro iamRoleArn do campo conversationLogs como o nome do recurso da Amazon (ARN) de um perfil do IAM que tenha as permissões necessárias para habilitar logs de conversa nos recursos especificados.

Desativar logs de conversa

Como desativar os logs usando o console
  1. Abra o console do Amazon Lex https://console.aws.amazon.com/lex.

  2. Na lista, escolha um bot.

  3. Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.

  4. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.

  5. Desmarque a verificação de texto, áudio ou ambos para desativar o registro em log.

  6. Escolha Salvar para interromper o registro em log de conversas.

Como desativar os logs usando a API
  • Chame a operação PutBotAlias sem o campo conversationLogs.

Como desativar os logs de texto usando a API
    • Se você estiver registrando áudio

      • Chame a operação PutBotAlias com uma entrada logSettings somente para AUDIO.

      • A chamada para a operação PutBotAlias não deve ter uma entrada logSettings para TEXT.

    • Se você não estiver registrando áudio em log

      • Chame a operação PutBotAlias sem o campo conversationLogs.

Como desativar os logs de áudio usando a API
    • Se você estiver registrando texto em log

      • Chame a operação PutBotAlias com uma entrada logSettings somente para TEXT.

      • A chamada para a operação PutBotAlias não deve ter uma entrada logSettings para AUDIO.

    • Se você não estiver registrando texto em log

      • Chame a operação PutBotAlias sem o campo conversationLogs.