PutSlotType - Amazon Lex V1
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

PutSlotType

Erstellt einen benutzerdefinierten Slot-Typ oder ersetzt einen vorhandenen, benutzerdefinierten Slot-Typ.

Um einen benutzerdefinierten Slot-Typ zu erstellen, geben Sie einen Namen für den Slot-Typ und eine Reihe von Aufzählungswerten an. Dies sind die Werte, die ein Slot dieses Typs annehmen kann. Weitere Informationen finden Sie unter Amazon Lex — Funktionsweise.

Wenn Sie den Namen eines vorhandenen Slot-Typs angeben, ersetzen die Felder in der Anfrage die vorhandenen Werte in der $LATEST Version des Slot-Typs. Amazon Lex entfernt die Felder, die Sie in der Anfrage nicht angeben. Wenn Sie keine Pflichtfelder angeben, löst Amazon Lex eine Ausnahme aus. Wenn Sie die $LATEST Version eines Slot-Typs aktualisieren und ein Bot die $LATEST Version einer Intent verwendet, die den Slot-Typ enthält, wird das status Feld des Bots auf NOT_BUILT gesetzt.

Diese Operation erfordert Berechtigungen für die Aktion lex:PutSlotType.

Anforderungssyntax

PUT /slottypes/name/versions/$LATEST HTTP/1.1
Content-type: application/json

{
   "checksum": "string",
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string"
}

URI-Anfrageparameter

Die Anforderung verwendet die folgenden URI-Parameter.

name

Der Name des Slot-Typs. Beim Namen wird nicht zwischen Groß- und Kleinschreibung unterschieden.

Der Name darf nicht mit einem Namen eines integrierten Steckplatztyps oder einem Namen eines integrierten Steckplatztyps mit „AMAZON“ übereinstimmen. entfernt. Da es beispielsweise einen integrierten Slot-Typ namens gibtAMAZON.DATE, können Sie keinen benutzerdefinierten Slot-Typ namens erstellenDATE.

Eine Liste der integrierten Slot-Typen finden Sie unter Slot-Typ-Referenz im Alexa Skills Kit.

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 100 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.

Wenn Sie einen neuen Slot-Typ erstellen, lassen Sie das checksum Feld leer. Wenn Sie eine Prüfsumme angeben, erhalten Sie eine BadRequestException Ausnahme.

Wenn Sie einen Slot-Typ aktualisieren möchten, setzen Sie das checksum Feld auf die Prüfsumme der letzten Version der $LATEST Version. Wenn Sie das checksum Feld nicht angeben oder wenn die Prüfsumme nicht mit der $LATEST Version übereinstimmt, erhalten Sie eine PreconditionFailedException Ausnahme.

Typ: Zeichenfolge

Erforderlich: Nein

createVersion

Wenn diese Option aktiviert ist, wird true eine neue nummerierte Version des Slot-Typs erstellt. Dies entspricht dem Aufrufen der CreateSlotTypeVersion Operation. Wenn Sie nichts angebencreateVersion, ist die Standardeinstellungfalse.

Typ: Boolesch

Erforderlich: Nein

description

Eine Beschreibung des Slot-Typs.

Typ: Zeichenfolge

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

Erforderlich: Nein

enumerationValues

Eine Liste von EnumerationValue Objekten, die die Werte definiert, die der Slot-Typ annehmen kann. Jeder Wert kann eine Liste mit zusätzlichen Werten enthaltensynonyms, mit deren Hilfe das Modell des maschinellen Lernens anhand der Werte trainiert werden kann, die es für einen Slot auflöst.

Ein Slot-Typ mit regulären Ausdrücken erfordert keine Aufzählungswerte. Alle anderen Slot-Typen erfordern eine Liste von Aufzählungswerten.

Wenn Amazon Lex einen Slot-Wert auflöst, generiert es eine Auflösungsliste, die bis zu fünf mögliche Werte für den Slot enthält. Wenn Sie eine Lambda-Funktion verwenden, wird diese Auflösungsliste an die Funktion übergeben. Wenn Sie keine Lambda-Funktion verwenden, können Sie wählen, ob Sie den vom Benutzer eingegebenen Wert oder den ersten Wert in der Auflösungsliste als Slot-Wert zurückgeben möchten. Das valueSelectionStrategy Feld gibt die zu verwendende Option an.

Typ: Array von EnumerationValue-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Maximale Anzahl von 10000 Artikeln.

Erforderlich: Nein

