支援終止通知：2025 年 9 月 15 日， AWS 將停止對 Amazon Lex 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 機器人、意圖和槽類型
您可以匯入或匯出機器人、意圖或參數槽類型。例如，如果您想要與其他 AWS 帳戶中的同事分享機器人，可以匯出該機器人，然後再將其傳送給該同事。如果您想要將多個表達用語新增到機器人，可以先匯出該機器人，新增表達用語後，再將該機器人匯回至您的帳戶。
您可以*匯出* Amazon Lex （共用或修改它們） 或 Alexa 技能格式的機器人、意圖和槽類型。您只能以 Amazon Lex 格式*匯入*。
匯出資源時，您必須以與您匯出至 Amazon Lex 或 Alexa Skills Kit 的服務相容的格式匯出資源。如果您以 Amazon Lex 格式匯出機器人，可以將該機器人重新匯入至您的帳戶，或者另一個帳戶中的 Amazon Lex 使用者也可以將其匯入至自己的帳戶。您也可以使用與 Alexa 技能相容的格式，匯出機器人。然後，可以用 Alexa Skills Kit 匯入機器人，供 Alexa 使用。如需詳細資訊，請參閱[匯出至 Alexa 技能](export-to-alexa.md)。
當您匯出機器人、意圖或參數槽類型時，其資源會寫入 JSON 檔案。若要匯出機器人、意圖或槽類型，您可以使用 Amazon Lex 主控台或 [GetExport](API_GetExport.md)操作。請使用 [StartImport](API_StartImport.md) 匯入機器人、意圖或參數槽類型。
**Topics**
+ [以 Amazon Lex 格式匯出和匯入](import-export-lex.md)
+ [匯出至 Alexa 技能](export-to-alexa.md)
# 以 Amazon Lex 格式匯出和匯入
若要從 Amazon Lex 匯出機器人、意圖和槽類型，以便重新匯入 Amazon Lex，您可以使用 Amazon Lex 格式的建立 JSON 檔案。您可以編輯此檔案中的資源，並將其匯入 Amazon Lex。例如，您可以將表達用語新增到意圖，再將變更後的意圖匯回至您的帳戶。您也可以使用 JSON 格式來分享資源。例如，您可以從一個 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 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 選擇 **Bots** (機器人)，然後選擇要匯出的機器人。
1. 在 **Actions** (動作) 功能表上，選擇 **Export** (匯出)。
1. 在 **Export Bot** (匯出機器人) 對話方塊中，選擇要匯出的機器人版本。為 **Platform** (平台) 選擇 **Amazon Lex**。
1. 選擇 **Export** (匯出)。
1. 下載並儲存 .zip 封存檔。
Amazon Lex 會將機器人匯出至 .zip 封存檔中包含的 JSON 檔案。若要更新機器人，請修改 JSON 文字，然後將其匯入回 Amazon Lex。
**下一步驟**
[以 Amazon Lex 格式匯入](import-from-lex.md)
# 以 Amazon Lex 格式匯入
將資源匯出至 Amazon Lex 格式的 JSON 檔案後，您可以將包含資源的 JSON 檔案匯入一或多個 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` 版本的資源，然後為其提供一個版本編號。例如，如果機器人使用意圖，就會為該意圖提供一個版本編號。如果意圖使用自訂參數槽類型，就會為該參數槽類型提供一個版本編號。
資源只會匯入一次。例如，如果機器人包含 `OrderPizza` 意圖與 `OrderDrink` 意圖，且兩者皆仰賴自訂的參數槽類型 `Size`，則只會匯入一次該 `Size` 參數槽類型，而同時用於這兩項意圖。
**注意**
如果您將 機器人的 `enableModelImprovements` 參數設定為 `false`，則必須開啟包含機器人定義的 .zip 檔案，並將 `enableModelImprovements` 參數變更為`true`下列區域中的 ：
亞太地區 (新加坡) (ap-southeast-1)
亞太地區 (東京) (ap-northeast-1)
歐洲 (法蘭克福) (eu-central-1)
歐洲 (倫敦) (eu-west-2)
匯入機器人、意圖或參數槽類型的程序皆相同。您只需在下列程序中適當地替換掉意圖或參數槽類型即可。
## 匯入機器人
**匯入機器人**
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。
1. 選擇 **Bots** (機器人)，然後選擇要匯入的機器人。若要匯入新的機器人，請跳過此步驟。
1. 為 **Actions** (動作) 選擇 **Import** (匯入)。
1. 為 **Import Bot** (匯入機器人) 選擇.zip 封存檔，其內應有包含要匯入之機器人的 JSON 檔案。如果您要在合併前先查看合併衝突，請選擇 **Notify me of merge conflicts** (出現合併衝突請通知我)。如果您關閉了衝突檢查，就會覆寫機器人使用之 `$LATEST` 版本的所有資源。
1. 選擇**匯入**。如果您已選擇在發生合併衝突時通知您，則在發生衝突時，就會出現列有這些衝突的對話方塊。若要覆寫 `$LATEST` 版本之所有衝突的資源，請選擇 **Overwrite and continue (覆寫並繼續)**。若要停止匯入，請選擇 **Cancel** (取消)。
現在即已可在帳戶中測試機器人。
# 匯入及匯出的 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 結構。當您匯入或匯出機器人時，請使用此結構。
# 匯出至 Alexa 技能
您可以使用與 Alexa 技術相容的格式匯出機器人結構描述。當您將機器人匯出成 JSON 檔案後，請使用技能建置器將其上傳至 Alexa。
**匯出機器人及其結構描述 (互動模型)**
1. 登入 AWS 管理主控台 ，並在 [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)：// 開啟 Amazon Lex 主控台。
1. 選擇您想要匯出的機器人。
1. 為 **Actions** (動作) 選擇 **Export** (匯出)。
1. 選擇要匯出之機器人的版本。為格式選擇 **Alexa Skills Kit**，然後選擇 **Export** (匯出)。
1. 出現下載對話方塊時，請選擇檔案的儲存位置，然後選擇 **Save (儲存)**。
下載的檔案是 .zip 封存檔，內含一個以匯出機器人命名的檔案。它包含將機器人匯出為 Alexa 技能所需的資訊。
**注意**
Amazon Lex 和 Alexa Skills Kit 有下列不同：
Alexa Skills Kit 不支援工作階段屬性，以方括號 ([]) 表示。您需要更新使用工作階段屬性的提示。
Alexa Skills Kit 不支援標點符號。您需要更新使用標點符號的表達用語。
**將機器人上傳至 Alexa 技能**
1. 在 [ https://developer.amazon.com/](https://developer.amazon.com/edw/home.html#/) 登入開發人員入口網站。
1. 在 **Alexa Skills (Alexa 技能)** 頁面，選擇 **Create Skill (建立技能)**。
1. 在 **Create a new skill (建立新的技能)** 頁面，輸入技能名稱和該技能的預設語言。請確定已為技能模型選取 **Custom (自訂)**，然後選擇 **Create skill (建立技能)**。
1. 請確定已選取 **Start from scratch (從頭開始)** 並選擇 **Choose (選擇)**。
1. 在左側功能表中，選擇 **JSON Editor (JSON 編輯器)**。將您從 Amazon Lex 匯出的 JSON 檔案拖曳至 JSON 編輯器。
1. 選擇 **Save Model (儲存模型)** 以儲存您的互動模式。
將結構描述上傳至 Alexa 技能後，使用 Alexa 進行執行技能的必要變更。如需有關建立 Alexa 技能的詳細資訊，請參閱 [Alexa Skills Kit](https://developer.amazon.com/public/solutions/alexa/alexa-skills-kit/docs/ask-define-the-vui-with-gui) 中的*使用技能產生器 (Beta 版)*。