Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Configurazione dei log delle conversazioni
Si possono abilitare e disabilitare i log delle conversazioni utilizzando la console o il campo `conversationLogs` dell'operazione `PutBotAlias`. È possibile attivare o disattivare i log audio, i log di testo o entrambi. La registrazione inizia nelle nuove sessioni del bot. Le modifiche apportate alle impostazioni dei log non si riflettono nelle sessioni attive.
Per archiviare i log di testo, utilizza un gruppo di log Amazon CloudWatch Logs nel tuo AWS account. È possibile utilizzare qualsiasi gruppo di log valido. Il gruppo di log deve trovarsi nella stessa regione del bot Amazon Lex. Per ulteriori informazioni sulla creazione di un gruppo di log CloudWatch Logs, consulta [Working with Log Groups and Log Streams](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html) nella *Amazon CloudWatch Logs* User Guide.
Per archiviare i log audio, usa un bucket Amazon S3 nel tuo account. AWS È possibile utilizzare qualsiasi bucket S3 valido. Il bucket deve trovarsi nella stessa regione del bot Amazon Lex. Per ulteriori informazioni sulla creazione di un bucket S3, consulta [Create a bucket](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) nella *Amazon Simple Storage Service Getting* Started Guide.
È necessario fornire un ruolo IAM con policy che consentano ad Amazon Lex di scrivere nel gruppo di log o nel bucket configurato. Per ulteriori informazioni, consulta [Creazione di un ruolo IAM e delle policy per i log delle conversazioni](conversation-logs-policies.md#conversation-logs-role-and-policy).
Se crei un ruolo collegato al servizio utilizzando il AWS Command Line Interface, devi aggiungere un suffisso personalizzato al ruolo utilizzando l'`custom-suffix`opzione seguente:
```
aws iam create-service-linked-role \
--aws-service-name lex.amazon.aws.com \
--custom-suffix suffix
```
Il ruolo IAM utilizzato per abilitare i registri delle conversazioni deve disporre dell'autorizzazione. `iam:PassRole` Al ruolo deve essere collegata la policy seguente.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## Abilitare i log delle conversazioni
**Per attivare i log utilizzando la console**
1. Apri la console Amazon Lex [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).
1. Dall'elenco, scegliere un bot.
1. Scegliere la scheda **Settings (Impostazioni)** quindi scegliere **Conversation logs (Log delle conversazioni)** dal menu a sinistra.
1. Nell'elenco degli alias, scegliere l'icona delle impostazioni per l'alias per il quale si desidera configurare i log delle conversazioni.
1. Scegliere se registrare testo, audio o entrambi.
1. Per la registrazione di testo, inserisci il nome del gruppo di log di Amazon CloudWatch Logs.
1. Per la registrazione dell'audio, inserire le informazioni del bucket S3.
1. Opzionale. Per crittografare i log audio, scegli la AWS KMS chiave da utilizzare per la crittografia.
1. Scegli un ruolo IAM con le autorizzazioni richieste.
1. Scegliere **Save (Salva)** per iniziare a registrare le conversazioni.
**Per attivare i log di testo utilizzando l'API**
1. Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) con una voce nel membro `logSettings` del campo `conversationLogs`
+ Impostare il membro `destination` su `CLOUDWATCH_LOGS`
+ Impostare il membro `logType` su `TEXT`
+ Imposta il `resourceArn` membro sull'Amazon Resource Name (ARN) del gruppo di log CloudWatch Logs che è la destinazione dei log
1. Imposta il `iamRoleArn` membro del `conversationLogs` campo sull'Amazon Resource Name (ARN) di un ruolo IAM che dispone delle autorizzazioni necessarie per abilitare i log delle conversazioni sulle risorse specificate.
**Per attivare i log audio utilizzando l'API**
1. Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) con una voce nel membro `logSettings` del campo `conversationLogs`
+ Impostare il membro `destination` su `S3`
+ Impostare il membro `logType` su `AUDIO`
+ Impostare il membro `resourceArn` sull'ARN del bucket Amazon S3 in cui sono archiviati i log audio
+ Opzionale. Per crittografare i log audio con una AWS KMS chiave specifica, imposta il `kmsKeyArn` membro dell'ARN della chiave utilizzata per la crittografia.
1. Imposta il `iamRoleArn` membro del `conversationLogs` campo sull'Amazon Resource Name (ARN) di un ruolo IAM che dispone delle autorizzazioni necessarie per abilitare i log delle conversazioni sulle risorse specificate.
## Disabilitare i log delle conversazioni
**Per disattivare i log utilizzando la console**
1. Apri la console Amazon Lex [https://console.aws.amazon.com/lex](https://console.aws.amazon.com/lex).
1. Dall'elenco, scegliere un bot.
1. Scegliere la scheda **Settings (Impostazioni)** quindi scegliere **Conversation logs (Log delle conversazioni)** dal menu a sinistra.
1. Nell'elenco degli alias, scegliere l'icona delle impostazioni per l'alias per il quale si desidera configurare i log delle conversazioni.
1. Deselezionare la casella di controllo da testo, audio o entrambi per disattivare la registrazione.
1. Scegliere **Save (Salva)** per interrompere la registrazione delle conversazioni.
**Per disattivare i log utilizzando l'API**
+ Chiamare l'operazione `PutBotAlias` senza il campo `conversationLogs`.
**Per disattivare i log di testo utilizzando l'API**
+
+ In caso di registrazione dell'audio
+ Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) con una voce `logSettings` solo per `AUDIO`.
+ La chiamata all'operazione `PutBotAlias` non deve avere una voce `logSettings` per `TEXT`.
+ Se non si sta registrando l'audio
+ Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) senza il campo `conversationLogs`.
**Per disattivare i log audio utilizzando l'API**
+
+ In caso di registrazione del testo
+ Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) con una voce `logSettings` solo per `TEXT`.
+ La chiamata all'operazione `PutBotAlias` non deve avere una voce `logSettings` per `AUDIO`.
+ Se non si sta registrando il testo
+ Chiamare l'operazione [PutBotAlias](API_PutBotAlias.md) senza il campo `conversationLogs`.