CreateBotVersion

Erstellt eine neue Version des Bots basierend auf der $LATEST Version. Wenn sich die $LATEST Version dieser Ressource seit der Erstellung der letzten Version nicht geändert hat, erstellt Amazon Lex keine neue Version. Es gibt die zuletzt erstellte Version zurück.

Anmerkung

Sie können nur die $LATEST Version des Bots aktualisieren. Sie können die nummerierten Versionen, die Sie mit dem CreateBotVersion Vorgang erstellen, nicht aktualisieren.

Wenn Sie die erste Version eines Bots erstellen, setzt Amazon Lex die Version auf 1. Nachfolgende Versionen werden um 1 erhöht. Weitere Informationen finden Sie unter Versioning.

Diese Operation setzt eine Berechtigung für die lex:CreateBotVersion-Aktion voraus.

Anforderungssyntax

POST /bots/name/versions HTTP/1.1
Content-type: application/json

{
   "checksum": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

name

Der Name des Bots, von dem Sie eine neue Version erstellen möchten. Der Name berücksichtigt Groß- und Kleinschreibung.

Längenbeschränkungen: Mindestlänge von 2. Maximale Länge = 50 Zeichen.

Pattern: ^([A-Za-z]_?)+$

Erforderlich: Ja

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

checksum

Identifiziert eine bestimmte Version der $LATEST Version des Bots. Wenn Sie eine Prüfsumme angeben und die $LATEST Version des Bots eine andere Prüfsumme hat, wird eine PreconditionFailedException Ausnahme zurückgegeben und Amazon Lex veröffentlicht keine neue Version. Wenn Sie keine Prüfsumme angeben, veröffentlicht Amazon Lex die $LATEST Version.

Typ: Zeichenfolge

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 201
Content-type: application/json

{
   "abortStatement": { 
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "checksum": "string",
   "childDirected": boolean,
   "clarificationPrompt": { 
      "maxAttempts": number,
      "messages": [ 
         { 
            "content": "string",
            "contentType": "string",
            "groupNumber": number
         }
      ],
      "responseCard": "string"
   },
   "createdDate": number,
   "description": "string",
   "detectSentiment": boolean,
   "enableModelImprovements": boolean,
   "failureReason": "string",
   "idleSessionTTLInSeconds": number,
   "intents": [ 
      { 
         "intentName": "string",
         "intentVersion": "string"
      }
   ],
   "lastUpdatedDate": number,
   "locale": "string",
   "name": "string",
   "status": "string",
   "version": "string",
   "voiceId": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP-201-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

abortStatement

Die Nachricht, die Amazon Lex verwendet, um eine Konversation abzubrechen. Weitere Informationen finden Sie unter PutBot.

Typ: Statement Objekt

checksum

Prüfsumme, die die Version des Bots identifiziert, der erstellt wurde.

Typ: Zeichenfolge

childDirected

Für jeden Amazon Lex-Bot, der mit dem Amazon Lex Model Building Service erstellt wurde, müssen Sie angeben, ob Ihre Nutzung von Amazon Lex mit einer Website, einem Programm oder einer anderen Anwendung zusammenhängt, die sich ganz oder teilweise an Kinder unter 13 Jahren richtet oder darauf abzielt und dem Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) unterliegt, indem Sie true oder false im childDirected Feld angeben. Durch die Angabe true in childDirected diesem Feld bestätigen Sie, dass Ihre Nutzung von Amazon Lex mit einer Website, einem Programm oder einer anderen Anwendung zusammenhängt, die sich ganz oder teilweise an Kinder unter 13 Jahren richtet oder darauf abzielt und der COPPA unterliegt. Durch die Angabe false in childDirected diesem Feld bestätigen Sie, dass Ihre Nutzung von Amazon Lex nicht mit einer Website, einem Programm oder einer anderen Anwendung zusammenhängt, die sich ganz oder teilweise an Kinder unter 13 Jahren richtet oder darauf abzielt und der COPPA unterliegt. Sie dürfen keinen Standardwert für das childDirected Feld angeben, der nicht genau wiedergibt, ob Ihre Nutzung von Amazon Lex mit einer Website, einem Programm oder einer anderen Anwendung zusammenhängt, die sich ganz oder teilweise an Kinder unter 13 Jahren richtet oder darauf abzielt und der COPPA unterliegt.

Wenn sich Ihre Nutzung von Amazon Lex auf eine Website, ein Programm oder eine andere Anwendung bezieht, die sich ganz oder teilweise an Kinder unter 13 Jahren richtet, müssen Sie die erforderliche nachprüfbare Zustimmung der Eltern gemäß COPPA einholen. Informationen zur Verwendung von Amazon Lex in Verbindung mit Websites, Programmen oder anderen Anwendungen, die sich ganz oder teilweise an Kinder unter 13 Jahren richten oder richten, finden Sie in den häufig gestellten Fragen zu Amazon Lex.

Typ: Boolesch

clarificationPrompt

Die Nachricht, die Amazon Lex verwendet, wenn es die Anfrage des Benutzers nicht versteht. Weitere Informationen finden Sie unter PutBot.

Typ: Prompt Objekt

createdDate

Das Datum, an dem die Bot-Version erstellt wurde.

Typ: Zeitstempel

description

Eine Beschreibung des Bots.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 0. Höchstlänge = 200 Zeichen.

detectSentiment

Gibt an, ob vom Benutzer eingegebene Äußerungen zur Stimmungsanalyse an Amazon Comprehend gesendet werden sollen.

Typ: Boolesch

enableModelImprovements

Gibt an, ob der Bot Genauigkeitsverbesserungen verwendet. truegibt an, dass der Bot die Verbesserungen verwendet, andernfallsfalse.

Typ: Boolesch

failureReason

Falls status jaFAILED, gibt Amazon Lex den Grund an, warum der Bot nicht erstellt werden konnte.

Typ: Zeichenfolge

idleSessionTTLInSeconds

Die maximale Zeit in Sekunden, für die Amazon Lex die in einer Konversation gesammelten Daten aufbewahrt. Weitere Informationen finden Sie unter PutBot.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 60. Maximaler Wert von 86400.

intents

Ein Array von Intent-Objekten. Weitere Informationen finden Sie unter PutBot.

Typ: Array von Intent-Objekten

lastUpdatedDate

Das Datum, an dem die $LATEST Version dieses Bots aktualisiert wurde.

Typ: Zeitstempel

locale

Gibt das Zielgebietsschema für den Bot an.

Typ: Zeichenfolge

Zulässige Werte: de-DE | en-AU | en-GB | en-IN | en-US | es-419 | es-ES | es-US | fr-FR | fr-CA | it-IT | ja-JP | ko-KR

name

Der Name des Bots.

Typ: Zeichenfolge

Längenbeschränkungen: Mindestlänge von 2. Maximale Länge = 50 Zeichen.

Pattern: ^([A-Za-z]_?)+$

status

Wenn Sie eine Anfrage zur Erstellung oder Aktualisierung eines Bots senden, setzt Amazon Lex das status Antwortelement aufBUILDING. Nachdem Amazon Lex den Bot erstellt hat, wird er status auf eingestelltREADY. Wenn Amazon Lex den Bot nicht erstellen kann, wird er status auf gesetztFAILED. Amazon Lex gibt den Grund für den Fehler im failureReason Antwortelement zurück.

Typ: Zeichenfolge

Zulässige Werte: BUILDING | READY | READY_BASIC_TESTING | FAILED | NOT_BUILT

version

Die Version des Bots.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 64 Zeichen.

Pattern: \$LATEST|[0-9]+

voiceId

Die Amazon Polly Polly-Sprach-ID, die Amazon Lex für Sprachinteraktionen mit dem Benutzer verwendet.

Typ: Zeichenfolge

Fehler

BadRequestException

Die Anfrage ist nicht korrekt formuliert. Beispielsweise ist ein Wert ungültig oder ein erforderliches Feld fehlt. Überprüfen Sie die Feldwerte und versuchen Sie es erneut.

HTTP Status Code: 400

ConflictException

Bei der Verarbeitung der Anfrage ist ein Konflikt aufgetreten. Versuchen Sie es erneut.

HTTP-Statuscode: 409

InternalFailureException

Ein interner Amazon Lex Lex-Fehler ist aufgetreten. Versuchen Sie es erneut.

HTTP Status Code: 500

LimitExceededException

Die Anfrage hat ein Limit überschritten. Versuchen Sie es erneut.

HTTP-Statuscode: 429

NotFoundException

Die in der Anfrage angegebene Ressource wurde nicht gefunden. Überprüfen Sie die Ressource und versuchen Sie es erneut.

HTTP Status Code: 404

PreconditionFailedException

Die Prüfsumme der Ressource, die Sie ändern möchten, stimmt nicht mit der Prüfsumme in der Anfrage überein. Überprüfen Sie die Prüfsumme der Ressource und versuchen Sie es erneut.

HTTP-Statuscode: 412

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS SDKs finden Sie im Folgenden:

• AWS -Befehlszeilenschnittstelle

• AWS SDK for .NET

• AWS SDK for C++

• AWS SDK for Go v2

• AWS SDK for Java V2

• AWS SDK für JavaScript V3

• AWS SDK for PHP V3

• AWS SDK für Python

• AWS SDK for Ruby V3