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à.
# Diversi modi per creare un bot con Amazon Lex V2
Puoi creare un bot con Amazon Lex V2 nei seguenti modi:
1. Usa la console Amazon Lex V2 per creare un bot utilizzando un'interfaccia Web. Per ulteriori informazioni, consulta [Creazione di un bot utilizzando la console Amazon Lex V2](create-bot-console.md).
1. Usa Descriptive Bot Builder per creare un bot utilizzando le funzionalità di intelligenza artificiale generativa di Amazon Bedrock. Per ulteriori informazioni, consulta [Usa una descrizione per creare un bot in Lex V2 con il generatore di bot descrittivo](nld-bots.md).
1. Utilizza i modelli di bot per creare un bot preconfigurato che corrisponda a casi d'uso aziendali comuni. Per ulteriori informazioni, consulta [Creazione di bot Amazon Lex V2 utilizzando modelli](bot-templates.md).
1. Usa un [SDK AWS](https://aws.amazon.com/tools/#sdk) per creare un bot utilizzando le operazioni API.
1. Usa lo strumento di progettazione di Chatbot automatizzati per creare un bot utilizzando le trascrizioni delle chat esistenti tra agenti e clienti. Per ulteriori informazioni, consulta [Creazione di bot Amazon Lex V2 utilizzando Automated Chatbot Designer](designing.md).
1. Importa una definizione di bot esistente. Per ulteriori informazioni, consulta [Importazione di bot in Lex V2](import.md).
1. Usa CloudFormation per creare un bot. Per ulteriori informazioni, consulta [Creazione di risorse Amazon Lex V2 con AWS CloudFormation](creating-resources-with-cloudformation.md).
**Topics**
+ [Creazione di un bot utilizzando la console Amazon Lex V2](create-bot-console.md)
+ [Creazione di bot Amazon Lex V2 utilizzando modelli](bot-templates.md)
+ [Creazione di bot Amazon Lex V2 utilizzando Automated Chatbot Designer](designing.md)
# Creazione di un bot utilizzando la console Amazon Lex V2
Crei un bot Amazon Lex V2 per interagire con i tuoi utenti e ottenere informazioni utili a svolgere un'attività. Ad esempio, puoi creare un bot che raccoglie le informazioni necessarie per ordinare fiori o prenotare una camera d'albergo. Per creare un bot utilizzando la console AWS, inizia definendo il nome, la descrizione e alcune informazioni di base.
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex all'indirizzo [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Scegli **Crea bot**.
1. Nella sezione **Metodo di creazione**, scegli **Traditional**, quindi seleziona **Crea un bot vuoto**.
1. Nella sezione **Configurazione del bot**, assegna al bot un nome e una descrizione opzionale.
1. Nella sezione **Autorizzazioni IAM**, scegli un ruolo AWS Identity and Access Management (IAM) che fornisce l'autorizzazione Amazon Lex V2 per accedere ad altri servizi AWS, come Amazon. CloudWatch Puoi fare in modo che Amazon Lex V2 crei il ruolo oppure puoi scegliere un ruolo esistente con CloudWatch autorizzazioni.
1. Nella sezione **Children's Online Privacy Protection Act (COPPA)**, scegli la risposta appropriata.
1. Nella sezione **Timeout della sessione** di inattività, scegli per quanto tempo Amazon Lex V2 mantiene aperta una sessione con un utente. Amazon Lex V2 mantiene le variabili di sessione per tutta la durata della sessione in modo che il bot possa riprendere una conversazione con le stesse variabili.
1. Nella sezione **Impostazioni avanzate** (opzionale), aggiungi tag che aiutano a identificare il bot, controllare l'accesso e monitorare le risorse.
1. Scegli **Avanti** per creare il bot e passare all'aggiunta di una lingua.
# Creazione di bot Amazon Lex V2 utilizzando modelli
Amazon Lex V2 offre soluzioni predefinite per creare esperienze su larga scala e promuovere il coinvolgimento digitale. I modelli di bot predefiniti automatizzano e standardizzano le esperienze dei clienti. I modelli di bot forniscono flussi di ready-to-use conversazione insieme a dati di formazione e istruzioni di dialogo, sia per le modalità vocali che per quelle di chat. Puoi accelerare la fornitura di soluzioni bot ottimizzando al contempo le risorse, in modo da poterti concentrare sulle relazioni con i clienti.
Puoi creare bot predefiniti in base al tuo caso d'uso aziendale. Puoi utilizzare la CloudFormation console per selezionare le opzioni predefinite per i servizi correlati, come Amazon S3, Amazon Connect e DynamoDB.
Attualmente, Amazon Lex V2 supporta i seguenti verticali aziendali:
+ Servizi finanziari
+ Ordini al dettaglio
+ Assicurazione auto
+ Telecomunicazioni
+ Servizi aerei
+ In futuro saranno disponibili modelli aggiuntivi.
Puoi creare un bot con il modello di soluzione aziendale fornito e personalizzarlo in base alle tue esigenze aziendali.
**Nota**
I modelli creano risorse esterne ad Amazon Lex V2 tramite CloudFormation stack. Potrebbe essere necessario modificare lo stack in altre console come Lambda e DynamoDB.
**Prerequisiti per creare e distribuire il modello di bot:**
+ Un account AWS
+ Accesso ai seguenti servizi AWS:
+ Amazon Lex V2 per creare bot
+ Lambda per le funzioni di accesso aziendale
+ DynamoDB per creare le tabelle
+ Accesso IAM per creare politiche e ruoli
+ AWS CloudFormation per eseguire lo stack
+ Accesso IAM e credenziali con chiave segreta
+ Istanza Amazon Connect (opzionale)
**Nota**
L'uso di diversi servizi AWS comporta i rispettivi costi di utilizzo per ciascun servizio.
**Per creare un bot dai modelli di Amazon Lex V2:**
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex all'indirizzo [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Seleziona **Bot templates** dal riquadro di navigazione a sinistra.
1. Seleziona il verticale aziendale che desideri utilizzare per il tuo modello di bot. NOTA: attualmente sono disponibili 5 modelli di bot. Presto ne arriveranno altri.
1. Seleziona **Crea** per il modello che desideri utilizzare. Si apre una scheda in CloudFormation cui è possibile modificare i parametri dello CloudFormation stack. Tutte le opzioni per il modello che hai scelto sono già state completate. Puoi anche saperne di più su come funziona il modello di bot selezionando **Ulteriori informazioni**.
1. Nella CloudFormation console, CloudFormation crea una configurazione predefinita per ciascuno dei valori del modello che hai scelto. Puoi anche selezionare il nome dello stack, CloudFormation i parametri, la tabella Amazon DynamoDB e (facoltativi) i parametri Amazon Connect.
1. **Nella parte inferiore della finestra, seleziona Crea stack.**
1. CloudFormationelabora la richiesta in background per diversi minuti per configurare il tuo nuovo bot. NOTA: il processo crea automaticamente risorse per una tabella DynamoDB, un flusso di contatti Amazon Connect e un'istanza Amazon Connect. Puoi tenere traccia dei progressi nella CloudFormation console e poi tornare alla console Amazon Lex V2 una volta completata la creazione CloudFormation dello stack.
1. Se creato correttamente, viene visualizzato un messaggio e puoi selezionare **Vai all'elenco dei bot** per andare alla pagina dei **bot**, dove trovi il nuovo bot pronto per essere testato e utilizzato.
**Configurazione del modello di bot**
**Funzioni Lambda**: il modello di bot crea automaticamente le funzioni Lambda necessarie per la distribuzione. Se la soluzione modello include più bot, nei CloudFormation parametri vengono elencate più funzioni Lambda. Se hai funzioni Lambda esistenti da implementare con il tuo bot, puoi inserire il nome della tua funzione Lambda personalizzata.
**Amazon DynamoDB**: il modello di bot crea automaticamente la tabella DynamoDB necessaria per caricare i dati di esempio delle policy. Puoi anche inserire il nome della tua tabella DynamoDB personalizzata. La tabella DynamoDB personalizzata deve essere formattata nello stesso modo della tabella predefinita creata dalla distribuzione del modello di bot.
**Amazon Connect**: puoi configurare la tua istanza Amazon Connect in modo che funzioni con il tuo nuovo modello di bot inserendo l' ConnectInstanceARN e un codice univoco. ContactFlowName Con Amazon Connect, puoi testare il tuo bot utilizzando un sistema IVR di end-to-end.
**Risoluzione dei problemi relativi al modello di bot**
+ Verifica di disporre delle autorizzazioni appropriate per creare il modello che stai scegliendo. Gli utenti hanno bisogno di CloudFormation: CreateStack autorizzazione insieme alle autorizzazioni per le risorse AWS elencate nel modello. Un elenco di risorse che richiedono le autorizzazioni degli utenti si trova nella parte inferiore della pagina **Crea modello**.
+ Se il modello di bot non viene creato, il banner rosso all'interno della console Amazon Lex V2 fornisce un collegamento allo CloudFormation stack responsabile della creazione del modello. All'interno della CloudFormation console, puoi visualizzare la scheda degli eventi per vedere l'errore specifico che ha causato il fallimento del modello. Dopo aver esaminato l'CloudFormationerrore, consulta [Risoluzione dei problemi CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/troubleshooting.html) per ulteriori informazioni.
+ I modelli di bot funzionano solo con i dati di esempio. È necessario compilare la tabella DynamoDB con i dati per far sì che i modelli funzionino con i dati personalizzati.
# Creazione di bot Amazon Lex V2 utilizzando Automated Chatbot Designer
L'Automated Chatbot Designer ti aiuta a progettare bot a partire da trascrizioni di conversazioni esistenti. Analizza le trascrizioni e suggerisce un progetto iniziale con intenti e tipi di slot. Puoi iterare sulla progettazione del bot, aggiungere istruzioni, creare, testare e implementare il bot.
Dopo aver creato un nuovo bot o aggiunto una lingua al bot utilizzando la console o l'API Amazon Lex V2, puoi caricare trascrizioni di conversazioni tra due parti. Il progettista automatico di chatbot analizza le trascrizioni e determina gli intenti e i tipi di slot per il bot. Inoltre, elenca le conversazioni che hanno influenzato la creazione di un particolare intento o tipo di slot per la tua recensione.
Utilizzi la console Amazon Lex V2 o l'API per analizzare le trascrizioni delle conversazioni e suggerire intenti e tipi di slot per un bot.
**Nota**
Puoi utilizzare solo trascrizioni in lingua inglese (Stati Uniti).
Puoi rivedere gli intenti e i tipi di slot suggeriti dopo che il progettista del chatbot ha terminato l'analisi. Dopo aver aggiunto un intento o un tipo di slot suggerito, puoi modificarlo o eliminarlo dal design del bot utilizzando la console o l'API.
Il designer automatico di chatbot supporta i file di trascrizione delle conversazioni utilizzando lo schema Contact Lens for Amazon Connect. Se utilizzi un'applicazione di contact center diversa, devi trasformare le trascrizioni delle conversazioni nel formato utilizzato dal progettista del chatbot. Per informazioni, consulta [Formato di trascrizione di input](designing-input-format.md).
Per utilizzare il designer automatizzato di chatbot, devi consentire l'accesso al ruolo IAM che esegue il designer. Per la politica IAM specifica, consulta[Consenti agli utenti di utilizzare Automated Chatbot Designer](security_iam_id-based-policy-examples.md#security_iam-bot-designer). Per consentire ad Amazon Lex V2 di crittografare i dati di output con una AWS KMS chiave opzionale, è necessario aggiornare la chiave con la politica mostrata in. [Consenti agli utenti di utilizzare una AWS KMS chiave per crittografare e decrittografare i file](security_iam_id-based-policy-examples.md#security_iam-bot-key)
**Nota**
Se utilizzi una KMS key, devi fornire una **KMS key policy**, indipendentemente dal IAM ruolo utilizzato.
**Topics**
+ [Importazione delle trascrizioni delle conversazioni](designing-import.md)
+ [Creazione di intenti e tipi di slot](designing-create.md)
+ [Formato di trascrizione di input](designing-input-format.md)
+ [Formato di trascrizione di output](designing-output-format.md)
# Importazione delle trascrizioni delle conversazioni
L'importazione delle trascrizioni delle conversazioni è un processo in tre fasi:
1. Prepara le trascrizioni per l'importazione convertendole nel formato corretto. Se utilizzi Contact Lens per Amazon Connect, le trascrizioni sono già nel formato corretto.
1. Carica le trascrizioni in un bucket Amazon S3. Se utilizzi Contact Lens, le tue trascrizioni sono già in un bucket S3.
1. Analizza le trascrizioni utilizzando la console Amazon Lex V2 o le operazioni API. Il tempo necessario per completare la formazione dipende dal volume delle trascrizioni e dalla complessità della conversazione. In genere, vengono analizzate 500 righe di trascrizioni ogni minuto.
Ciascuno di questi passaggi è descritto nelle sezioni seguenti.
## Importazione di trascrizioni da Contact Lens per Amazon Connect
Il designer automatico di chatbot di Amazon Lex V2 è compatibile con i file di trascrizione di Contact Lens. Per utilizzare i file di trascrizione di Contact Lens, devi attivare Contact Lens e annotare la posizione dei relativi file di output.
**Per esportare le trascrizioni da Contact Lens**
1. Attiva le lenti a contatto nella tua istanza Amazon Connect. Per istruzioni, consulta [Abilitare le lenti a contatto per Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/enable-analytics.html) nella *guida per amministratori di Amazon Connect*.
1. Nota la posizione del bucket S3 che Amazon Connect utilizza per la tua istanza. Per visualizzare la posizione, apri la pagina **di archiviazione dei dati** nella console Amazon Connect. Per istruzioni, consulta [Update istance settings (Aggiornamento delle impostazioni](https://docs.aws.amazon.com/connect/latest/adminguide/update-instance-settings.html) dell'istanza) nella *guida per amministratori di Amazon Connect*.
Dopo aver attivato Contact Lens e annotato la posizione dei file di trascrizione, consulta le istruzioni [Analizza le tue trascrizioni utilizzando la console Amazon Lex V2](#import-import) per importare e analizzare le trascrizioni.
## Prepara le trascrizioni
Prepara le tue trascrizioni creando file di trascrizione.
+ Crea un file di trascrizione per conversazione che elenchi l'interazione tra le parti. Ogni interazione nella conversazione può estendersi su più righe. Puoi fornire versioni della conversazione sia redatte che non redatte.
+ Il file deve essere nel formato JSON specificato in. [Formato di trascrizione di input](designing-input-format.md)
+ È necessario fornire almeno 1.000 turni di conversazione. Per migliorare la scoperta delle tue intenzioni e dei tipi di slot, dovresti fornire circa 10.000 o più turni di conversazione. Il progettista automatico di chatbot elaborerà solo i primi 700.000 turni.
+ Non c'è limite al numero di file di trascrizione che puoi caricare, né ci sono restrizioni sulla dimensione dei file.
Se intendi filtrare le trascrizioni importate per data, i file devono trovarsi nella seguente struttura di directory:
```
--> yyyy
--> mm
--> dd
--> transcript files
```
Il file di trascrizione deve contenere la data nel formato "yyyy-mm-dd" in un punto qualsiasi del nome del file.
**Per esportare trascrizioni da altre applicazioni di contact center**
1. Usa gli strumenti dell'applicazione del tuo contact center per esportare le conversazioni. La conversazione deve contenere almeno le informazioni specificate in[Formato di trascrizione di input](designing-input-format.md).
1. Trasforma le trascrizioni prodotte dall'applicazione del contact center nel formato descritto in. [Formato di trascrizione di input](designing-input-format.md) Sei responsabile dell'esecuzione della trasformazione.
Forniamo tre script per la preparazione delle trascrizioni. Questi sono:
+ Uno script per combinare le trascrizioni di Contact Lens con i log delle conversazioni di Amazon Lex V2. Le trascrizioni di Contact Lens non includono parti delle conversazioni di Amazon Connect che interagiscono con i bot di Amazon Lex V2. Lo script richiede l'attivazione dei log delle conversazioni per Amazon Lex V2 e le autorizzazioni appropriate per interrogare i CloudWatch log delle conversazioni e i bucket Contact Lens S3.
+ Uno script per trasformare l'analisi delle chiamate di Amazon Transcribe nel formato di input Amazon Lex V2.
+ Uno script per trasformare le trascrizioni delle chat di Amazon Connect nel formato di input Amazon Lex V2.
[Puoi scaricare gli script da questo GitHub repository: -integration. https://github.com/aws-samples/ amazon-lex-bot-recommendation](https://github.com/aws-samples/amazon-lex-bot-recommendation-integration)
## Carica le tue trascrizioni in un bucket S3
Se utilizzi Contact Lens, i tuoi file di trascrizione sono già contenuti in un bucket S3. Per la posizione e i nomi dei file di trascrizione, consulta File di [output di esempio con lenti a contatto](https://docs.aws.amazon.com/connect/latest/adminguide/contact-lens-example-output-files.html) nella *guida per amministratori di Amazon Connect*.
Se utilizzi un'altra applicazione di contact center e non hai configurato un bucket S3 per i tuoi file di trascrizione, segui questa procedura. Altrimenti, se disponi di un bucket S3 esistente, dopo aver effettuato l'accesso alla console Amazon S3, segui questa procedura a partire dal passaggio 5.
**Per caricare i file in un bucket S3**
1. Accedi alla Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. Seleziona **Crea bucket**.
1. Dai un nome al bucket e scegli una regione. La regione deve essere la stessa utilizzata per Amazon Lex V2. Imposta le altre opzioni come richiesto per il tuo caso d'uso.
1. Seleziona **Crea bucket**.
1. Dall'elenco dei bucket, scegli un bucket esistente o il bucket che hai appena creato
1. Scegli **Carica**.
1. Aggiungi i file di trascrizione che desideri caricare.
1. Scegli **Carica**.
## Analizza le tue trascrizioni utilizzando la console Amazon Lex V2
Puoi utilizzare la progettazione automatica dei bot solo in una lingua vuota. Puoi aggiungere una nuova lingua a un bot esistente o creare un nuovo bot.
**Per creare una nuova lingua in un nuovo bot**
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex all'indirizzo [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Scegli **Create bot**
1. Scegli **Inizia con Automated Chatbot** Designer. Compila le informazioni per creare il tuo nuovo bot.
1. Seleziona **Next** (Successivo).
1. In **Aggiungi lingua al bot** inserisci le informazioni per la lingua.
1. Nella sezione **Posizione del file di trascrizione su S3**, scegli il bucket S3 che contiene i file di trascrizione e, se necessario, il percorso locale dei file.
1. Facoltativamente, puoi scegliere quanto segue:
+ Una AWS KMS chiave per crittografare i dati della trascrizione durante l'elaborazione. Se non si seleziona una chiave, viene utilizzata una AWS KMS chiave di servizio.
+ Per filtrare le trascrizioni in base a un intervallo di date specifico. Se scegli di filtrare le trascrizioni, devono trovarsi nella struttura di cartelle corretta. Per ulteriori informazioni, consulta [Prepara le trascrizioni](#import-prepare).
1. Seleziona **Fatto**.
Attendi che Amazon Lex V2 elabori la trascrizione. Quando l'analisi è completa, viene visualizzato un messaggio di completamento.
**Come smettere di analizzare la trascrizione**
Nel caso in cui sia necessario interrompere l'analisi delle trascrizioni caricate, è possibile interrompere un `BotRecommendation` processo in esecuzione, che ha lo stato di elaborazione. `BotRecommendationStatus` Puoi fare clic sul pulsante **Interrompi l'elaborazione** presente sul banner dopo aver inviato un lavoro dalla console o utilizzando CLI SDK per l'API. `StopBotRecommendation` Per ulteriori informazioni, consulta [StopBotRecommendation](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StopBotRecommendation.html)
Dopo aver chiamato il`StopBotRecommendation`, l'interfaccia interna `BotRecommendationStatus` viene impostata su `Stopping` e non ti viene addebitato alcun costo. Per assicurarti che il processo sia stato interrotto, puoi chiamare l'`DescribeBotRecommendation`API e verificare che lo `BotRecommendationStatus` sia`Stopped`. Di solito ci vogliono 3-4 minuti.
Non ti viene addebitato alcun costo per l'elaborazione dopo la chiamata all'`StopBotRecommendation`API.
# Creazione di intenti e tipi di slot
Dopo che il progettista del chatbot ha creato gli intenti e i tipi di slot, selezioni gli intenti e i tipi di slot da aggiungere al bot. Puoi esaminare i dettagli di ogni intento e tipo di slot per aiutarti a decidere quali consigli sono più pertinenti al tuo caso d'uso.
Puoi fare clic sul nome di un intento consigliato per visualizzare gli enunciati e gli slot di esempio suggeriti dal designer del chatbot. Se selezioni **Mostra trascrizioni associate**, puoi anche scorrere le conversazioni che hai fornito. Queste trascrizioni influiscono sulla raccomandazione del designer del chatbot in merito. Se fai clic su un enunciato di esempio, puoi rivedere la conversazione principale e il relativo turno di dialogo, che ha influito su quell'enunciato specifico.
È possibile fare clic sul nome di un tipo di slot specifico per visualizzare i valori di slot consigliati. Se selezioni **Mostra trascrizioni associate**, puoi rivedere le conversazioni che hanno influenzato questo tipo di slot, evidenziando il prompt dell'agente che viene visualizzato per il tipo di slot. Se fai clic sul valore di un tipo di slot specifico, puoi rivedere la conversazione principale e il relativo turno di dialogo che ha influenzato questo valore.
**Per rivedere e aggiungere intenti e tipi di slot**
1. Accedi alla Console di gestione AWS e apri la console Amazon Lex all'indirizzo [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/).
1. Dall'elenco dei bot, scegli il bot con cui vuoi lavorare.
1. Scegli **Visualizza le lingue.**
1. Dall'elenco delle lingue, scegli la lingua con cui lavorare.
1. Nella **struttura della conversazione**, scegli **Revisione**.
1. Nell'elenco degli intenti e dei tipi di slot, scegli quelli da aggiungere al bot. Puoi scegliere un intento o un tipo di slot per visualizzare i dettagli e le trascrizioni associate.
Gli intenti vengono ordinati in base alla fiducia che Amazon Lex V2 ha nel fatto che l'intento sia associato alle trascrizioni elaborate.
# Formato di trascrizione di input
Di seguito è riportato il formato del file di input per generare intenti e tipi di slot per il tuo bot. Il file di input deve contenere questi campi. Gli altri campi vengono ignorati.
Il formato di input è compatibile con il formato di output di Contact Lens per Amazon Connect. Se utilizzi Contact Lens, non è necessario modificare i file di trascrizione. Per ulteriori informazioni, consulta [File di output di esempio per lenti a contatto](https://docs.aws.amazon.com/connect/latest/adminguide/contact-lens-example-output-files.html). Se si utilizza un'altra applicazione di contact center, è necessario trasformare il file di trascrizione in questo formato.
```
{
"Participants": [
{
"ParticipantId": "string",
"ParticipantRole": "AGENT | CUSTOMER"
}
],
"Version": "1.1.0",
"ContentMetadata": {
"RedactionTypes": [
"PII"
],
"Output": "Raw | Redacted"
},
"CustomerMetadata": {
"ContactId": "string"
},
"Transcript": [
{
"ParticipantId": "string",
"Id": "string",
"Content": "string"
}
]
}
```
Nel file di input devono essere presenti i seguenti campi:
+ **Partecipanti** Identifica i partecipanti alla conversazione e il ruolo che svolgono.
+ **Versione** La versione del formato del file di input. Sempre «1.1.0".
+ **ContentMetadata**Indica se sono state rimosse informazioni sensibili dalla trascrizione. Imposta il `Output` campo su «Raw» se la trascrizione contiene informazioni sensibili.
+ **CustomerMetadata**Un identificatore univoco per la conversazione.
+ **Trascrizione** Il testo della conversazione tra le parti coinvolte nella conversazione. Ogni turno della conversazione è identificato da un identificatore univoco.
# Formato di trascrizione di output
Il formato di trascrizione di output è quasi lo stesso del formato di trascrizione di input. Tuttavia, include anche alcuni metadati relativi ai clienti e un campo che elenca i segmenti che hanno influito sulla definizione degli intenti e dei tipi di slot. Puoi scaricare la trascrizione dell'output dalla pagina **Review** nella console o utilizzando l'API Amazon Lex V2. Per ulteriori informazioni, consulta [Formato di trascrizione di input](designing-input-format.md).
```
{
"Participants": [
{
"ParticipantId": "string",
"ParticipantRole": "AGENT | CUSTOMER"
}
],
"Version": "1.1.0",
"ContentMetadata": {
"RedactionTypes": [
"PII"
],
"Output": "Raw | Redacted"
},
"CustomerMetadata": {
"ContactId": "string",
"FileName": "string",
"InputFormat": "Lex"
},
"InfluencingSegments": [
{
"Id": "string",
"StartTurnIndex": number,
"EndTurnIndex": number,
"Intents": [
{
"Id": "string",
"Name": "string",
"SampleUtteranceIndex": [
{
"Index": number,
"Content": "String"
}
]
}
],
"SlotTypes": [
{
"Id": "string",
"Name": "string",
"SlotValueIndex": [
{
"Index": number,
"Content": "String"
}
]
}
]
}
],
"Transcript": [
{
"ParticipantId": "string",
"Id": "string",
"Content": "string"
}
]
}
```
+ **CustomerMetadata**— Ci sono due campi aggiunti al `CustomerMetadata` campo, il nome del file di input che contiene la conversazione e il formato di input, che è sempre «Lex».
+ **InfluencingSegments**— Identifica i segmenti della conversazione che hanno influenzato il suggerimento di un intento o di un tipo di slot. L'ID dell'intento o del tipo di slot identifica quello specifico influenzato dalla conversazione.