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à.
# Registrazione delle conversazioni con i registri delle conversazioni in Lex V2
È possibile abilitare i *log delle conversazioni* per memorizzare le interazioni bot. Puoi utilizzare questi log per esaminare le prestazioni del bot e risolvere i problemi relativi alle conversazioni. È possibile registrare il testo per l'operazione [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html). È possibile registrare testo e audio per l'operazione [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html). Abilitando i registri delle conversazioni, ottieni una visione dettagliata delle conversazioni che gli utenti hanno con il tuo bot.
Ad esempio, una sessione con il bot ha un ID di sessione. È possibile utilizzare questo ID per ottenere la trascrizione della conversazione, incluse le enunciazioni dell'utente e le risposte corrispondenti del bot. Puoi anche ottenere metadati quali il nome dell'intento e i valori di slot per un'enunciazione.
**Nota**
Non è possibile utilizzare i log delle conversazioni con un bot soggetto al Children's Online Privacy Protection Act (COPPA).
I log delle conversazioni sono configurati per un alias. Ogni alias può avere impostazioni diverse per i log audio e di testo. È possibile abilitare log di testo, log audio o entrambi per ciascun alias. I registri di testo archiviano l'input di testo, le trascrizioni dell'input audio e i metadati associati nei registri. CloudWatch I log audio archiviano l'ingresso audio in Amazon S3. Puoi abilitare la crittografia dei log di testo e audio utilizzando AWS KMS Customer Managed. CMKs
Per configurare la registrazione, usa la console o l'operazione [CreateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotAlias.html)or [UpdateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateBotAlias.html). Dopo aver abilitato i registri delle conversazioni per un alias, utilizzando l'[RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html)operazione [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)o relativa a quell'alias vengono registrati gli enunciati di testo o audio nel gruppo di log Logs configurato CloudWatch o nel bucket S3.
**Topics**
+ [Politiche IAM per i registri delle conversazioni](conversation-logs-policies.md)
+ [Configurazione dei registri delle conversazioni per il tuo bot Lex V2](conversation-logs-configure.md)
+ [Visualizzazione dei log di testo in Amazon CloudWatch Logs da Lex V2](conversation-logs-cw.md)
+ [Accesso ai log audio in Amazon S3](conversation-logs-s3.md)
+ [Monitoraggio dello stato del registro delle conversazioni tramite metriche CloudWatch](conversation-logs-monitoring.md)
# Politiche IAM per i registri delle conversazioni
A seconda del tipo di registrazione selezionato, Amazon Lex V2 richiede l'autorizzazione per utilizzare i bucket Amazon CloudWatch Logs e Amazon Simple Storage Service (S3) per archiviare i log. È necessario creare ruoli e autorizzazioni AWS Identity and Access Management per consentire ad Amazon Lex V2 di accedere a queste risorse.
## Creazione di un ruolo IAM e delle policy per i log delle conversazioni
Per abilitare i log delle conversazioni, devi concedere l'autorizzazione di scrittura per CloudWatch Logs e Amazon S3. Se abiliti la crittografia degli oggetti per i tuoi oggetti S3, devi concedere l'autorizzazione di accesso alle AWS KMS chiavi utilizzate per crittografare gli oggetti.
Puoi utilizzare la console IAM, l'API IAM o AWS Command Line Interface per creare il ruolo e le policy. Queste istruzioni utilizzano l'AWS CLI per creare il ruolo e le policy.
**Nota**
Il codice seguente è formattato per Linux e MacOS. Per Windows, sostituire il carattere di continuazione della riga di Linux (\$1) con un accento circonflesso (^).
**Per creare un ruolo IAM per i registri delle conversazioni**
1. Creare un documento nella directory corrente chiamato **LexConversationLogsAssumeRolePolicyDocument.json**, aggiungervi il seguente codice e salvarlo. Questo documento di policy aggiunge Amazon Lex V2 come entità affidabile al ruolo. Ciò consente ad Amazon Lex V2 di assumere il ruolo di fornire log alle risorse configurate per i log delle conversazioni.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "lexv2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
1. Nella CLI di AWS, esegui il comando seguente per creare il ruolo IAM per i log delle conversazioni.
```
aws iam create-role \
--role-name role-name \
--assume-role-policy-document file://LexConversationLogsAssumeRolePolicyDocument.json
```
Successivamente, crea e allega una policy al ruolo che consenta ad Amazon Lex V2 di scrivere nei CloudWatch log.
**Per creare una policy IAM per la registrazione del testo della conversazione in Logs CloudWatch**
1. Crea un documento nella directory corrente denominata**LexConversationLogsCloudWatchLogsPolicy.json**, aggiungi la seguente politica IAM e salvalo.
1. Nella CLI di AWS, crea la policy IAM che concede l'autorizzazione di scrittura al gruppo di CloudWatch log Logs.
```
aws iam create-policy \
--policy-name cloudwatch-policy-name \
--policy-document file://LexConversationLogsCloudWatchLogsPolicy.json
```
1. Allega la policy al ruolo IAM che hai creato per i log delle conversazioni.
```
aws iam attach-role-policy \
--policy-arn arn:aws:iam::account-id:policy/cloudwatch-policy-name \
--role-name role-name
```
Se stai registrando l'audio in un bucket S3, crea una policy che consenta ad Amazon Lex V2 di scrivere nel bucket.
**Per creare una policy IAM per la registrazione audio in un bucket S3**
1. Creare un documento nella directory corrente chiamato **LexConversationLogsS3Policy.json**, aggiungervi la seguente policy e salvarlo.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject"
],
"Resource": "arn:aws:s3:::bucket-name/*"
}
]
}
```
------
1. Nella CLI di AWS, crea la policy IAM che concede l'autorizzazione di scrittura al tuo bucket S3.
```
aws iam create-policy \
--policy-name s3-policy-name \
--policy-document file://LexConversationLogsS3Policy.json
```
1. Collegare la policy al ruolo creato per i log delle conversazioni.
```
aws iam attach-role-policy \
--policy-arn arn:aws:iam::account-id:policy/s3-policy-name \
--role-name role-name
```
## Concessione dell'autorizzazione a passare un ruolo IAM
Quando utilizzi la console AWS Command Line Interface, il o un SDK AWS per specificare un ruolo IAM da utilizzare per i log delle conversazioni, l'utente che specifica il ruolo IAM dei log di conversazione deve avere l'autorizzazione a passare il ruolo ad Amazon Lex V2. Per consentire all'utente di passare il ruolo ad Amazon Lex V2, devi concedere l'`PassRole`autorizzazione all'utente, al ruolo o al gruppo IAM dell'utente.
La policy seguente definisce l'autorizzazione da concedere all'utente, al ruolo o al gruppo. È possibile utilizzare le chiavi di condizione `iam:AssociatedResourceArn` e `iam:PassedToService` per limitare l'ambito dell'autorizzazione. Per ulteriori informazioni, consulta [Garantire a un utente le autorizzazioni per passare un ruolo a un servizio AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html) e le [chiavi contestuali IAM and AWS STS Condition](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_iam-condition-keys.html) nella *AWS Identity and Access Management User Guide*.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role-name",
"Condition": {
"StringEquals": {
"iam:PassedToService": "lexv2.amazonaws.com"
},
"StringLike": {
"iam:AssociatedResourceARN": "arn:aws:lex:region:123456789012:bot:bot-name:bot-alias"
}
}
}
]
}
```
------
# Configurazione dei registri delle conversazioni per il tuo bot Lex V2
È possibile abilitare e disabilitare i registri delle conversazioni utilizzando la console o il `conversationLogSettings` campo dell'operazione `CreateBotAlias` o`UpdateBotAlias`. È 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 account AWS. È possibile utilizzare qualsiasi gruppo di log valido. Il gruppo di log deve trovarsi nella stessa regione del bot Amazon Lex V2. 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 V2. Per ulteriori informazioni sulla creazione di un bucket S3, consulta [Creating](https://docs.aws.amazon.com/AmazonS3/latest/gsg/CreatingABucket.html) a bucket nella *Amazon Simple Storage Service Getting* Started Guide.
Quando gestisci i log delle conversazioni utilizzando la console, la console aggiorna il tuo ruolo di servizio in modo che abbia accesso al gruppo di log e al bucket S3.
Se non utilizzi la console, devi fornire un ruolo IAM con policy che consentano ad Amazon Lex V2 di scrivere nel gruppo di log o nel bucket configurato. Se crei un ruolo collegato al servizio utilizzando AWS Command Line Interface, devi aggiungere un suffisso personalizzato al ruolo utilizzando l'`custom-suffix`opzione come nell'esempio seguente. 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).
```
aws iam create-service-linked-role \
--aws-service-name lexv2.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 allegata la seguente politica:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "iam:PassRole",
"Resource": "arn:aws:iam::111122223333:role/role"
}
]
}
```
------
## Attivazione dei registri delle conversazioni
**Per attivare i log utilizzando la console**
1. Apri la console Amazon Lex V2 [https://console.aws.amazon.com/lexv2.](https://console.aws.amazon.com/lexv2)
1. Dall'elenco, scegliere un bot.
1. **Dal menu a sinistra, scegli Alias.**
1. Nell'elenco degli alias, scegli l'alias per il quale desideri configurare i registri delle conversazioni.
1. **Nella sezione Registri delle **conversazioni, scegli Gestisci i registri** delle conversazioni.**
1. Per i log di testo, scegli **Abilita**, quindi inserisci il nome del gruppo di log di Amazon CloudWatch Logs.
1. Per i log audio, scegli **Enable**, quindi inserisci le informazioni sul bucket S3.
1. Opzionale. Per crittografare i log audio, scegli la AWS KMS chiave da usare per la crittografia.
1. Scegliere **Save (Salva)** per iniziare a registrare le conversazioni. Se necessario, Amazon Lex V2 aggiornerà il tuo ruolo di servizio con le autorizzazioni per accedere al gruppo di log CloudWatch Logs e al bucket S3 selezionato.
## Disabilitazione dei registri delle conversazioni in Lex V2
**Per disattivare i log utilizzando la console**
1. Apri la console Amazon Lex V2 [https://console.aws.amazon.com/lexv2.](https://console.aws.amazon.com/lexv2)
1. Dall'elenco, scegliere un bot.
1. **Dal menu a sinistra, scegli Alias.**
1. Nell'elenco degli alias, scegli l'alias per il quale desideri configurare i registri delle conversazioni.
1. **Nella sezione Registri delle **conversazioni, scegli Gestisci i registri** delle conversazioni.**
1. Disattiva la registrazione di testo, la registrazione audio o entrambe per disattivare la registrazione.
1. Scegliere **Save (Salva)** per interrompere la registrazione delle conversazioni.
# Visualizzazione dei log di testo in Amazon CloudWatch Logs da Lex V2
Amazon Lex V2 archivia i log di testo per le tue conversazioni in Amazon CloudWatch Logs. Per visualizzare i log, usa la console o l'API CloudWatch Logs. Per ulteriori informazioni, consulta [Search Log Data Using Filter Patterns](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/SearchDataFilterPattern.html) e [CloudWatch Logs Insights Query Syntax](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html) nella *Amazon CloudWatch Logs* User Guide.
**Per visualizzare i log utilizzando la console Amazon Lex V2**
1. Apri la console Amazon Lex V2 [https://console.aws.amazon.com/lexv2.](https://console.aws.amazon.com/lexv2)
1. Dall'elenco, scegliere un bot.
1. **Dal menu a sinistra, scegli **Analytics, quindi scegli Metriche**. CloudWatch **
1. Visualizza le metriche per il tuo bot nella pagina delle **CloudWatch metriche**.
Puoi anche utilizzare la CloudWatch console o l'API per visualizzare le voci di registro. Per trovare le voci del log, passare al gruppo di log configurato per l'alias. Puoi trovare il prefisso del flusso di log per i tuoi log nella console Amazon Lex V2 o utilizzando l'operazione. [DescribeBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotAlias.html)
Le voci di registro relative all'enunciazione di un utente si trovano in più flussi di log. Un'enunciazione nella conversazione ha una voce in uno dei flussi di log con il prefisso specificato. Una voce nel flusso di log contiene le seguenti informazioni:
versione del messaggio
La versione dello schema dei messaggi.
bot
Dettagli sul bot con cui il cliente interagisce.
messages
La risposta che il bot ha inviato all'utente.
UtteranceContext
Informazioni sull'elaborazione di questo enunciato.
+ `runtimeHints`—contesto di runtime utilizzato per trascrivere e interpretare l'input dell'utente. Per ulteriori informazioni, consulta [Miglioramento del riconoscimento dei valori degli slot con suggerimenti di runtime nella conversazione](using-hints.md).
+ `slotElicitationStyle`—Stile di elicitazione degli slot utilizzato per interpretare l'input dell'utente. Per ulteriori informazioni, consulta [Acquisizione dei valori degli slot con stili ortografici durante la conversazione](spelling-styles.md).
sessionState
Lo stato attuale della conversazione tra l'utente e il bot. Per ulteriori informazioni, consulta [Comprendere le conversazioni con i bot di Amazon Lex V2](managing-conversations.md).
interpretazioni
Un elenco di intenti che Amazon Lex V2 ha stabilito potrebbero soddisfare l'enunciato dell'utente. [Utilizzo dei punteggi di confidenza per migliorare la precisione della conversazione](confidence-scores.md).
Fonte di interpretazione
Indica se uno slot viene risolto da Amazon Lex V2 o Amazon Bedrock. Valori: Lex \$1 Bedrock
sessionId
L’identificatore della sessione utente in cui è in corso la conversazione.
inputTranscript
Una trascrizione dell'input dell'utente.
+ Per l'immissione di testo, si tratta del testo digitato dall'utente. Per l'input DTMF, questa è la chiave immessa dall'utente.
+ Per l'input vocale, questo è il testo in cui Amazon Lex V2 converte l'enunciato dell'utente per richiamare un intento o riempire uno slot.
rawInputTranscript
La trascrizione non elaborata dell'input dell'utente prima dell'applicazione di qualsiasi elaborazione del testo. Nota: l'elaborazione del testo è disponibile solo per le versioni locali en-US e en-GB.
trascrizioni
Un elenco di potenziali trascrizioni dell'input dell'utente. Per ulteriori informazioni, consulta [Usa i punteggi di confidenza nella trascrizione vocale per migliorare le conversazioni con il tuo bot Lex V2](using-transcript-confidence-scores.md).
Trascrizione non elaborata
Utilizzo dei punteggi di confidenza nella trascrizione vocale. Per ulteriori informazioni, consulta [Usa i punteggi di confidenza nella trascrizione vocale per migliorare le conversazioni con il tuo bot Lex V2](using-transcript-confidence-scores.md).
Enunciato perso
Indica se Amazon Lex V2 è stato in grado di riconoscere l'enunciato dell'utente.
requestId
Amazon Lex V2 ha generato l'ID della richiesta per l'input dell'utente.
timestamp
Il timestamp dell'input dell'utente.
DeveloperOverride
Indica se il flusso di conversazione è stato aggiornato utilizzando un hook di codice di dialogo. Per ulteriori informazioni sull'utilizzo di un hook di codici di dialogo, vedere[Integrazione di una AWS Lambda funzione nel tuo bot Amazon Lex V2](lambda.md).
InputMode
Indica il tipo di input. Può essere audio, DTMF o testo.
requestAttributes
Gli attributi della richiesta utilizzati durante l'elaborazione dell'input dell'utente.
Proprietà audio
Se i registri delle conversazioni audio sono abilitati e l'input dell'utente era in formato audio, include la durata totale dell'ingresso audio, la durata della voce e la durata del silenzio nell'audio. Include anche un collegamento al file audio.
Bargein
Indica se l'input dell'utente ha interrotto la precedente risposta del bot.
Motivo della risposta
Il motivo per cui è stata generata una risposta. Può essere uno dei seguenti:
+ `UtteranceResponse`— risposta all'input dell'utente
+ `StartTimeout`— risposta generata dal server quando l'utente non ha fornito alcun input
+ `StillWaitingResponse`— risposta generata dal server quando l'utente richiede al bot di attendere
+ `FulfillmentInitiated`— risposta generata dal server che indica che l'adempimento sta per essere avviato
+ `FulfillmentStartedResponse`— risposta generata dal server che indica che l'adempimento è iniziato
+ `FulfillmentUpdateResponse`— risposta periodica generata dal server durante l'evasione
+ `FulfillmentCompletedResponse`— risposta generata dal server quando l'adempimento è completo.
operationName
L'API utilizzata per interagire con il bot. Può essere uno dei `PutSession``RecognizeText`,`RecognizeUtterance`, o`StartConversation`.
```
{
"message-version": "2.0",
"bot": {
"id": "string",
"name": "string",
"aliasId": "string",
"aliasName": "string",
"localeId": "string",
"version": "string"
},
"messages": [
{
"contentType": "PlainText | SSML | CustomPayload | ImageResponseCard",
"content": "string",
"imageResponseCard": {
"title": "string",
"subtitle": "string",
"imageUrl": "string",
"buttonsList": [
{
"text": "string",
"value": "string"
}
]
}
}
],
"utteranceContext": {
"activeRuntimeHints": {
"slotHints": {
"string": {
"string": {
"runtimeHintValues": [
{
"phrase": "string"
},
{
"phrase": "string"
}
]
}
}
}
},
"slotElicitationStyle": "string"
},
"sessionState": {
"dialogAction": {
"type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
"slotToElicit": "string"
},
"intent": {
"name": "string",
"slots": {
"string": {
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
},
"string": {
"shape": "List",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
},
"values": [
{
"shape": "Scalar",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
},
{
"shape": "Scalar",
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
}
]
}
},
"kendraResponse": {
// Only present when intent is KendraSearchIntent. For details, see
// https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
},
"state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
"confirmationState": "Confirmed | Denied | None"
},
"originatingRequestId": "string",
"sessionAttributes": {
"string": "string"
},
"runtimeHints": {
"slotHints": {
"string": {
"string": {
"runtimeHintValues": [
{
"phrase": "string"
},
{
"phrase": "string"
}
]
}
}
}
}
},
"dialogEventLogs": [
{
// only for conditional
"conditionalEvaluationResult":[
// all the branches until true
{
"conditionalBranchName": "string",
"expressionString": "string",
"evaluatedExpression": "string",
"evaluationResult": "true | false"
}
],
"dialogCodeHookInvocationLabel": "string",
"response": "string",
"nextStep": {
"dialogAction": {
"type": "Close | ConfirmIntent | Delegate | ElicitIntent | ElicitSlot",
"slotToElicit": "string"
},
"intent": {
"name": "string",
"slots": {
}
}
}
]
"interpretations": [
{
"interpretationSource": "Bedrock | Lex",
"nluConfidence": "string",
"intent": {
"name": "string",
"slots": {
"string": {
"value": {
"originalValue": "string",
"interpretedValue": "string",
"resolvedValues": [ "string" ]
}
},
"string": {
"shape": "List",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
},
"values": [
{
"shape": "Scalar",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
},
{
"shape": "Scalar",
"value": {
"interpretedValue": "string",
"originalValue": "string",
"resolvedValues": [ "string" ]
}
}
]
}
},
"kendraResponse": {
// Only present when intent is KendraSearchIntent. For details, see
// https://docs.aws.amazon.com/kendra/latest/dg/API_Query.html#API_Query_ResponseSyntax
},
"state": "InProgress | ReadyForFulfillment | Fulfilled | Failed",
"confirmationState": "Confirmed | Denied | None"
},
"sentimentResponse": {
"sentiment": "string",
"sentimentScore": {
"positive": "string",
"negative": "string",
"neutral": "string",
"mixed": "string"
}
}
}
],
"sessionId": "string",
"inputTranscript": "string",
"rawInputTranscript": "string",
"transcriptions": [
{
"transcription": "string",
"rawTranscription": "string",
"transcriptionConfidence": "number",
},
"resolvedContext": {
"intent": "string"
},
"resolvedSlots": {
"string": {
"name": "slotName",
"shape": "List",
"value": {
"originalValue": "string",
"resolvedValues": [
"string"
]
}
}
}
}
],
"missedUtterance": "bool",
"requestId": "string",
"timestamp": "string",
"developerOverride": "bool",
"inputMode": "DTMF | Speech | Text",
"requestAttributes": {
"string": "string"
},
"audioProperties": {
"contentType": "string",
"s3Path": "string",
"duration": {
"total": "integer",
"voice": "integer",
"silence": "integer"
}
},
"bargeIn": "string",
"responseReason": "string",
"operationName": "string"
}
```
Il contenuto della voce di registro dipende dal risultato di una transazione e dalla configurazione del bot e della richiesta.
+ I campi `intent`, `slots` e `slotToElicit` non vengono visualizzati in una voce se il campo `missedUtterance` è `true`.
+ Il campo `s3PathForAudio` non compare se i log audio sono disabilitati o se il campo `inputDialogMode` è `Text`.
+ Il campo `responseCard` viene visualizzato solo quando è stata definita una scheda di risposta per il bot.
+ La mappa `requestAttributes` viene visualizzata solo se nella richiesta sono stati specificati attributi di richiesta.
+ Il `kendraResponse` campo è presente solo quando `AMAZON.KendraSearchIntent` effettua una richiesta di ricerca in un indice Amazon Kendra.
+ Il `developerOverride` campo è vero quando è stato specificato un intento alternativo nella funzione Lambda del bot.
+ La mappa `sessionAttributes` viene visualizzata solo se nella richiesta sono stati specificati attributi di sessione.
+ La mappa `sentimentResponse` viene visualizzata solo se si configura il bot per restituire i valori di sentiment.
**Nota**
Il formato di input potrebbe cambiare senza che corrisponda una modifica in `messageVersion`. Il codice non dovrebbe generare errori se sono presenti nuovi campi.
# Accesso ai log audio in Amazon S3
Amazon Lex V2 archivia i registri audio delle conversazioni in un bucket S3.
Puoi utilizzare la console o l'API di Amazon S3 per accedere ai log audio. Puoi visualizzare il prefisso della chiave oggetto S3 dei file audio nella console Amazon Lex V2 o nel campo nella `DescribeBotAlias` risposta `conversationLogSettings` dell'operazione.
# Monitoraggio dello stato del registro delle conversazioni tramite metriche CloudWatch
Usa Amazon CloudWatch per monitorare i parametri di consegna dei registri delle conversazioni. È possibile impostare allarmi sui parametri in modo da essere consapevoli dei problemi relativi alla registrazione, se dovessero verificarsi.
Amazon Lex V2 fornisce quattro parametri nello spazio dei `AWS/Lex` nomi per i log delle conversazioni:
+ `ConversationLogsAudioDeliverySuccess`
+ `ConversationLogsAudioDeliveryFailure`
+ `ConversationLogsTextDeliverySuccess`
+ `ConversationLogsTextDeliveryFailure`
Le metriche di successo mostrano che Amazon Lex V2 ha scritto correttamente i tuoi log audio o di testo nelle rispettive destinazioni.
Le metriche di errore mostrano che Amazon Lex V2 non è in grado di inviare log audio o di testo alla destinazione specificata. In genere si tratta di un errore di configurazione. Quando i parametri di errore sono superiori a zero, controllare quanto segue:
+ Assicurati che Amazon Lex V2 sia un'entità affidabile per il ruolo IAM.
+ Per la registrazione del testo, assicurati che esista il gruppo di CloudWatch log Logs. Per la registrazione dell'audio, verificare l'esistenza del bucket S3.
+ Assicurati che il ruolo IAM utilizzato da Amazon Lex V2 per accedere al gruppo di log CloudWatch Logs o al bucket S3 disponga dell'autorizzazione di scrittura per il gruppo di log o il bucket.
+ Assicurati che il bucket S3 esista nella stessa regione del bot Amazon Lex V2 e appartenga al tuo account.