Abilitare i log delle conversazioni Disabilitare i log delle conversazioni

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 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 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.

Se crei un ruolo collegato al servizio utilizzando il AWS Command Line Interface, devi aggiungere un suffisso personalizzato al ruolo utilizzando l'custom-suffixopzione 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.


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

Abilitare i log delle conversazioni

Per attivare i log utilizzando la console

Apri la console Amazon Lex https://console.aws.amazon.com/lex.
Dall'elenco, scegliere un bot.
Scegliere la scheda Settings (Impostazioni) quindi scegliere Conversation logs (Log delle conversazioni) dal menu a sinistra.
Nell'elenco degli alias, scegliere l'icona delle impostazioni per l'alias per il quale si desidera configurare i log delle conversazioni.
Scegliere se registrare testo, audio o entrambi.
Per la registrazione di testo, inserisci il nome del gruppo di log di Amazon CloudWatch Logs.
Per la registrazione dell'audio, inserire le informazioni del bucket S3.
Facoltativo. Per crittografare i log audio, scegli la AWS KMS chiave da utilizzare per la crittografia.
Scegli un ruolo IAM con le autorizzazioni richieste.
Scegliere Save (Salva) per iniziare a registrare le conversazioni.

Per attivare i log di testo utilizzando l'API

Chiamare l'operazione PutBotAlias 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
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

Chiamare l'operazione PutBotAlias 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
- Facoltativo. Per crittografare i log audio con una AWS KMS chiave specifica, imposta il kmsKeyArn membro dell'ARN della chiave utilizzata per la crittografia.
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

Apri la console Amazon Lex https://console.aws.amazon.com/lex.
Dall'elenco, scegliere un bot.
Scegliere la scheda Settings (Impostazioni) quindi scegliere Conversation logs (Log delle conversazioni) dal menu a sinistra.
Nell'elenco degli alias, scegliere l'icona delle impostazioni per l'alias per il quale si desidera configurare i log delle conversazioni.
Deselezionare la casella di controllo da testo, audio o entrambi per disattivare la registrazione.
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 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 senza il campo conversationLogs.

Per disattivare i log audio utilizzando l'API

- In caso di registrazione del testo
  - Chiamare l'operazione PutBotAlias 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 senza il campo conversationLogs.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Politiche IAM per i registri delle conversazioni

Crittografare i log delle conversazioni