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 Amazon Lex V1 o alle risorse Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.
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à.
Funzione Versioni multiple e alias
Amazon Lex supporta la pubblicazione di versioni di bot, intent e tipi di slot in modo da poter controllare l'implementazione utilizzata dalle applicazioni client. Una versione è una snapshot numerata del lavoro dell'utente che è possibile pubblicare per l'utilizzo in diverse parti del flusso di lavoro, quali lo sviluppo, la distribuzione beta e la produzione.
I bot Amazon Lex supportano anche gli alias. Un alias è un puntatore a una specifica versione di un bot Con un alias è possibile aggiornare facilmente la versione utilizzata dalle applicazioni client. Ad esempio, si potrebbe associare un alias alla versione 1 di un bot. Quando si è pronti per aggiornare il bot, è possibile pubblicare la versione 2 del bot e modificare l'alias in modo che punti alla nuova versione. Poiché le applicazioni utilizzano l'alias anziché una versione specifica, tutti i client otterranno la nuova funzionalità senza necessità di un aggiornamento.
Argomenti
Controllo delle versioni
Quando crei una versione di una risorsa Amazon Lex, crei uno snapshot della risorsa in modo da poter utilizzare la risorsa così com'era al momento della creazione della versione. Una volta creata una versione, mentre si continua a lavorare sull'applicazione questa versione rimarrà invariata.
La versione $LATEST
Quando crei un bot, un intento o un tipo di slot Amazon Lex, esiste solo una versione, la $LATEST
versione.
La versione $LATEST
è la copia di lavoro della risorsa. Fino a quando non si pubblica la prima versione della risorsa, è possibile aggiornare solo la versione $LATEST
. La versione $LATEST
è l'unica versione della risorsa disponibile.
Solo la versione $LATEST
di una risorsa può utilizzare la versione $LATEST
di un'altra risorsa. Ad esempio, la versione $LATEST
di un bot può utilizzare la versione $LATEST
di un intento e la versione $LATEST
di un intento può utilizzare la versione $LATEST
di un tipo di slot.
La $LATEST
versione del bot deve essere utilizzata solo per test manuali. Amazon Lex limita il numero di richieste di runtime che puoi effettuare alla $LATEST
versione del bot.
Pubblicazione di una versione di risorse Amazon Lex
Quando pubblichi una risorsa, Amazon Lex crea una copia della $LATEST
versione e la salva come versione numerata. La versione pubblicata non può essere modificata.
Puoi creare e pubblicare versioni utilizzando la console Amazon Lex o l'CreateBotVersionoperazione. Per vedere un esempio, consulta Esercizio 3. Pubblicazione di una versione e creazione di un alias.
Quando si modifica la versione $LATEST
di una risorsa, è possibile pubblicare la nuova versione per rendere disponibili le modifiche per le applicazioni client. Ogni volta che pubblichi una versione, Amazon Lex copia la $LATEST
versione per creare la nuova versione e incrementa il numero di versione di 1. I numeri di versione non vengono mai riutilizzati. Ad esempio, se rimuovi una risorsa numerata versione 10 e poi la ricrei, il numero di versione successivo assegnato da Amazon Lex è la versione 11.
Prima di poter pubblicare un bot, è necessario farlo puntare a una versione numerata di qualsiasi evento utilizzato. Se si tenta di pubblicare una nuova versione di un bot che utilizza la versione $LATEST di un intento, Amazon Lex restituisce un'eccezione di richiesta non valida HTTP 400. Prima di poter pubblicare una versione numerata dell'intento, è necessario far puntare l'intento a una versione numerata di qualsiasi tipo di slot utilizzato. In caso contrario, verrà restituita un'eccezione di richiesta non valida 400 HTTP.
Nota
Amazon Lex pubblica una nuova versione solo se l'ultima versione pubblicata è diversa dalla $LATEST
versione. Se tenti di pubblicare la $LATEST
versione senza modificarla, Amazon Lex non crea o pubblica una nuova versione.
Aggiornamento di una risorsa Amazon Lex
Puoi aggiornare solo la $LATEST
versione di un tipo di bot, intent o slot Amazon Lex. Non è possibile modificare le versioni pubblicate. È possibile pubblicare una nuova versione in qualsiasi momento dopo aver aggiornato una risorsa tramite la console o le operazioni CreateBotVersion, CreateIntentVersion o CreateSlotTypeVersion.
Eliminazione di una risorsa o di una versione di Amazon Lex
Amazon Lex supporta l'eliminazione di una risorsa o di una versione utilizzando la console o una delle operazioni API:
Alias
Un alias è un puntatore a una versione specifica di un bot Amazon Lex. È possibile utilizzare un alias per consentire alle applicazioni client di utilizzare una versione specifica del bot senza richiedere all'applicazione di tenere traccia di quale versione sia.
L'esempio seguente mostra due versioni di un bot Amazon Lex, la versione 1 e la versione 2. A ciascuna di queste versioni di bot è associato un alias: rispettivamente BETA e PROD. Le applicazioni client utilizzano l'alias PROD per accedere al bot.
Quando si crea una seconda versione del bot, è possibile aggiornare l'alias utilizzando la console o l'operazione PutBot per fare in modo che punti alla nuova versione del bot. Se si modifica l'alias, tutte le applicazioni client utilizzeranno la nuova versione. Se si verifica un problema relativo alla nuova versione, è possibile tornare alla versione precedente semplicemente modificando l'alias in modo che punti a tale versione.
Nota
Sebbene sia possibile effettuare un test della versione $LATEST
di un bot nella console, quando si integra un bot con l'applicazione client si consiglia di pubblicare prima una versione e creare un alias che punta a tale versione. Utilizzare l'alias nell'applicazione client per i motivi illustrati in questa sezione. Quando aggiorni un alias, Amazon Lex aspetterà la scadenza del timeout di tutte le sessioni correnti prima di iniziare a utilizzare la nuova versione. Per ulteriori informazioni sul timeout di sessione, consultare Impostazione del timeout di sessione.