Si vous utilisez Amazon Lex V2, consultez plutôt le guide Amazon Lex V2.
Si vous utilisez Amazon Lex V1, nous vous recommandons de mettre à niveau vos robots vers Amazon Lex V2. Nous n'ajoutons plus de nouvelles fonctionnalités à la V1 et recommandons vivement d'utiliser la V2 pour tous les nouveaux robots.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Versions et alias
Amazon Lex prend en charge la publication de versions de bots, d'intentions et de types d'emplacements afin que vous puissiez contrôler l'implémentation utilisée par vos applications clientes. Une version est un instantané numéroté de votre tâche que vous pouvez publier pour une utilisation dans différentes parties de votre flux de travail, par exemple, pour le développement, le déploiement bêta et la production.
Les robots Amazon Lex prennent également en charge les alias. Un alias est un pointeur vers une version spécifique d'un bot. Avec un alias, vous pouvez facilement mettre à jour la version que vos applications clientes utilisent. Par exemple, vous pouvez faire pointer un alias vers la version 1 de votre bot. Lorsque vous êtes prêt à mettre à jour le bot, vous publiez la version 2 et vous modifiez l'alias pour qu'il pointe vers la nouvelle version. Comme vos applications utilisent l'alias au lieu d'une version spécifique, tous vos clients obtiennent les nouvelles fonctionnalités sans avoir besoin d'être mis à jour.
Rubriques
Gestion des versions
Lorsque vous créez une version d'une ressource Amazon Lex, vous créez un instantané de la ressource afin de pouvoir utiliser la ressource telle qu'elle existait au moment de la création de la version. Une fois que vous créez une version, celle-ci il reste la même pendant que vous continuez à travailler sur votre application.
Version $LATEST
Lorsque vous créez un bot, une intention ou un type de slot Amazon Lex, il n'existe qu'une seule version, la $LATEST
version.
$LATEST
est la copie de travail de votre ressource. Vous pouvez mettre à jour uniquement la version $LATEST
et, tant que vous n'aurez pas publié votre première version, $LATEST
est la seule version de la ressource que vous avez.
Seule la version $LATEST
d'une ressource peut utiliser la version $LATEST
d'une autre ressource. Par exemple, la version $LATEST
d'un bot peut utiliser la version $LATEST
d'une intention, et la version $LATEST
d'une intention peut utiliser la version $LATEST
d'un type d'option.
La $LATEST
version de votre bot ne doit être utilisée que pour des tests manuels. Amazon Lex limite le nombre de demandes d'exécution que vous pouvez effectuer à la $LATEST
version du bot.
Publication d'une version d'Amazon Lex Resource
Lorsque vous publiez une ressource, Amazon Lex en fait une copie et l'$LATEST
enregistre sous forme de version numérotée. La version publiée ne peut pas être modifiée.
Vous créez et publiez des versions à l'aide de la console Amazon Lex ou de l'CreateBotVersionopération. Pour obtenir un exemple, consultez Exercice 3 : Publication d'une version et création d'un alias.
Lorsque vous modifiez la version $LATEST
d'une ressource, vous publiez la nouvelle version pour mettre les modifications à disposition des applications clientes. Chaque fois que vous publiez une version, Amazon Lex copie la $LATEST
version pour créer la nouvelle version et augmente le numéro de version de 1. Les numéros de version ne sont jamais réutilisés. Par exemple, si vous supprimez une ressource numérotée version 10 puis que vous la recréez, le numéro de version suivant attribué par Amazon Lex est la version 11.
Avant de pouvoir publier un bot, vous devez renvoyer vers la version numérotée d'une intention qu'il utilise. Si vous essayez de publier une nouvelle version d'un bot qui utilise la version $LATEST d'une intention, Amazon Lex renvoie une exception de demande incorrecte HTTP 400. Avant de pouvoir publier une version numérotée de l'intention, vous devez renvoyer cette dernière vers la version numérotée d'un type d'option qu'elle utilise. Dans le cas contraire, vous obtiendrez une exception de demande incorrecte HTTP 400.
Note
Amazon Lex publie une nouvelle version uniquement si la dernière version publiée est différente de la $LATEST
version. Si vous essayez de publier la $LATEST
version sans la modifier, Amazon Lex ne crée ni ne publie de nouvelle version.
Mettre à jour une ressource Amazon Lex
Vous ne pouvez mettre à jour que la $LATEST
version d'un bot, d'une intention ou d'un type de slot Amazon Lex. Les versions publiées ne peuvent pas être modifiées. Vous pouvez publier une nouvelle version à tout moment après avoir mis à jour une ressource dans la console ou avec les opérations CreateBotVersion, CreateIntentVersion ou CreateSlotTypeVersion.
Supprimer une ressource ou une version d'Amazon Lex
Amazon Lex prend en charge la suppression d'une ressource ou d'une version à l'aide de la console ou de l'une des opérations de l'API :
Alias
Un alias est un pointeur vers une version spécifique d'un bot Amazon Lex. Utilisez un alias pour permettre aux applications clientes d'utiliser une version du bot sans que les applications aient besoin de savoir de quelle version spécifique il s'agit.
L'exemple suivant montre deux versions d'un bot Amazon Lex, la version 1 et la version 2. Chacune de ces versions de bot est associée à un alias, BETA et PROD, respectivement. Les applications clientes utilisent l'alias PROD pour accéder au bot.
Lorsque vous créez une deuxième version du bot, vous pouvez mettre à jour l'alias pour qu'il renvoie vers cette nouvelle version à l'aide de la console ou de l'opération PutBot. Lorsque vous modifiez l'alias, toutes vos applications clientes utilisent la nouvelle version. S'il existe un problème lié à la nouvelle version, vous pouvez restaurer la version précédente en changeant simplement l'alias pour qu'il pointe vers cette version.
Note
Même si vous pouvez tester la version $LATEST
d'un bot dans la console, nous vous recommandons, lorsque vous intégrez un bot à une application cliente, de publier d'abord une version, puis de créer un alias qui renvoie vers cette version. Utilisez l'alias dans votre application cliente pour les raisons expliquées dans cette section. Lorsque vous mettez à jour un alias, Amazon Lex attend que le délai d'expiration de toutes les sessions en cours expire avant de commencer à utiliser la nouvelle version. Pour plus d'informations sur le délai d'expiration des sessions, consultez Définition du délai d'expiration d'une session.