parentSlotTypeSignature

Der integrierte Steckplatztyp, der als übergeordneter Steckplatztyp verwendet wird. Wenn Sie einen übergeordneten Steckplatztyp definieren, hat der neue Steckplatztyp dieselbe Konfiguration wie der übergeordnete Steckplatztyp.

Nur AMAZON.AlphaNumeric wird unterstützt.

Typ: Zeichenfolge

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

Pattern: ^((AMAZON\.)_?|[A-Za-z]_?)+

Erforderlich: Nein

slotTypeConfigurations

Konfigurationsinformationen, die den Typ des übergeordneten integrierten Steckplatzes erweitern. Die Konfiguration wird zu den Einstellungen für den Typ des übergeordneten Steckplatzes hinzugefügt.

Typ: Array von SlotTypeConfiguration-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 10 Elemente.

Erforderlich: Nein

valueSelectionStrategy

Bestimmt die Strategie zur Steckplatzauflösung, die Amazon Lex verwendet, um Slot-Typ-Werte zurückzugeben. Das Feld kann auf einen der folgenden Werte gestellt werden:

  • ORIGINAL_VALUE- Gibt den vom Benutzer eingegebenen Wert zurück, wenn der Benutzerwert dem Slot-Wert ähnlich ist.

  • TOP_RESOLUTION- Wenn es eine Auflösungsliste für den Steckplatz gibt, geben Sie den ersten Wert in der Auflösungsliste als Slot-Typwert zurück. Wenn keine Auflösungsliste vorhanden ist, wird null zurückgegeben.

Wenn Sie den nicht angebenvalueSelectionStrategy, ist der StandardwertORIGINAL_VALUE.

Typ: Zeichenfolge

Zulässige Werte: ORIGINAL_VALUE | TOP_RESOLUTION

Erforderlich: Nein

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "checksum": "string",
   "createdDate": number,
   "createVersion": boolean,
   "description": "string",
   "enumerationValues": [ 
      { 
         "synonyms": [ "string" ],
         "value": "string"
      }
   ],
   "lastUpdatedDate": number,
   "name": "string",
   "parentSlotTypeSignature": "string",
   "slotTypeConfigurations": [ 
      { 
         "regexConfiguration": { 
            "pattern": "string"
         }
      }
   ],
   "valueSelectionStrategy": "string",
   "version": "string"
}

Antwortelemente

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

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

checksum

Prüfsumme der $LATEST Version des Slot-Typs.

Typ: Zeichenfolge

createdDate

Das Datum, an dem der Slot-Typ erstellt wurde.

Typ: Zeitstempel

createVersion

Truewenn eine neue Version des Slot-Typs erstellt wurde. Wenn das createVersion Feld in der Anfrage nicht angegeben wurde, wird das createVersion Feld in der Antwort auf „Falsch“ gesetzt.

Typ: Boolesch

description

Eine Beschreibung des Slot-Typs.

Typ: Zeichenfolge

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

enumerationValues

Eine Liste von EnumerationValue Objekten, die die Werte definiert, die der Slot-Typ annehmen kann.

Typ: Array von EnumerationValue-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Maximale Anzahl von 10000 Elementen.

lastUpdatedDate

Das Datum, an dem der Slot-Typ aktualisiert wurde. Wenn Sie einen Slot-Typ erstellen, stimmen das Erstellungsdatum und das Datum der letzten Aktualisierung überein.

Typ: Zeitstempel

name

Der Name des Slot-Typs.

Typ: Zeichenfolge

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

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

parentSlotTypeSignature

Der integrierte Slot-Typ, der dem Slot-Typ als übergeordnetes Objekt verwendet wird.

Typ: Zeichenfolge

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

Pattern: ^((AMAZON\.)_?|[A-Za-z]_?)+

slotTypeConfigurations

Konfigurationsinformationen, die den Typ des übergeordneten integrierten Steckplatzes erweitern.

Typ: Array von SlotTypeConfiguration-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 10 Elemente.

valueSelectionStrategy

Die Strategie zur Steckplatzauflösung, die Amazon Lex verwendet, um den Wert des Steckplatzes zu bestimmen. Weitere Informationen finden Sie unter PutSlotType.

Typ: Zeichenfolge

Zulässige Werte: ORIGINAL_VALUE | TOP_RESOLUTION

version

Die Version des Steckplatztyps. Für einen neuen Slot-Typ ist die Version immer$LATEST.

Typ: Zeichenfolge

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

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

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

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: