Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Após 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 nem os respectivos recursos. Se você estiver usando o Amazon Lex V2, consulte o [guia do Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html) 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) 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](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) 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](conversation-logs-policies.md#conversation-logs-role-and-policy). 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. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::111122223333: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](https://console.aws.amazon.com/lex). 1. Na lista, escolha um bot. 1. Selecione a guia **Configurações** e, no menu esquerdo, selecione **Logs de conversa**. 1. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa. 1. Selecione se deseja registrar texto, áudio ou ambos. 1. Para registro de texto, insira o nome do grupo de CloudWatch registros do Amazon Logs. 1. Para registro de áudio em log, insira as informações do bucket do S3. 1. Opcional. Para criptografar registros de áudio, escolha a AWS KMS chave a ser usada para criptografia. 1. Escolha uma perfil do IAM com as permissões necessárias. 1. Escolha **Salvar** para iniciar o registro em log de conversas. **Como ativar logs de texto usando a API** 1. Chame a operação [PutBotAlias](API_PutBotAlias.md) 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 1. 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](API_PutBotAlias.md) 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. 1. 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](https://console.aws.amazon.com/lex). 1. Na lista, escolha um bot. 1. Selecione a guia **Configurações** e, no menu esquerdo, selecione **Logs de conversa**. 1. Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa. 1. Desmarque a verificação de texto, áudio ou ambos para desativar o registro em log. 1. 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](API_PutBotAlias.md) 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](API_PutBotAlias.md) 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](API_PutBotAlias.md) 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](API_PutBotAlias.md) sem o campo `conversationLogs`.