Versioning und Aliasnamen - Amazon Lex V1

Wenn Sie Amazon Lex V2 verwenden, lesen Sie stattdessen das Amazon Lex V2-Handbuch.

 

Wenn Sie Amazon Lex V1 verwenden, empfehlen wir, Ihre Bots auf Amazon Lex V2 zu aktualisieren. Wir fügen V1 keine neuen Funktionen mehr hinzu und empfehlen dringend, V2 für alle neuen Bots zu verwenden.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Versioning und Aliasnamen

Amazon Lex unterstützt das Veröffentlichen von Versionen von Bots, Absichten und Slot-Typen, sodass Sie die Implementierung kontrollieren können, die Ihre Clientanwendungen verwenden. Eine Version ist ein nummerierter Snapshot Ihrer Arbeit, den Sie zur Verwendung in verschiedenen Teilen Ihres Workflows, zum Beispiel Entwicklung, Beta-Bereitstellung und Produktion, veröffentlichen können.

Amazon LEX Bots unterstützen auch Aliase. Ein Alias ist ein Zeiger auf eine bestimmte Bot-Version. Mit einem Alias können Sie einfach die Version aktualisieren, die Ihre Clientanwendungen verwenden. Beispielsweise können Sie einen Alias auf Version 1 Ihres Bot zeigen lassen. Wenn Sie bereit sind, den Bot zu aktualisieren, veröffentlichen Sie Version 2 und ändern den Alias so, dass er auf die neue Version zeigt. Da Ihre Anwendungen den Alias anstelle einer bestimmten Version verwenden, erhalten alle Ihre Clients die neuen Funktionen, ohne dafür aktualisiert werden zu müssen.

Versioning

Wenn Sie eine Amazon Lex LEX-Ressource versionieren, erstellen Sie einen Snapshot der Ressource, sodass Sie die Ressource in der Form verwenden können, die sie beim Erstellen der Version hatte. Nachdem Sie eine Version erstellt haben, bleibt Sie, während Sie weiter an Ihrer Anwendung arbeiten, unverändert.

Die $LATEST Version

Wenn Sie einen Amazon LEX -Bot, eine Absicht oder einen Slot-Typ erstellen, gibt es nur eine Version, die$LATEST-Version

The $LATEST version of a bot.

$LATEST ist die Arbeitsversion Ihrer Ressource. Sie können nur die $LATEST Version aktualisieren. Bis Sie Ihre erste Version veröffentlicht haben, ist die $LATEST Version die einzige Version der Ressource, die Sie haben.

Nur die $LATEST Version einer Ressource kann die $LATEST Version einer anderen Ressource nutzen. Beispielsweise kann die $LATEST Version eines Bots die $LATEST Version einer Absicht nutzen und die $LATEST Version einer Absicht kann die $LATEST Version eines Slot-Typs verwenden.

Die$LATESTDie Version Ihres Bots sollte nur für manuelle Tests verwendet werden. Amazon Lex begrenzt die Anzahl der Laufzeitanforderungen, die Sie an die$LATESTVersion des Bots.

Veröffentlichen einer Amazon Lex Lex-Ressourcenversion

Wenn Sie eine Ressource veröffentlichen, erstellt Amazon Lex eine Kopie der$LATEST-Version und speichert es als nummerierte Version. Die veröffentlichte Version kann nicht geändert werden.

Publishing a new version of the bot.

Sie erstellen und veröffentlichen Versionen mithilfe der Amazon Lex LEX-Konsole oder derCreateBotVersionverwenden. Ein Beispiel finden Sie unter Übung 3: Eine Version veröffentlichen und einen Aliasnamen generieren.

