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-suffixsuffix
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
-
Abra o console do Amazon Lex https://console.aws.amazon.com/lex
. -
Na lista, escolha um bot.
-
Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.
-
Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.
-
Selecione se deseja registrar texto, áudio ou ambos.
-
Para registro de texto, insira o nome do grupo de CloudWatch registros do Amazon Logs.
-
Para registro de áudio em log, insira as informações do bucket do S3.
-
Opcional. Para criptografar registros de áudio, escolha a AWS KMS chave a ser usada para criptografia.
-
Escolha uma perfil do IAM com as permissões necessárias.
-
Escolha Salvar para iniciar o registro em log de conversas.
Como ativar logs de texto usando a API
-
Chame a operação PutBotAlias com uma entrada no membro
logSettings
do campoconversationLogs
-
Defina o membro
destination
comoCLOUDWATCH_LOGS
-
Defina o membro
logType
comoTEXT
-
Defina o
resourceArn
membro como o Amazon Resource Name (ARN) do grupo de CloudWatch registros de registros que é o destino dos registros
-
-
Defina o membro
iamRoleArn
do campoconversationLogs
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
-
Chame a operação PutBotAlias com uma entrada no membro
logSettings
do campoconversationLogs
-
Defina o membro
destination
comoS3
-
Defina o membro
logType
comoAUDIO
-
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.
-
-
Defina o membro
iamRoleArn
do campoconversationLogs
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
-
Abra o console do Amazon Lex https://console.aws.amazon.com/lex
. -
Na lista, escolha um bot.
-
Selecione a guia Configurações e, no menu esquerdo, selecione Logs de conversa.
-
Na lista de aliases, escolha o ícone de configurações para o alias para o qual você deseja configurar logs de conversa.
-
Desmarque a verificação de texto, áudio ou ambos para desativar o registro em log.
-
Escolha Salvar para interromper o registro em log de conversas.
Como desativar os logs usando a API
-
Chame a operação
PutBotAlias
sem o campoconversationLogs
.
Como desativar os logs de texto usando a API
-
-
Se você estiver registrando áudio
-
Chame a operação PutBotAlias com uma entrada
logSettings
somente paraAUDIO
. -
A chamada para a operação
PutBotAlias
não deve ter uma entradalogSettings
paraTEXT
.
-
-
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 paraTEXT
. -
A chamada para a operação
PutBotAlias
não deve ter uma entradalogSettings
paraAUDIO
.
-
-
Se você não estiver registrando texto em log
-
Chame a operação PutBotAlias sem o campo
conversationLogs
.
-
-