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.
# Bots in Lex V2 importieren und exportieren
Sie können eine Bot-Definition, ein Bot-Gebietsschema oder ein benutzerdefiniertes Vokabular exportieren und es dann wieder importieren, um eine neue Ressource zu erstellen oder eine bestehende Ressource in einem AWS-Konto zu überschreiben. Sie können beispielsweise einen Bot aus einem Testkonto exportieren und dann eine Kopie des Bots in Ihrem Produktionskonto erstellen. Sie können einen Bot auch von einer AWS-Region in eine andere Region kopieren.
Sie können die Ressourcen der exportierten Ressource ändern, bevor Sie sie importieren. Sie können beispielsweise einen Bot exportieren und dann die JSON-Datei für einen Slot bearbeiten, um Äußerungen zur Auslösung von Slot-Werten aus einem bestimmten Slot hinzuzufügen oder zu entfernen. Nachdem Sie die Bearbeitung der Definition abgeschlossen haben, können Sie die geänderte Datei importieren.
**Topics**
+ [
# Bots aus Lex V2 exportieren
](export.md)
+ [
# Bots in Lex V2 importieren
](import.md)
+ [
# Beim Import oder Export ein Passwort verwenden
](import-export-password.md)
+ [
# JSON-Format für den Import und Export von Bots in Lex V2
](import-export-format.md)
# Bots aus Lex V2 exportieren
Sie exportieren einen Bot, ein Bot-Gebietsschema oder ein benutzerdefiniertes Vokabular mithilfe der Konsole oder der `CreatExport` Operation. Sie geben die zu exportierende Ressource an und können ein optionales Passwort angeben, um die ZIP-Datei zu schützen, wenn Sie einen Export starten. Nachdem Sie die ZIP-Datei heruntergeladen haben, müssen Sie das Kennwort für den Zugriff auf die Datei verwenden, bevor Sie sie verwenden können. Weitere Informationen finden Sie unter [Beim Import oder Export ein Passwort verwenden](import-export-password.md).
Der Export ist ein asynchroner Vorgang. Sobald Sie den Export gestartet haben, können Sie die Konsole oder den `DescribeExport` Vorgang verwenden, um den Fortschritt des Exports zu überwachen. Sobald der Export abgeschlossen ist, zeigt die Konsole oder der `DescribeExport` Vorgang den Status an`COMPLETED`, und die Konsole lädt die exportierte ZIP-Datei in Ihren Browser herunter. Wenn Sie den `DescribeExport` Vorgang verwenden, stellt Amazon Lex V2 eine vorsignierte Amazon S3 S3-URL bereit, über die Sie die Ergebnisse des Exports herunterladen können. Die Download-URL ist nur für fünf Minuten verfügbar, aber Sie können eine neue URL erhalten, indem Sie den `DescribeExport` Vorgang erneut aufrufen.
Sie können den Verlauf der Exporte für eine Ressource mit der Konsole oder mit dem `ListExports` Vorgang anzeigen. Die Ergebnisse zeigen die Exporte zusammen mit ihrem aktuellen Status. Ein Export ist sieben Tage lang in der Historie verfügbar.
Wenn Sie die `Draft` Version eines Bots oder eines Bot-Gebietsschemas exportieren, ist es möglich, dass sich die Definition in der JSON-Datei in einem inkonsistenten Zustand befindet, da die `Draft` Version eines Bots oder eines Bot-Gebietsschemas während eines Exports geändert werden kann. Wenn die `Draft` Version während des Exports geändert wird, sind die Änderungen möglicherweise nicht in der Exportdatei enthalten.
Wenn Sie ein Bot-Gebietsschema exportieren, exportiert Amazon Lex alle Informationen, die das Gebietsschema definieren, einschließlich des Gebietsschemas, des benutzerdefinierten Wortschatzes, der Absichten, der Slot-Typen und der Slots.
Wenn Sie einen Bot exportieren, exportiert Amazon Lex alle für den Bot definierten Gebietsschemas, einschließlich der Absichten, Slot-Typen und Slots. Die folgenden Elemente werden nicht mit einem Bot exportiert:
+ Bot-Alias
+ Mit einem Bot verknüpfter Rollen-ARN
+ Mit Bots und Bot-Aliasnamen verknüpfte Tags
+ Lambda-Code-Hooks, die mit einem Bot-Alias verknüpft sind
Der Rollen-ARN und die Tags werden als Anforderungsparameter eingegeben, wenn Sie einen Bot importieren. Sie müssen nach dem Import gegebenenfalls Bot-Aliase erstellen und Lambda-Code-Hooks zuweisen.
Sie können einen Export und die zugehörige .zip-Datei mithilfe der Konsole oder des Vorgangs entfernen. `DeleteExport`
Ein Beispiel für das Exportieren eines Bots mithilfe der Konsole finden Sie unter[Einen Lex V2-Bot exportieren (Konsole)](export-console.md).
## Für den Export von Bots in Lex V2 sind IAM-Berechtigungen erforderlich
Um Bots, Bot-Gebietsschemas und benutzerdefinierte Vokabulare zu exportieren, muss der Benutzer, der den Export ausführt, über die folgenden IAM-Berechtigungen verfügen.
| API | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Ressource |
| --- | --- | --- |
| [CreateExport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateExport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Bot |
| [UpdateExport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateExport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Bot |
| [DescribeExport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeExport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Bot |
| [DescribeExport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeExport.html)für benutzerdefinierte Vokabeln | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Bot |
| [DeleteExport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteExport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | Bot |
| [ListExports](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListExports.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/export.html) | \$1 |
Eine IAM-Beispielrichtlinie finden Sie unter [Erlaubt einem Benutzer, Bots und Bot-Gebietsschemas zu exportieren](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-export).
# Einen Lex V2-Bot exportieren (Konsole)
Sie können einen Bot aus der Bot-Liste, aus der Versionsliste oder von der Seite mit den Versionsdetails exportieren. Wenn Sie eine Version auswählen, exportiert Amazon Lex V2 diese Version. In den folgenden Anweisungen wird davon ausgegangen, dass Sie den Bot aus der Liste der Bots exportieren. Wenn Sie jedoch mit einer Version beginnen, sind die Schritte dieselben.
**Um einen Bot mit der Konsole zu exportieren**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Lex V2-Konsole zu [https://console.aws.amazon.com/lexv2/Hause](https://console.aws.amazon.com/lexv2/home).
1. Wählen Sie aus der Liste der Bots den Bot aus, den Sie exportieren möchten.
1. Wählen Sie **unter Aktion** die Option **Exportieren** aus.
1. Wählen Sie die Bot-Version, die Plattform und das Exportformat aus.
1. (Optional) Geben Sie ein Passwort für die ZIP-Datei ein. Die Angabe eines Kennworts trägt zum Schutz des Ausgabearchivs bei.
1. Wählen Sie **Export** aus.
Nachdem Sie den Export gestartet haben, kehren Sie zur Liste der Bots zurück. Verwenden Sie die Liste mit dem **Import-/Exportverlauf, um den Fortschritt des Exports** zu überwachen. Wenn der Status des Exports **abgeschlossen** ist, lädt die Konsole die ZIP-Datei automatisch auf Ihren Computer herunter.
Um den Export erneut herunterzuladen, wählen Sie in der import/export Liste den Export und dann **Herunterladen** aus. Sie können ein Passwort für die heruntergeladene ZIP-Datei angeben.
**Um eine Bot-Sprache zu exportieren**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Lex V2-Konsole zu [https://console.aws.amazon.com/lexv2/Hause](https://console.aws.amazon.com/lexv2/home).
1. Wählen Sie aus der Liste der Bots den Bot aus, dessen Sprache Sie exportieren möchten.
1. Wählen **Sie unter Sprachen hinzufügen** die Option **Sprachen anzeigen** aus.
1. Wählen Sie aus der Liste **Alle Sprachen** die zu exportierende Sprache aus.
1. Wählen Sie **unter Aktion** die Option **Exportieren** aus.
1. Wählen Sie die Bot-Version, die Plattform und das Format aus.
1. (Optional) Geben Sie ein Passwort für die ZIP-Datei ein. Die Angabe eines Kennworts trägt zum Schutz des Ausgabearchivs bei.
1. Wählen Sie **Export** aus.
Nachdem Sie den Export gestartet haben, kehren Sie zur Liste der Sprachen zurück. Verwenden Sie die Liste mit dem **Import-/Exportverlauf, um den Fortschritt des Exports** zu überwachen. Wenn der Status des Exports **abgeschlossen** ist, lädt die Konsole die ZIP-Datei automatisch auf Ihren Computer herunter.
Um den Export erneut herunterzuladen, wählen Sie in der import/export Liste den Export und dann **Herunterladen** aus. Sie können ein Passwort für die heruntergeladene ZIP-Datei angeben.
# Bots in Lex V2 importieren
Um mit der Konsole einen zuvor exportierten Bot, ein Bot-Gebietsschema oder ein benutzerdefiniertes Vokabular zu importieren, geben Sie den Speicherort der Datei auf Ihrem lokalen Computer und das optionale Passwort zum Entsperren der Datei an. Ein Beispiel finden Sie unter [Einen Lex V2-Bot importieren (Konsole)](import-console.md).
Wenn Sie die API verwenden, erfolgt das Importieren einer Ressource in drei Schritten:
1. Erstellen Sie mithilfe des `CreateUploadUrl` Vorgangs eine Upload-URL. Sie müssen keine Upload-URL erstellen, wenn Sie die Konsole verwenden.
1. Laden Sie die ZIP-Datei hoch, die die Ressourcendefinition enthält.
1. Starten Sie den Import mit dem `StartImport` Vorgang.
Die Upload-URL ist eine vorsignierte Amazon S3 S3-URL mit Schreibberechtigung. Die URL ist nach ihrer Generierung fünf Minuten lang verfügbar. Wenn Sie die ZIP-Datei mit einem Passwort schützen, müssen Sie das Passwort angeben, wenn Sie den Import starten. Weitere Informationen finden Sie unter [Beim Import oder Export ein Passwort verwenden](import-export-password.md).
Ein Import ist ein asynchroner Prozess. Sie können den Fortschritt eines Imports mithilfe der Konsole oder des `DescribeImport` Vorgangs überwachen.
Wenn Sie einen Bot oder ein Bot-Gebietsschema importieren, kann es zu Konflikten zwischen Ressourcennamen in der Importdatei und vorhandenen Ressourcennamen in Amazon Lex V2 kommen. Amazon Lex V2 kann den Konflikt auf drei Arten behandeln:
+ **Fehler bei Konflikt** — Der Import wird gestoppt und es werden keine Ressourcen aus der importierten ZIP-Datei importiert.
+ **Überschreiben** — Amazon Lex V2 importiert alle Ressourcen aus der importierten ZIP-Datei und ersetzt alle vorhandenen Ressourcen durch die Definition aus der Importdatei.
+ **Anfügen** — Amazon Lex V2 importiert alle Ressourcen aus der importierten ZIP-Datei und fügt sie jeder vorhandenen Ressource mit der Definition aus der Importdatei hinzu. Dies ist nur für das Bot-Gebietsschema verfügbar.
Sie können eine Liste der Importe in eine Ressource mithilfe der Konsole oder des `ListImports` Vorgangs anzeigen. Importe bleiben sieben Tage lang in der Liste. Sie können die Konsole oder den `DescribeImport` Vorgang verwenden, um Details zu einem bestimmten Import anzuzeigen.
Sie können einen Import und die zugehörige ZIP-Datei auch mithilfe der Konsole oder des `DeleteImport` Vorgangs entfernen.
Ein Beispiel für das Importieren eines Bots mithilfe der Konsole finden Sie unter[Einen Lex V2-Bot importieren (Konsole)](import-console.md).
## Für den Import sind IAM-Berechtigungen erforderlich
Um Bots, Bot-Gebietsschemas und benutzerdefinierte Vokabulare zu importieren, muss der Benutzer, der den Import ausführt, über die folgenden IAM-Berechtigungen verfügen.
| API | Erforderliche IAM-Aktionen | Ressource |
| --- | --- | --- |
| [CreateUploadUrl](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateUploadUrl.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | \$1 |
| [StartImport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartImport.html)für Bot und Bot-Locale | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) |
| [StartImport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_StartImport.html)für benutzerdefinierte Vokabulare | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | Bot |
| [DescribeImport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeImport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | Bot |
| [DeleteImport](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteImport.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | Bot |
| [ListImports](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListImports.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/lexv2/latest/dg/import.html) | \$1 |
Eine IAM-Beispielrichtlinie finden Sie unter [Erlaubt einem Benutzer, Bots und Bot-Gebietsschemas zu importieren](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-import).
# Einen Lex V2-Bot importieren (Konsole)
**So importieren Sie einen Bot mithilfe der Konsole**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Lex V2-Konsole zu [https://console.aws.amazon.com/lexv2/Hause](https://console.aws.amazon.com/lexv2/home).
1. Wählen Sie **unter Aktion** die Option **Import** aus.
1. Geben Sie dem Bot unter **Eingabedatei** einen Namen und wählen Sie dann die ZIP-Datei aus, die die JSON-Dateien enthält, die den Bot definieren.
1. Wenn die .zip-Datei kennwortgeschützt ist, geben Sie das Passwort für die .zip-Datei ein. Der Kennwortschutz des Archivs ist optional, trägt aber zum Schutz des Inhalts bei.
1. Erstellen Sie die IAM-Rolle, die die Berechtigungen für Ihren Bot definiert, oder geben Sie sie ein.
1. Geben Sie an, ob Ihr Bot dem Gesetz zum Schutz der Privatsphäre von Kindern im Internet (Children's Online Privacy Protection Act, COPPA) unterliegt.
1. Geben Sie eine Einstellung für das Leerlauf-Timeout für Ihren Bot an. Wenn Sie keinen Wert angeben, wird der Wert aus der ZIP-Datei verwendet. Wenn die ZIP-Datei keine Timeout-Einstellung enthält, verwendet Amazon Lex V2 die Standardeinstellung von 300 Sekunden (fünf Minuten).
1. (Optional) Fügen Sie Tags für Ihren Bot hinzu.
1. Wählen Sie aus, ob Sie vor dem Überschreiben vorhandener Bots mit demselben Namen warnen möchten. Wenn Sie Warnungen aktivieren und der Bot, den Sie importieren, einen vorhandenen Bot überschreiben würde, erhalten Sie eine Warnung und der Bot wird nicht importiert. Wenn Sie Warnungen deaktivieren, ersetzt der importierte Bot den vorhandenen Bot mit demselben Namen.
1. Wählen Sie **Importieren** aus.
Nachdem Sie den Import gestartet haben, kehren Sie zur Liste der Bots zurück. Verwenden Sie die Liste mit dem **Import-/Exportverlauf, um den Fortschritt des Imports** zu überwachen. Wenn der Status des Imports **abgeschlossen** ist, können Sie den Bot aus der Liste der Bots auswählen, um den Bot zu ändern oder zu erstellen.
**Um eine Bot-Sprache zu importieren**
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon Lex V2-Konsole zu [https://console.aws.amazon.com/lexv2/Hause](https://console.aws.amazon.com/lexv2/home).
1. Wählen Sie aus der Liste der Bots den Bot aus, in den Sie eine Sprache importieren möchten.
1. Wählen **Sie unter Sprachen hinzufügen** die Option **Sprachen anzeigen** aus.
1. Wählen Sie **unter Aktion** die Option **Importieren** aus.
1. Wählen Sie **unter Eingabedatei** die Datei aus, die die zu importierende Sprache enthält. Wenn Sie die ZIP-Datei geschützt haben, geben Sie das Passwort im Feld Passwort **ein**.
1. Wählen Sie unter **Sprache** die Sprache aus, als die importiert werden soll. Die Sprache muss nicht mit der Sprache in der Importdatei übereinstimmen. Sie können die Absichten von einer Sprache in eine andere kopieren.
1. Wählen Sie in **Voice** die Amazon Polly Polly-Stimme aus, die für die Sprachinteraktion verwendet werden soll, oder wählen Sie **Keine** für einen reinen Text-Bot.
1. Geben Sie im Feld **Schwellenwert für den Vertrauenswert** den Schwellenwert ein, an dem Amazon Lex V2 die `AMAZON.FallbackIntent``AMAZON.KendraSearchIntent`, die oder beide einfügt, wenn alternative Absichten zurückgegeben werden.
1. Wählen Sie aus, ob vor dem Überschreiben einer vorhandenen Sprache gewarnt werden soll. Wenn Sie Warnungen aktivieren und die Sprache, die Sie importieren, eine bestehende Sprache überschreiben würde, erhalten Sie eine Warnung und die Sprache wird nicht importiert. Wenn Sie Warnungen deaktivieren, ersetzt die importierte Sprache die vorhandene Sprache.
1. Wählen Sie **Import**, um mit dem Import der Sprache zu beginnen.
Nachdem Sie den Import gestartet haben, kehren Sie zur Liste der Sprachen zurück. Verwenden Sie die Liste mit dem **Import-/Exportverlauf, um den Fortschritt des Imports** zu überwachen. Wenn der Status des Imports **abgeschlossen** ist, können Sie aus der Liste der Bots die Sprache auswählen, in der der Bot geändert oder erstellt werden soll.
# Beim Import oder Export ein Passwort verwenden
Amazon Lex V2 kann Ihre Exportarchive mit einem Passwort schützen oder Ihre geschützten Importarchive mithilfe der standardmäßigen ZIP-Dateikomprimierung lesen. Sie sollten Ihre Import- und Exportarchive immer mit einem Passwort schützen.
Amazon Lex V2 sendet Ihr Exportarchiv an einen S3-Bucket, und es steht Ihnen mit einer vorsignierten S3-URL zur Verfügung. Die URL ist nur für fünf Minuten verfügbar. Das Archiv steht jedem zur Verfügung, der Zugriff auf die Download-URL hat. Um die Daten im Archiv zu schützen, geben Sie beim Exportieren der Ressource ein Passwort ein. Wenn Sie das Archiv abrufen müssen, nachdem die URL abgelaufen ist, können Sie die Konsole oder den `DescribeExport` Vorgang verwenden, um eine neue URL abzurufen.
Wenn Sie das Kennwort für ein Exportarchiv verlieren, können Sie ein neues Kennwort für eine vorhandene Datei erstellen, indem Sie in der import/export Verlaufstabelle die Option **Herunterladen** auswählen oder den `UpdateExport` Vorgang verwenden. Wenn Sie in der Verlaufstabelle für einen Export die Option **Herunterladen** wählen und kein Passwort angeben, lädt Amazon Lex V2 eine ungeschützte ZIP-Datei herunter.
# JSON-Format für den Import und Export von Bots in Lex V2
Sie importieren und exportieren Bots, Bot-Locales oder benutzerdefinierte Vokabulare aus Amazon Lex V2 mithilfe einer ZIP-Datei, die JSON-Strukturen enthält, die die Teile der Ressource beschreiben. Wenn Sie eine Ressource exportieren, erstellt Amazon Lex V2 die .zip-Datei und stellt sie Ihnen mithilfe einer vorsignierten Amazon S3 S3-URL zur Verfügung. Wenn Sie eine Ressource importieren, müssen Sie eine .zip-Datei erstellen, die die JSON-Strukturen enthält, und sie auf eine vorsignierte S3-URL hochladen.
Amazon Lex erstellt die folgende Verzeichnisstruktur in der .zip-Datei, wenn Sie einen Bot exportieren. Wenn Sie ein Bot-Gebietsschema exportieren, wird nur die Struktur unter dem Gebietsschema exportiert. Wenn Sie ein benutzerdefiniertes Vokabular exportieren, wird nur die Struktur unter dem benutzerdefinierten Vokabular exportiert.
```
BotName_BotVersion_ExportID_LexJson.zip
-or-
BotName_BotVersion_LocaleId_ExportId_LEX_JSON.zip
--> manifest.json
--> BotName
----> Bot.json
----> BotLocales
------> Locale_A
--------> BotLocale.json
--------> Intents
----------> Intent_A
------------> Intent.json
------------> Slots
--------------> Slot_A
----------------> Slot.json
--------------> Slot_B
----------------> Slot.json
----------> Intent_B
...
--------> SlotTypes
----------> SlotType_A
------------> SlotType.json
----------> SlotType_B
...
--------> CustomVocabulary
------------> CustomVocabulary.json
------> Locale_B
...
```
## Struktur der Manifestdatei
Die Manifestdatei enthält Metadaten für die Exportdatei.
```
{
"metadata": {
"schemaVersion": "1.0",
"fileFormat": "LexJson",
"resourceType": "Bot | BotLocale | CustomVocabulary"
}
}
```
## Struktur der Bot-Datei
Die Bot-Datei enthält die Konfigurationsinformationen für den Bot.
```
{
"name": "BotName",
"identifier": "identifier",
"version": "number",
"description": "description",
"dataPrivacy": {
"childDirected": true | false
},
"idleSessionTTLInSeconds": seconds
}
```
## Struktur der Bot-Locale-Datei
Die Bot-Locale-Datei enthält eine Beschreibung des Gebietsschemas oder der Sprache eines Bots. Wenn Sie einen Bot exportieren, kann die .zip-Datei mehr als eine Bot-Locale-Datei enthalten. Wenn Sie ein Bot-Gebietsschema exportieren, enthält die ZIP-Datei nur ein Gebietsschema.
```
{
"name": "locale name",
"identifier": "locale ID",
"version": "number",
"description": "description",
"voiceSettings": {
"voiceId": "voice",
"engine": "standard | neural
},
"nluConfidenceThreshold": number
}
```
## Struktur der beabsichtigten Datei
Die Absichtsdatei enthält die Konfigurationsinformationen für einen Intent. In der ZIP-Datei gibt es eine Absichtsdatei für jede Absicht in einem bestimmten Gebietsschema.
Im Folgenden finden Sie ein Beispiel für eine JSON-Struktur für die BookCar Absicht im BookTrip Beispiel-Bot. Ein vollständiges Beispiel für die JSON-Struktur für einen Intent finden Sie unter [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html)Operation.
```
{
"name": "BookCar",
"identifier": "891RWHHICO",
"description": "Intent to book a car.",
"parentIntentSignature": null,
"sampleUtterances": [
{
"utterance": "Book a car"
},
{
"utterance": "Reserve a car"
},
{
"utterance": "Make a car reservation"
}
],
"intentConfirmationSetting": {
"confirmationPrompt": {
"messageGroupList": [
{
"message": {
"plainTextMessage": {
"value": "OK, I have you down for a {CarType} hire in {PickUpCity} from {PickUpDate} to {ReturnDate}. Should I book the reservation?"
},
"ssmlMessage": null,
"customPayload": null,
"imageResponseCard": null
},
"variations": null
}
],
"maxRetries": 2
},
"declinationResponse": {
"messageGroupList": [
{
"message": {
"plainTextMessage": {
"value": "OK, I have cancelled your reservation in progress."
},
"ssmlMessage": null,
"customPayload": null,
"imageResponseCard": null
},
"variations": null
}
]
}
},
"intentClosingSetting": null,
"inputContexts": null,
"outputContexts": null,
"kendraConfiguration": null,
"dialogCodeHook": null,
"fulfillmentCodeHook": null,
"slotPriorities": [
{
"slotName": "DriverAge",
"priority": 4
},
{
"slotName": "PickUpDate",
"priority": 2
},
{
"slotName": "ReturnDate",
"priority": 3
},
{
"slotName": "PickUpCity",
"priority": 1
},
{
"slotName": "CarType",
"priority": 5
}
]
}
```
## Struktur der Slot-Datei
Die Slot-Datei enthält die Konfigurationsinformationen für einen Slot in einem Intent. In der ZIP-Datei gibt es für jeden Slot, der für eine Absicht in einem bestimmten Gebietsschema definiert ist, eine Slot-Datei.
Das folgende Beispiel zeigt die JSON-Struktur eines Slots, die es dem Kunden ermöglicht, den Fahrzeugtyp auszuwählen, den er in der BookCar Absicht im BookTrip Beispiel-Bot mieten möchte. Ein vollständiges Beispiel für die JSON-Struktur für einen Slot finden Sie unter [CreateSlot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateSlot.html)Operation.
```
{
"name": "CarType",
"identifier": "KDHJWNGZGC",
"description": "Type of car being reserved.",
"multipleValuesSetting": {
"allowMutlipleValues": false
},
"slotTypeName": "CarTypeValues",
"obfuscationSetting": null,
"slotConstraint": "Required",
"defaultValueSpec": null,
"slotValueElicitationSetting": {
"promptSpecification": {
"messageGroupList": [
{
"message": {
"plainTextMessage": {
"value": "What type of car would you like to rent? Our most popular options are economy, midsize, and luxury"
},
"ssmlMessage": null,
"customPayload": null,
"imageResponseCard": null
},
"variations": null
}
],
"maxRetries": 2
},
"sampleValueElicitingUtterances": null,
"waitAndContinueSpecification": null,
}
}
```
Das folgende Beispiel zeigt die JSON-Struktur eines zusammengesetzten Slots.
```
{
"name": "CarType",
"identifier": "KDHJWNGZGC",
"description": "Type of car being reserved.",
"multipleValuesSetting": {
"allowMutlipleValues": false
},
"slotTypeName": "CarTypeValues",
"obfuscationSetting": null,
"slotConstraint": "Required",
"defaultValueSpec": null,
"slotValueElicitationSetting": {
"promptSpecification": {
"messageGroupList": [
{
"message": {
"plainTextMessage": {
"value": "What type of car would you like to rent? Our most popular options are economy, midsize, and luxury"
},
"ssmlMessage": null,
"customPayload": null,
"imageResponseCard": null
},
"variations": null
}
],
"maxRetries": 2
},
"sampleValueElicitingUtterances": null,
"waitAndContinueSpecification": null,
},
"subSlotSetting": {
"slotSpecifications": {
"firstname": {
"valueElicitationSetting": {
"promptSpecification": {
"allowInterrupt": false,
"messageGroupsList": [
{
"message": {
"imageResponseCard": null,
"ssmlMessage": null,
"customPayload": null,
"plainTextMessage": {
"value": "please provide firstname"
}
},
"variations": null
}
],
"maxRetries": 2,
"messageSelectionStrategy": "Random"
},
"defaultValueSpecification": null,
"sampleUtterances": [
{
"utterance": "my name is {firstName}"
}
],
"waitAndContinueSpecification": null
},
"slotTypeId": "AMAZON.FirstName"
},
"eyeColor": {
"valueElicitationSetting": {
"promptSpecification": {
"allowInterrupt": false,
"messageGroupsList": [
{
"message": {
"imageResponseCard": null,
"ssmlMessage": null,
"customPayload": null,
"plainTextMessage": {
"value": "please provide eye color"
}
},
"variations": null
}
],
"maxRetries": 2,
"messageSelectionStrategy": "Random"
},
"defaultValueSpecification": null,
"sampleUtterances": [
{
"utterance": "eye color is {eyeColor}"
},
{
"utterance": "I have eyeColor eyes"
}
],
"waitAndContinueSpecification": null
},
"slotTypeId": "7FEVCB2PQE"
}
},
"expression": "(firstname OR eyeColor)"
}
}
```
## Dateistruktur vom Typ Slot
Die Slot-Typ-Datei enthält die Konfigurationsinformationen für einen benutzerdefinierten Slot-Typ, der in einer Sprache oder einem Gebietsschema verwendet wird. In der ZIP-Datei gibt es für jeden benutzerdefinierten Slot-Typ in einem bestimmten Gebietsschema eine Slot-Typ-Datei.
Im Folgenden finden Sie die JSON-Struktur für den Slot-Typ, in der die im BookTrip Beispiel-Bot verfügbaren Fahrzeugtypen aufgeführt sind. Ein vollständiges Beispiel für die JSON-Struktur für einen Slot-Typ finden Sie unter [CreateSlotType](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateSlotType.html)Operation.
```
{
"name": "CarTypeValues",
"identifier": "T1YUHGD9ZR",
"description": "Enumeration representing possible types of cars available for hire",
"slotTypeValues": [{
"synonyms": null,
"sampleValue": {
"value": "economy"
}
}, {
"synonyms": null,
"sampleValue": {
"value": "standard"
}
}, {
"synonyms": null,
"sampleValue": {
"value": "midsize"
}
}, {
"synonyms": null,
"sampleValue": {
"value": "full size"
}
}, {
"synonyms": null,
"sampleValue": {
"value": "luxury"
}
}, {
"synonyms": null,
"sampleValue": {
"value": "minivan"
}
}],
"parentSlotTypeSignature": null,
"valueSelectionSetting": {
"resolutionStrategy": "TOP_RESOLUTION",
"advancedRecognitionSetting": {
"audioRecognitionStrategy": "UseSlotValuesAsCustomVocabulary"
},
"regexFilter": null
}
}
```
Das folgende Beispiel zeigt die JSON-Struktur für einen zusammengesetzten Slot-Typ.
```
{
"name": "CarCompositeType",
"identifier": "TPA3CC9V",
"description": null,
"slotTypeValues": null,
"parentSlotTypeSignature": null,
"valueSelectionSetting": {
"regexFilter": null,
"resolutionStrategy": "CONCATENATION"
},
"compositeSlotTypeSetting": {
"subSlots": [
{
"name": "model",
"slotTypeId": "MODELTYPEID" # custom slot type Id for model
},
{
"name": "city",
"slotTypeId": "AMAZON.City"
},
{
"name": "country",
"slotTypeId": "AMAZON.Country"
},
{
"name": "make",
"slotTypeId": "MAKETYPEID" # custom slot type Id for make
}
]
}
}
```
Der folgende Slot-Typ verwendet eine benutzerdefinierte Grammatik, um die Äußerungen des Kunden zu verstehen. Weitere Informationen finden Sie unter [Grammatik-Slot-Typ](building-srgs.md).
```
{
"name": "custom_grammar",
"identifier": "7KEAQIQKPX",
"description": "Slot type using a custom grammar",
"slotTypeValues": null,
"parentSlotTypeSignature": null,
"valueSelectionSetting": null,
"externalSourceSetting": {
"grammarSlotTypeSetting": {
"source": {
"kmsKeyArn": "arn:aws:kms:Region:123456789012:alias/customer-grxml-key",
"s3BucketName": "grxml-test",
"s3ObjectKey": "grxml_files/grammar.grxml"
}
}
}
}
```
## Struktur der benutzerdefinierten Vokabeldatei
Die benutzerdefinierte Vokabeldatei enthält die Einträge in einem benutzerdefinierten Vokabular für eine einzelne Sprache oder ein bestimmtes Gebietsschema. Die ZIP-Datei enthält eine benutzerdefinierte Vokabeldatei für jedes Gebietsschema, das über ein benutzerdefiniertes Vokabular verfügt.
Im Folgenden finden Sie eine benutzerdefinierte Vokabeldatei für einen Bot, der Restaurantbestellungen entgegennimmt. Es gibt eine Datei pro Gebietsschema im Bot.
```
{
"customVocabularyItems": [
{
"weight": 3,
"phrase": "wafers"
},
{
"weight": null,
"phrase": "extra large"
},
{
"weight": null,
"phrase": "cremini mushroom soup"
},
{
"weight": null,
"phrase": "ramen"
},
{
"weight": null,
"phrase": "orzo"
}
]
}
```