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à.
# Importazione ed esportazione di bot, intenti e tipi di slot di Amazon Lex
Puoi importare o esportare un bot, un intento o un tipo di slot. Ad esempio, se vuoi condividere un bot con un collega di un altro account AWS, puoi esportarlo e poi inviarlo. Se desideri aggiungere più enunciazioni a un bot, puoi esportarlo, aggiungere le enunciazioni, quindi importarlo di nuovo nel tuo account.
Puoi *esportare* bot, intenti e tipi di slot in Amazon Lex (per condividerli o modificarli) o in un formato di abilità Alexa. Puoi *importare* solo in formato Amazon Lex.
Quando esporti una risorsa, devi esportarla in un formato compatibile con il servizio verso cui stai esportando, Amazon Lex o Alexa Skills Kit. Se esporti un bot nel formato Amazon Lex, puoi reimportarlo nel tuo account, o un utente Amazon Lex in un altro account può importarlo nel proprio account. Puoi anche esportare un bot in un formato compatibile con una competenza di Alexa. Quindi puoi importare il bot utilizzando il kit di competenze di Alexa per rendere il tuo bot disponibile con Alexa. Per ulteriori informazioni, consulta [Esportazione su una competenza di Alexa](export-to-alexa.md).
Quando esporti un bot, un intento o un tipo di slot, le risorse vengono scritte su un file JSON. Per esportare un bot, un intento o un tipo di slot, puoi utilizzare la console Amazon Lex o l'[GetExport](API_GetExport.md)operazione. Importazione di un bot, un intento o un tipo di slot tramite [StartImport](API_StartImport.md).
**Topics**
+ [
# Esportazione e importazione in formato Amazon Lex
](import-export-lex.md)
+ [
# Esportazione su una competenza di Alexa
](export-to-alexa.md)
# Esportazione e importazione in formato Amazon Lex
Per esportare bot, intenti e tipi di slot da Amazon Lex con l'intenzione di reimportarli in Amazon Lex, devi creare un file JSON in formato Amazon Lex. Puoi modificare le tue risorse in questo file e importarlo nuovamente in Amazon Lex. Ad esempio, puoi aggiungere enunciazioni a un intento, quindi importare l'intento modificato nel tuo account. Puoi inoltre utilizzare il formato JSON per condividere una risorsa. Ad esempio, puoi esportare un bot da una regione AWS e poi importarlo in un'altra regione. In alternativa, puoi inviare il file JSON a un collega per condividere un bot.
**Topics**
+ [
# Esportazione in formato Amazon Lex
](export-to-lex.md)
+ [
# Importazione in formato Amazon Lex
](import-from-lex.md)
+ [
# Formato JSON per esportazione e importazione
](import-export-format.md)
# Esportazione in formato Amazon Lex
Esporta bot, intenti e tipi di slot Amazon Lex in un formato che puoi importare in un AWS account. Puoi esportare le seguenti risorse:
+ Un bot, inclusi tutti gli intenti e i tipi di slot personalizzati utilizzati dal bot
+ Un intento, inclusi tutti i tipi di slot personalizzati utilizzati dall'intento
+ Un tipo di slot personalizzato, inclusi tutti i valori per il tipo di slot
Puoi esportare solo una versione numerata di una risorsa. Non è possibile esportare una versione `$LATEST` di una risorsa.
L'esportazione è un processo asincrono. Una volta completata l'esportazione, ottieni un URL predefinito Amazon S3. L'URL fornisce il percorso di un archivio .zip che contiene la risorsa esportata in formato JSON.
Per esportare bot, intenti o tipi di slot personalizzati, puoi utilizzare la console o l'operazione [GetExport](API_GetExport.md).
Il processo di esportazione di un bot, di un intento o di un tipo di slot è lo stesso. Nelle seguenti procedure, sostituisci l'intento o il tipo di slot al bot.
## Esportazione di un bot
**Per esportare un 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 **Bots** (Bot), quindi seleziona il bot da esportare.
1. Nel menu **Actions** (Operazioni), scegli **Export** (Esporta).
1. Nella finestra di dialogo **Export Bot** (Esporta Bot), scegli la versione del bot da esportare. Per **Platform** (Piattaforma), seleziona **Amazon Lex**.
1. Scegli **Export** (Esporta).
1. Scarica e salva l'archivio .zip.
Amazon Lex esporta il bot in un file JSON contenuto nell'archivio.zip. Per aggiornare il bot, modifica il testo JSON, quindi importalo nuovamente in Amazon Lex.
**Approfondimenti**
[Importazione in formato Amazon Lex](import-from-lex.md)
# Importazione in formato Amazon Lex
Dopo aver esportato una risorsa in un file JSON nel formato Amazon Lex, puoi importare il file JSON contenente la risorsa in uno o più account. AWS Ad esempio, puoi esportare un bot e poi importarlo in un'altra regione AWS. In alternativa, puoi inviare il bot a un collega in modo che possa importarlo nel proprio account.
Quando importi un bot, un intento o un tipo di slot, devi decidere se desideri sovrascrivere la versione `$LATEST` di una risorsa, ad esempio un intento o un tipo di slot, durante l'importazione, oppure se desideri che l'importazione non vada a buon fine, per mantenere la risorsa presente nel tuo account. Ad esempio, se stai caricando una versione modificata di una risorsa sul tuo account, puoi scegliere di sovrascrivere la versione `$LATEST`. Se stai caricando una risorsa ricevuta da un collega, puoi scegliere di far fallire l'importazione se ci sono conflitti di risorse, in modo che le tue risorse non vengano sostituite.
Durante l'importazione di una risorsa, si applicano le autorizzazioni assegnate all'utente che effettua la richiesta di importazione. L'utente deve avere le autorizzazioni per tutte le risorse nell'account su cui avrà effetto l'importazione. L'utente deve anche disporre delle autorizzazioni per le operazioni [GetBot](API_GetBot.md) [PutBot](API_PutBot.md), [GetIntent](API_GetIntent.md), [PutIntent](API_PutIntent.md), [GetSlotType](API_GetSlotType.md), [PutSlotType](API_PutSlotType.md). Per ulteriori informazioni sulle autorizzazioni, consultare [Come funziona Amazon Lex con IAM](security_iam_service-with-iam.md).
L'importazione consente di registrare gli errori che si verificano durante l'elaborazione. Alcuni errori sono riportati prima che l'importazione abbia inizio, altri vengono riportati durante il processo di importazione. Ad esempio, se l'account che importa un intento non è autorizzato a chiamare una funzione Lambda utilizzata dall'intento, l'importazione fallisce prima che vengano apportate modifiche ai tipi o agli intenti di slot. Se l'importazione ha esito negativo durante il processo, viene modificata la versione `$LATEST` di qualsiasi intento o tipo di slot importati prima del fallimento del processo. Non è possibile eseguire il rollback delle modifiche apportate alla versione `$LATEST`.
Quando importi una risorsa, tutte le risorse dipendenti vengono importate nella versione `$LATEST` della risorsa e ricevono poi una versione numerata. Ad esempio, se un bot impiega un intento, all'intento viene assegnata una versione numerata. Se un intento utilizza un tipo di slot personalizzato, al tipo di slot viene assegnata una versione numerata.
Una risorsa viene importata solo una volta. Ad esempio, se il bot contiene un intento `OrderPizza` e un intento `OrderDrink` ed entrambi si basano sul tipo di slot personalizzato `Size`, il tipo di slot `Size` viene importato una volta e utilizzato per entrambi gli intenti.
**Nota**
Se avete esportato il bot con il `enableModelImprovements` parametro impostato su`false`, dovete aprire il file.zip contenente la definizione del bot e modificare il parametro impostandolo nelle `enableModelImprovements` seguenti regioni: `true`
Asia Pacifico (Singapore) (ap-southeast-1)
Asia Pacifico (Tokyo) (ap-northeast-1)
UE (Francoforte): eu-central-1
UE (Londra): eu-west-2
Il processo di importazione di un bot, di un intento o di un tipo di slot personalizzato è lo stesso. Nelle seguenti procedure, sostituisci l'intento o il tipo di slot, secondo quanto richiesto.
## Importazione di un bot
**Per importare un 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 **Bots** (Bot), quindi seleziona il bot da importare. Per importare un nuovo bot, salta questa fase.
1. In **Actions** (Operazioni), seleziona **Import** (Importa).
1. Per **Import Bot** (Importa bot), scegli l'archivio .zip che contiene il file JSON in cui si trova il bot da importare. Se desideri visualizzare i conflitti di unione prima che avvenga l'unione, scegli **Notify me of merge conflicts** (Inviami una notifica per i conflitti di unione). Se disattivi la verifica dei conflitti, la versione `$LATEST` di tutte le risorse utilizzate dal bot viene sovrascritta.
1. Scegli **Importa**. Se hai scelto di ricevere una notifica in caso di conflitti di unione, al loro verificarsi, apparirà una finestra di dialogo che li elenca. Per sovrascrivere la versione `$LATEST` di tutte le risorse in conflitto, scegli **Sovrascrivi e continua**. Per interrompere l'importazione, scegli **Cancel** (Annulla).
Ora puoi testare il bot nel tuo account.
# Formato JSON per esportazione e importazione
Gli esempi seguenti mostrano la struttura JSON per l'esportazione e l'importazione di tipi di slot, intenti e bot in formato Amazon Lex.
## Struttura dei tipi di slot
La seguente è la struttura JSON per i tipi di slot personalizzati. Utilizza questa struttura per importare o esportare i tipi di slot e quando esporti gli intenti che dipendono da tipi di slot personalizzati.
```
{
"metadata": {
"schemaVersion": "1.0",
"importType": "LEX",
"importFormat": "JSON"
},
"resource": {
"name": "slot type name",
"version": "version number",
"enumerationValues": [
{
"value": "enumeration value",
"synonyms": []
},
{
"value": "enumeration value",
"synonyms": []
}
],
"valueSelectionStrategy": "ORIGINAL_VALUE or TOP_RESOLUTION"
}
}
```
## Struttura dell'intento
La seguente è la struttura JSON per gli intenti. Utilizza questa struttura per importare o esportare intenti e bot che dipendono da un intento.
## Struttura bot
La seguente è la struttura JSON per i bot. Utilizza questa struttura durante l'importazione o l'esportazione di bot.
# Esportazione su una competenza di Alexa
Puoi esportare lo schema del bot in un formato compatibile con una competenza di Alexa. Dopo aver esportato il bot su un file JSON, puoi caricarlo su Alexa utilizzando Alexa Skill Builder.
**Per esportare un bot e i relativi schemi (modello di interazione)**
1. Accedi a 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. Scegliere il bot da esportare.
1. In **Actions** (Operazioni), seleziona **Export** (Esporta).
1. Scegliere la versione del bot che si desidera esportare. Per il formato, seleziona **Alexa Skills Kit** (Kit competenze Alexa), quindi scegli **Export** (Esporta).
1. Se viene visualizzata una finestra di dialogo di download, scegliere una posizione in cui salvare il file, quindi **Save (Salva)**.
Il file scaricato è un archivio .zip contenente un file con il nome del bot esportato. Contiene le informazioni necessarie per importare il bot come competenza Alexa.
**Nota**
Amazon Lex e Alexa Skills Kit si differenziano nei seguenti modi:
Gli attributi di sessione, indicati da parentesi quadre ([]), non sono supportati da Alexa Skills Kit. Devi aggiornare i messaggi di richiesta che utilizzano gli attributi di sessione.
I segni di interpunzione non sono supportati da Alexa Skills Kit. Devi aggiornare le enunciazioni che utilizzano l'interpunzione.
**Per caricare il bot su una competenza Alexa**
1. Accedi al portale per sviluppatori all'indirizzo [https://developer.amazon.com/](https://developer.amazon.com/edw/home.html#/).
1. Nella pagina **Alexa Skills (Competenze di Alexa)**, scegliere **Create Skill (Crea competenza)**.
1. Nella pagina **Create a new skill (Crea una nuova competenza)**, immettere un nome di competenza e il linguaggio predefinito per essa. Accertarsi che per il modello di competenza sia selezionato **Custom (Personalizzato)**, quindi scegliere **Create skill (Crea competenza)**.
1. Accertarsi che sia selezionato **Start from scratch (Inizia da zero)**, quindi scegliere **Choose (Scegli)**.
1. Nel menu a sinistra, scegliere **JSON Editor (Editor JSON)** . Trascina il file JSON che hai esportato da Amazon Lex nell'editor JSON.
1. Scegliere **Save Model (Salva modello)** per salvare il modello di interazione.
Una volta caricato lo schema nella competenza Alexa, puoi apportare tutte le modifiche necessarie per eseguire la competenza con Alexa. Per ulteriori informazioni su come creare una competenza Alexa, consulta la sezione sull'[utilizzo di Skill Builder (beta)](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/ask-define-the-vui-with-gui) in *Alexa Skills Kit*.