Wenn Sie die $LATEST Version einer Ressource ändern, können Sie die neue Version veröffentlichen, um die Änderungen für Ihre Clientanwendungen bereitzustellen. Jedes Mal, wenn Sie eine Version veröffentlichen, kopiert Amazon Lex$LATEST-Version, um die neue Version zu erstellen, erhöht die Versionsnummer um 1. Versionsnummern werden niemals wiederverwendet. Wenn Sie beispielsweise eine Ressource mit der Versionsnummer 10 entfernen und dann neu erstellen, ist die Versionsnummer, die Amazon Lex zuweist, die Nummer 11.

Bevor Sie einen Bot veröffentlichen können, müssen Sie diesen auf eine nummerierte Version einer Absicht verweisen, die er verwendet. Wenn Sie versuchen, eine neue Version eines Bots zu veröffentlichen, der die $LATEST-Version einer Absicht verwendet, gibt Amazon Lex einen HTTP-400-Fehler (Bad Request) zurück. Bevor Sie einen nummerierte Version einer Absicht veröffentlichen können, müssen Sie die Absicht auf eine nummerierte Version eines von ihr verwendeten Slot-Typs verweisen. Andernfalls erhalten Sie einen HTTP-400-Fehler (Bad Request).

Publishing a new version of $LATEST.

Anmerkung

Amazon Lex veröffentlicht eine neue Version nur, wenn sich die zuletzt veröffentlichte Version von der$LATEST-Version Wenn Sie versuchen, das$LATEST-Version, ohne diese zu ändern, erstellt oder veröffentlicht Amazon Lex keine neue Version.

Aktualisieren einer Amazon Lex Lex-Ressource

Sie können nur die$LATEST-Version eines Amazon LEX Bots, einer -Absicht oder eines -Slot-Typs. Veröffentlichte Versionen können nicht geändert werden. Sie können jederzeit eine neue Version veröffentlichen, nachdem Sie eine Ressource in der Konsole oder über die Operationen CreateBotVersion, CreateIntentVersion oder CreateSlotTypeVersion aktualisiert haben.

Löschen einer Amazon Lex LEX-Ressource oder -Version

Amazon Lex unterstützt das Löschen einer Ressource oder Version mit der Konsole oder einer der folgenden API-Operationen:

Aliasnamen

Ein Alias ist ein Zeiger auf eine bestimmte Version eines Amazon Lex LEX-Bots. Verwenden Sie einen Alias, um Clientanwendungen zu erlauben, eine bestimmte Version des Bots zu verwenden, ohne dass die Anwendung nachverfolgen muss, um welche Version es sich handelt.

Das folgende Beispiel zeigt zwei Versionen eines Amazon Lex Bots, Version 1 und Version 2. Jeder dieser Bot-Versionen ist ein Alias zugeordnet, BETA bzw. PROD. Clientanwendungen greifen auf den Bot mithilfe des PROD-Alias zu.

Point a client application to a version by using an alias.

Wenn Sie eine zweite Version des Bots erstellen, können Sie den Alias mit der Konsole oder der PutBot-Operation so aktualisieren, dass er auf die neue Version des Bots zeigt. Wenn Sie den Alias ändern, verwenden alle Ihre Clientanwendungen die neue Version. Wenn es mit der neuen Version ein Problem gibt, können Sie einfach zu der vorhergehenden Version zurückkehren, indem Sie den Alias so ändern, dass er auf diese Version zeigt.

Updating an alias changes the version used by client applications.

Anmerkung

Obwohl Sie die $LATEST Version eines Bots in der Konsole testen können, empfehlen wir für den Fall, dass Sie einen Bot in Ihre Clientanwendung integrieren, zunächst eine Version zu veröffentlichen und einen Alias zu erstellen, der auf diese Version zeigt. Verwenden Sie den Alias in Ihrer Clientanwendung aus den Gründen, die in diesem Abschnitt erklärt werden. Wenn Sie einen Alias aktualisieren, wartet Amazon Lex bis alle aktuellen Sitzungen abgelaufen sind, ehe es die neue Version verwendet. Weitere Informationen zur Zeitbeschränkung bei einer Sitzung finden Sie unter Festlegen der Sitzungs-Zeitüberschreitung.