Se você estiver usando o Amazon Lex V2, consulte o Guia do Amazon Lex V2.
Se você estiver usando o Amazon Lex V1, recomendamos atualizar seus bots para o Amazon Lex V2. Não estamos mais adicionando novos atributos à V1 e recomendamos o uso da V2 para todos os novos bots.
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.
Tópicos
Versionamento
Quando você versiona um recurso do Amazon Lex, você cria um snapshot do atributo para que possa usar o atributo 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 atributo. Você pode atualizar apenas a versão $LATEST, e até você publicar sua primeira versão, $LATEST será a única versão do atributo.
Somente a versão $LATEST de um atributo pode usar a versão $LATEST do outro atributo. 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 atributo do Amazon Lex
Quando você publica um atributo, o Amazon Lex faz uma cópia da versão e salva-a 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 ver 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 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.
nota
O Amazon Lex publica uma nova versão somente se a última versão publicada for diferente da versão $LATEST. Se você tentar publicar a versão $LATEST sem modificá-la, o Amazon Lex não criará nem publicará uma nova versão.
Atualização de um atributo 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 atributo ou uma versão do Amazon Lex.
O Amazon Lex oferece suporte à exclusão de um atributo 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.
nota
Embora você possa testar a versão $LATEST de um bot no console, recomendamos que, ao integrar um bot ao aplicativo do cliente, primeiro você publique uma versão e crie um alias que aponta para essa versão. Use o alias na aplicação de seus clientes pelos motivos explicados nesta seção. Quando você atualiza um alias, o Amazon Lex aguardará até que o tempo limite de sessão de todas as sessões atuais expire para começar a usar a nova versão. Para obter mais informações sobre tempo limite da sessão, consulte Definição do tempo limite da sessão
