Aviso de fim do suporte: em 15 de setembro de 2025, o suporte para o Amazon Lex V1 AWS será interrompido. Depois de 15 de setembro de 2025, você não poderá mais acessar o console do Amazon Lex V1 ou os recursos do Amazon Lex V1. Se você estiver usando o Amazon Lex V2, consulte o guia do Amazon Lex V2 em vez disso.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Versionamento e aliases

O Amazon Lex oferece suporte a versões de publicação de bots, intenções e tipos de slot para que você possa controlar a implementação usada por seus aplicativos cliente. Uma versão é um snapshot numerado de seu trabalho que você pode publicar para uso em diferentes partes de seu fluxo de trabalho, como desenvolvimento, implementação beta e produção.

Os bots do Amazon Lex também oferecem suporte a aliases. Um alias é um ponteiro para uma versão específica de um bot. Com um alias, você pode atualizar com facilidade a versão que seus aplicativos cliente estão usando. Por exemplo, você pode apontar um alias para a versão 1 do seu bot. Quando estiver pronto para atualizar o bot, você publica a versão 2 e altera o alias para apontar para a nova versão. Como suas aplicações usam o alias ao invés de uma versão específica, todos os seus clientes obtêm a nova funcionalidade sem a necessidade de atualizações.

Versionamento

Quando você versiona um recurso do Amazon Lex, você cria um snapshot do recurso para que possa usar o recurso da forma como existia quando a versão foi criada. Após criar uma versão, ela permanecerá a mesma enquanto você continuar trabalhando no seu aplicativo.

A versão $LATEST

Quando você cria um bot, intenção ou tipo de slot do Amazon Lex, há apenas uma versão, a versão $LATEST.

$LATEST é a cópia de trabalho do seu recurso. Você pode atualizar apenas a versão $LATEST, e até você publicar sua primeira versão, $LATEST será a única versão do recurso.

Somente a versão $LATEST de um recurso pode usar a versão $LATEST do outro recurso. Por exemplo, a versão $LATEST de um bot pode usar a versão $LATEST de uma intenção, e a versão $LATEST de uma intenção pode usar a versão $LATEST de um tipo de slot.

A versão $LATEST do bot deve ser usada somente para testes manuais. O Amazon Lex limita o número de solicitações de runtime que você pode fazer para a versão $LATEST do bot.

Publicação de uma versão de recurso do Amazon Lex

Quando você publica um recurso, o Amazon Lex faz uma cópia da versão $LATEST e salva como uma versão numerada. A versão publicada não pode ser alterada.

Crie e publique as versões usando o console do Amazon Lex ou a operação CreateBotVersion. Para obter um exemplo, consulte Exercício 3: publique uma versão e crie um alias.

Quando você modifica a versão $LATEST de um recurso, pode publicar a nova versão para disponibilizar as alterações para os aplicativos de seus clientes. Toda vez que você publica uma versão, o Amazon Lex copia a versão $LATEST para criar a nova versão e incrementa 1 no número da versão. Os números de versão nunca são reutilizados. Por exemplo, se você remover a versão 10 numerada de um recurso e, em seguida, recriá-la, o próximo número de versão atribuído pelo Amazon Lex será a versão 11.

Para publicar um bot, você deve apontá-lo para uma versão numerada de qualquer intenção que ele use. Se você tentar publicar uma nova versão de um bot que usa a versão $LATEST versão de uma intenção, O Amazon Lex retorna uma exceção HTTP 400: solicitação inválida. Para publicar uma versão numerada da intenção, você deve apontar a intenção de uma versão numerada de qualquer tipo de slot que ele use. Caso contrário, você receberá uma exceção HTTP 400: solicitação inválida.

Atualização de um recurso do Amazon Lex

Você pode atualizar apenas a versão $LATEST de um bot, uma intenção ou um tipo de slot do Amazon Lex. As versões publicadas não podem ser alteradas. Você pode publicar uma nova versão a qualquer momento após atualizar um recurso no console ou com as operações CreateBotVersion, CreateIntentVersion ou CreateSlotTypeVersion.

Exclusão de um recurso ou uma versão do Amazon Lex.

O Amazon Lex oferece suporte à exclusão de um recurso ou versão usando o console ou uma das operações de API:

Aliases

Um alias é um indicador para uma versão específica de um bot do Amazon Lex. Use um alias para permitir que os aplicativos de clientes usem uma versão específica do bot sem exigir que o aplicativo acompanhe qual é a versão.

O exemplo a seguir mostra duas versões de um bot do Amazon Lex, versão 1 e versão 2. Cada uma dessas versões de bot tem um alias associado, BETA e PROD, respectivamente. As aplicações dos clientes usam o alias PROD para acessar o bot.

Ao criar uma segunda versão do bot, você pode atualizar o alias para apontar para a nova versão do bot usando o console ou a operação PutBot. Quando você altera o alias, todas as aplicações de seus clientes usam a nova versão. Se houver um problema com a nova versão, você poderá reverter para a versão anterior, simplesmente alterando o alias para apontar para essa versão.