サポート終了通知: 2025 年 9 月 15 日、 AWS は Amazon Lex V1 のサポートを終了します。 V1 2025 年 9 月 15 日を過ぎると、Amazon Lex V1 コンソールまたは Amazon Lex V1 リソースにはアクセスできなくなります。Amazon Lex V2 を使用している場合は、代わりに [Amazon Lex V2 ガイド](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Lex 形式でのインポートとエクスポート
後に Amazon Lex に再インポートするために Amazon Lex からボット、インテント、スロットタイプをエクスポートするには、Amazon Lex 形式で JSON ファイルを作成します。このファイルではリソースを編集でき、Amazon Lex に再インポートできます。例えば、インテントに発話を追加し、変更したインテントをアカウントに再インポートできます。また、JSON 形式を使用してリソースを共有することもできます。例えば、1 つの AWS リージョンからボットをエクスポートして、別のリージョンにインポートできます。または、同僚に JSON ファイルを送信してボットを共有できます。
**Topics**
+ [
# Amazon Lex 形式でエクスポートする
](export-to-lex.md)
+ [
# Amazon Lex 形式でインポートする
](import-from-lex.md)
+ [
# インポートとエクスポートにおける JSON 形式
](import-export-format.md)
# Amazon Lex 形式でエクスポートする
Amazon Lex ボット、インテント、スロットタイプを、 AWS アカウントにインポートできる形式にエクスポートします。次のリソースをエクスポートできます。
+ ボットに使用されるすべてのインテントおよびカスタムスロットを含むボット
+ インテントに使用されるすべてのインテントおよびカスタムスロットを含むインテント
+ そのスロットタイプのすべての値を含むカスタムスロットタイプ
番号付きのバージョンのリソースのみをエクスポートできます。リソースの `$LATEST` バージョンをエクスポートすることはできません。
エクスポートは非同期プロセスです。エクスポートが完了すると、Amazon S3 の署名付き URL を取得します。この URL は、エクスポートされた JSON 形式のリソースが含まれる .zip アーカイブの場所を示します。
ボット、インテント、カスタムスロットタイプをエクスポートするには、コンソールあるいは [GetExport](API_GetExport.md) オペレーションを使用します。
ボット、インテント、あるいはスロットタイプをエクスポートする手順は同じです。次の手順で、インテントあるいはスロットタイプをボットに置き換えます。
## ボットをエクスポートする
**ボットをエクスポートするには**
1. AWS マネジメントコンソールにサインインし、Amazon Lex コンソール ([https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)) を開きます。
1. [**ボット**] を選択し、エクスポートする 1 つのボットを選びます。
1. [**アクション**] メニューで、[**エクスポート**] を選択します。
1. [**Export Bot**] (ボットのエクスポート) ダイアログで、エクスポートするボットのバージョンを選択します。[**プラットフォーム**] で [**Amazon Lex**] を選択します。
1. **[エクスポート]** を選択します。
1. .zip アーカイブをダウンロードして保存します。
Amazon Lex は、.zip アーカイブに含まれる JSON ファイルにボットをエクスポートします。ボットを更新するには、JSON テキストを変更し、それを Amazon Lex に再インポートします。
**次のステップ**
[Amazon Lex 形式でインポートする](import-from-lex.md)
# Amazon Lex 形式でインポートする
Amazon Lex 形式の JSON ファイルにリソースをエクスポートしたら、リソースを含む JSON ファイルを 1 つ以上の AWS アカウントにインポートできます。例えば、ボットをエクスポートして、別の AWS リージョンにインポートできます。または、ボットを同僚に送信して、この同僚が自身のアカウントにボットをインポートすることもできます。
ボット、インテントあるいはスロットタイプをインポートするとき、インテントやスロットタイプなどの `$LATEST` バージョンをインポート中に上書きするか、またはアカウント内のリソースを維持するためにこのインポートを失敗するようにするかを決定する必要があります。例えば、編集されたバージョンのリソースをアカウントにアップロードする場合、`$LATEST` バージョンを上書きするかどうかを選択します。同僚から送信されたリソースをアップロードする場合、自身のリソースが置き換えられないために、リソース間に競合が発生した場合にこのインポートを失敗するように選択できます。
リソースをインポートするとき、インポートを実行するユーザーに割り当てられたアクセス許可から適用がリクエストされます。このユーザーは、アカウント内でこのインポートが影響するすべてのリソースに対してアクセス許可を有している必要があります。また、このユーザーは、[GetBot](API_GetBot.md)、[PutBot](API_PutBot.md)、[GetIntent](API_GetIntent.md)、[PutIntent](API_PutIntent.md)、[GetSlotType](API_GetSlotType.md)、[PutSlotType](API_PutSlotType.md) オペレーションへのアクセス許可も有している必要があります。権限の詳細については、「[Amazon Lex で IAM を使用する方法](security_iam_service-with-iam.md)」を参照してください。
インポートは、処理中に発生したエラーを報告します。一部のエラーはインポートが開始する前に報告され、その他はインポート処理中に報告されます。例えば、インテントが使用する Lambda 関数を呼び出すアクセス許可がないインテントをアカウントでインポートする場合、このインポートはスロットタイプあるいはインテントが変更される前に失敗します。インポート処理中にインポートに失敗した場合、この処理が失敗する前にインポートされたすべてのインテントあるいはスロットタイプの `$LATEST` バージョンは変更されます。`$LATEST` バージョンに加えられた変更をロールバックすることはできません。
リソースをインポートする場合、すべての依存するリソースはリソースの `$LATEST` バージョンにインポートされ、番号付きバージョンを付与されます。例えば、ボットがインテントを使用する場合、このインテントには番号付きバージョンが付与されます。インテントはカスタムスロットタイプを使用する場合、このスロットタイプには番号付きバージョンが付与されます。
1 つのリソースは 1 度のみインポートされます。例えば、ボットに `OrderPizza` インテントおよび `OrderDrink` インテントが含まれ、どちらのインテントもカスタムスロットタイプ `Size` に依存している場合、`Size` スロットタイプは 1 度のみインポートされ、両方のインテントに使用されます。
**注記**
ボットをでエクスポートした場合 `enableModelImprovements` パラメータをに設定します。`false` では、ボット定義を含む.zip ファイルを開き、`enableModelImprovements` パラメータを `true` は以下のリージョンで指定します。
アジアパシフィック (シンガポール) (ap-southeast-1)
アジアパシフィック (東京) (ap-northeast-1)
欧州 (フランクフルト) (eu-central-1)
欧州 (ロンドン) (eu-west-2)
ボット、インテント、あるいはカスタムスロットタイプをインポートする手順は同じです。次の手順で、インテントあるいはスロットタイプを適当に置き換えます。
## ボットのインポート
**ボットをインポートするには**
1. AWS マネジメントコンソールにサインインし、Amazon Lex コンソール ([https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)) を開きます。
1. [**ボット**] を選択し、インポートする 1 つのボットを選びます。新規のボットをインポートする場合、このステップはスキップします。
1. [**アクション**] で、[**インポート**] を選択します。
1. [**Import Bot**] (ボットのインポート) で、インポートするボットが含まれる JSON ファイルがある .zip アーカイブを選択します。マージする前にマージ競合を表示するには、[**Notify me of merge conflicts**] (マージ競合を通知) を選択します。競合チェックをオフにした場合、ボットが使用するすべてのリソースの `$LATEST` バージョンは上書きされます。
1. [**インポート**] を選択します。マージ競合の通知を選択し、競合が発生した場合、この競合の一覧を示すダイアログが表示されます。競合するすべてのリソースの `$LATEST` バージョンを上書きするには、[**Overwrite and continue (上書きして続ける)**] を選択します。インポートを停止するには、[**キャンセル**] を選択します。
これで、アカウントでボットをテストできるようになります。
# インポートとエクスポートにおける JSON 形式
次の例では、スロットタイプ、インテントおよびボットを Amazon Lex 形式でエクスポート、インポートする JSON 構造を示しています。
## スロットタイプ構造
カスタムスロットタイプの JSON 構造を以下に示します。スロットタイプをインポートあるいはエクスポートする場合、またカスタムスロットタイプに依存するインテントをエクスポートする場合にこの構造を使用します。
```
{
"metadata": {
"schemaVersion": "1.0",
"importType": "LEX",
"importFormat": "JSON"
},
"resource": {
"name": "slot type name",
"version": "version number",
"enumerationValues": [
{
"value": "enumeration value",
"synonyms": []
},
{
"value": "enumeration value",
"synonyms": []
}
],
"valueSelectionStrategy": "ORIGINAL_VALUE or TOP_RESOLUTION"
}
}
```
## インテントの構造
次に、インテントの JSON 構造を示します。インテントおよびインテントに依存するボットをインポート、エクスポートする場合にこの構造を使用します。
## ボット構造
次に、ボットの JSON 構造を示します。ボットをインポートまたはエクスポートするときにこの構造を使用します。