本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 為您的生產環境從 Lex V2 部署機器人 建立和測試您的機器人之後，即可部署以與客戶互動。在本節中，了解如何在進行更新時建立機器人的*版本*。使用*別名*在機器人準備好進行部署時指向不同的版本。了解如何將機器人與簡訊平台、行動應用程式和網站整合。 **Topics** + [ # 使用 Lex V2 機器人進行版本控制和別名 ](versions-aliases.md) + [ # 使用 Java 應用程式與 Amazon Lex V2 機器人互動 ](deploy-java.md) + [ # 使用全域彈性將機器人部署到其他區域 ](global-resiliency.md) + [ # 將 Amazon Lex V2 機器人與簡訊平台整合 ](deploying-messaging-platform.md) + [ # 將 Amazon Lex V2 機器人與聯絡中心整合 ](contact-center.md) # 使用 Lex V2 機器人進行版本控制和別名 Amazon Lex V2 支援建立機器人和機器人網路的版本和別名，讓您可以控制用戶端應用程式使用的實作。版本做為您工作的編號快照。您可以將別名指向您想要提供給客戶的機器人版本。在建立版本之間，您可以繼續更新機器人的`Draft`版本，而不會影響使用者體驗。 ## 版本 Amazon Lex V2 支援建立機器人版本，讓您可以控制用戶端應用程式使用的實作。*版本*是工作的編號快照，您可以建立用於工作流程的不同部分，例如開發、Beta 部署和生產。 ### Lex V2 機器人的草稿版本 當您建立 Amazon Lex V2 機器人時，只有一個版本，即 `Draft`版本。 `Draft` 是機器人的運作副本。您只能更新 `Draft`版本，直到您建立第一個版本為止， `Draft`是您擁有的唯一機器人版本。 機器人的`Draft`版本與 相關聯`TestBotAlias`。`TestBotAlias` 應僅用於手動測試。Amazon Lex V2 `TestBotAlias` 會限制您可以對機器人別名提出的執行時間請求數量。 ### 為您的 Lex V2 機器人建立版本 當您為 Amazon Lex V2 機器人建立版本時，您可以建立機器人的編號快照，以便在版本建立時使用該機器人。建立數值版本後，它將保持不變，同時繼續處理應用程式的草稿版本。 建立版本時，您可以選擇要包含在版本中的地區設定。您不需要選擇機器人中的所有地區設定。此外，當您建立版本時，您可以從先前的版本中選擇地區設定。例如，如果您有三個版本的機器人，您可以在建立第 4 版時，從 `Draft`版本選擇一個地區設定，從第 2 版選擇一個地區設定。 如果您從`Draft`版本中刪除地區設定，則不會從編號的版本中刪除該地區設定。 如果機器人版本未使用六個月，Amazon Lex V2 會將版本標記為非作用中。當版本處於非作用中狀態時，您無法搭配機器人使用執行時間操作。若要讓機器人處於作用中狀態，請重建與該版本相關聯的所有語言。 ### 更新 Amazon Lex V2 機器人 您只能更新 Amazon Lex V2 機器人的`Draft`版本。版本無法變更。您可以在更新主控台中的資源或使用 [CreateBotVersion](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotVersion.html) 操作之後，隨時建立新的版本。 ### 刪除 Amazon Lex V2 機器人或版本 Amazon Lex V2 支援使用主控台或其中一個 API 操作刪除機器人或版本： + [DeleteBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteBot.html) + [DeleteBotVersion](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteBotVersion.html) ## Lex V2 機器人的別名 Amazon Lex V2 機器人支援別名。*別名*是特定機器人版本的指標。透過別名，您可以輕鬆地更新用戶端應用程式所使用的版本。例如，您可以將別名指向版本 1 的機器人。當您準備好要更新機器人時，即可建立版本 2 並將別名變更為指向新的版本。由於您的應用程式是使用別名而非特定版本，所有您的用戶端皆無需進行更新便能獲得新功能。 別名是 Amazon Lex V2 機器人特定版本的指標。利用別名以讓用戶端應用程式能夠使用特定版本的機器人，而無需由應用程式追蹤其為哪個版本。 當您建立機器人時，Amazon Lex V2 會建立名為 的別名`TestBotAlias`，可用來測試機器人。`TestBotAlias` 別名一律與您的機器人`Draft`版本相關聯。您應該僅使用`TestBotAlias`別名進行測試，Amazon Lex V2 會限制您可以對別名提出的執行時間請求數量。 下列範例顯示 Amazon Lex V2 機器人的兩個版本，版本 1 和版本 2。這兩個機器人版本各有其相關聯的別名，分別為 BETA 和 PROD。用戶端應用程式使用 PROD 別名存取機器人。 ![\[Point a client application to a version by using an alias.\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/lex-publish-alias-bot.png) 當您建立機器人的第二個版本時，您可以使用 主控台或 [UpdateBotAlias](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateBotAlias.html) 操作來更新別名，以指向機器人的新版本。一旦您變更別名，所有您的用戶端應用程式都將使用新版本。如果新版本發生問題，您只需要將別名變更為指向前一個版本即可還原回該版本。 ![\[Updating an alias changes the version used by client applications.\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/lex-publish-alias-bot-v2.png) 當您設定用戶端應用程式呼叫 [Amazon Lex 執行期 V2](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_Operations_Amazon_Lex_Runtime_V2.html) APIs，讓客戶與您的機器人互動時，您可以使用指向您希望客戶使用的版本的別名。 **注意** 雖然您可以在 主控台中測試機器人的`Draft`版本，但我們建議您在將機器人與用戶端應用程式整合時，先建立版本並建立指向該版本的別名。如存在本節所述原因，請在您的用戶端應用程式中使用別名。當您更新別名時，Amazon Lex V2 會將目前版本用於所有進行中工作階段。新工作階段使用新版本。 # 使用 Java 應用程式與 Amazon Lex V2 機器人互動 [適用於 Java 的 AWS SDK 2.0 ](https://github.com/aws/aws-sdk-java-v2)提供您可以從 Java 應用程式用來與機器人互動的界面。使用適用於 Java 的 SDK 為使用者建置用戶端應用程式。 下列應用程式會與您在 中建立的 OrderFlowers 機器人互動[練習 1：從範本建立聊天機器人](exercise-1.md)。它使用`LexRuntimeV2Client`適用於 Java 的 開發套件的 來呼叫 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 操作，以與機器人進行對話。 對話的輸出如下所示： ``` User : I would like to order flowers Bot : What type of flowers would you like to order? User : 1 dozen roses Bot : What day do you want the dozen roses to be picked up? User : Next Monday Bot : At what time do you want the dozen roses to be picked up? User : 5 in the evening Bot : Okay, your dozen roses will be ready for pickup by 17:00 on 2021-01-04. Does this sound okay? User : Yes Bot : Thanks. ``` 如需用戶端應用程式與 Amazon Lex V2 機器人之間傳送的 JSON 結構，請參閱 [練習 2：檢閱對話流程](exercise-2.md)。 若要執行應用程式，您必須提供下列資訊： + botId – 建立機器人時指派給機器人的識別符。您可以在機器人**設定**頁面的 Amazon Lex V2 主控台中查看機器人 ID。 + botAliasId – 建立機器人別名時指派給機器人別名的識別符。您可以在別名頁面的 Amazon Lex V2 ****主控台中查看機器人別名 ID。如果您在清單中看不到別名 ID，請選擇右上角的齒輪圖示，然後開啟**別名 ID**。 + localeId – 您用於機器人之地區設定的識別符。如需地區設定清單，請參閱 [Amazon Lex V2 支援的語言和地區設定](how-languages.md)。 + accessKey 和 secretKey – 您帳戶的身分驗證金鑰。如果您沒有一組金鑰，請使用 AWS Identity and Access Management 主控台建立它們。 + sessionId – Amazon Lex V2 機器人工作階段的識別符。在此情況下，程式碼會使用隨機 UUID。 + region – 如果您的機器人不在美國東部 （維吉尼亞北部） 區域，請務必變更區域。 應用程式使用名為 的函數`getRecognizeTextRequest`來建立對機器人的個別請求。函數會建置一個請求，其中包含要傳送至 Amazon Lex V2 的必要參數。 ``` package com.lex.recognizetext.sample; import software.amazon.awssdk.auth.credentials.AwsBasicCredentials; import software.amazon.awssdk.auth.credentials.AwsCredentialsProvider; import software.amazon.awssdk.auth.credentials.StaticCredentialsProvider; import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.lexruntimev2.LexRuntimeV2Client; import software.amazon.awssdk.services.lexruntimev2.model.RecognizeTextRequest; import software.amazon.awssdk.services.lexruntimev2.model.RecognizeTextResponse; import java.net.URISyntaxException; import java.util.UUID; /** * This is a sample application to interact with a bot using RecognizeText API. */ public class OrderFlowersSampleApplication { public static void main(String[] args) throws URISyntaxException, InterruptedException { String botId = ""; String botAliasId = ""; String localeId = "en_US"; String accessKey = ""; String secretKey = ""; String sessionId = UUID.randomUUID().toString(); Region region = Region.US_EAST_1; // pick an appropriate region AwsBasicCredentials awsCreds = AwsBasicCredentials.create(accessKey, secretKey); AwsCredentialsProvider awsCredentialsProvider = StaticCredentialsProvider.create(awsCreds); LexRuntimeV2Client lexV2Client = LexRuntimeV2Client .builder() .credentialsProvider(awsCredentialsProvider) .region(region) .build(); // utterance 1 String userInput = "I would like to order flowers"; RecognizeTextRequest recognizeTextRequest = getRecognizeTextRequest(botId, botAliasId, localeId, sessionId, userInput); RecognizeTextResponse recognizeTextResponse = lexV2Client.recognizeText(recognizeTextRequest); System.out.println("User : " + userInput); recognizeTextResponse.messages().forEach(message -> { System.out.println("Bot : " + message.content()); }); // utterance 2 userInput = "1 dozen roses"; recognizeTextRequest = getRecognizeTextRequest(botId, botAliasId, localeId, sessionId, userInput); recognizeTextResponse = lexV2Client.recognizeText(recognizeTextRequest); System.out.println("User : " + userInput); recognizeTextResponse.messages().forEach(message -> { System.out.println("Bot : " + message.content()); }); // utterance 3 userInput = "next monday"; recognizeTextRequest = getRecognizeTextRequest(botId, botAliasId, localeId, sessionId, userInput); recognizeTextResponse = lexV2Client.recognizeText(recognizeTextRequest); System.out.println("User : " + userInput); recognizeTextResponse.messages().forEach(message -> { System.out.println("Bot : " + message.content()); }); // utterance 4 userInput = "5 in evening"; recognizeTextRequest = getRecognizeTextRequest(botId, botAliasId, localeId, sessionId, userInput); recognizeTextResponse = lexV2Client.recognizeText(recognizeTextRequest); System.out.println("User : " + userInput); recognizeTextResponse.messages().forEach(message -> { System.out.println("Bot : " + message.content()); }); // utterance 5 userInput = "Yes"; recognizeTextRequest = getRecognizeTextRequest(botId, botAliasId, localeId, sessionId, userInput); recognizeTextResponse = lexV2Client.recognizeText(recognizeTextRequest); System.out.println("User : " + userInput); recognizeTextResponse.messages().forEach(message -> { System.out.println("Bot : " + message.content()); }); } private static RecognizeTextRequest getRecognizeTextRequest(String botId, String botAliasId, String localeId, String sessionId, String userInput) { RecognizeTextRequest recognizeTextRequest = RecognizeTextRequest.builder() .botAliasId(botAliasId) .botId(botId) .localeId(localeId) .sessionId(sessionId) .text(userInput) .build(); return recognizeTextRequest; } } ``` # 使用全域彈性將機器人部署到其他區域 全域彈性可讓您在次要區域中複寫機器人。次要區域可以透過在兩個區域中自動複寫使用者的機器人來啟用。如果發生區域中斷，您將有一個備份區域。全域彈性啟用後，會在第二個 AWS 區域中複寫建立的新機器人。 **注意** 此功能僅適用於在美國東部 （維吉尼亞北部） 和美國西部 （奧勒岡） 區域，以及歐洲西部 （倫敦） 和歐洲中部 （法蘭克福） 區域中建立的 Amazon Connect 和 Amazon Lex V2 執行個體。 若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。 啟用此功能後，您可以近乎即時地跨配對的 AWS 區域自動複寫 Amazon Lex V2 機器人及其資源、版本和別名。透過此功能，您可以監控原始和複本機器人的版本編號，以確保機器人複本與原始機器人保持同步。啟用複寫時，您可以啟用您希望在其中複寫機器人的預先決定 AWS 區域 （區域是以預先決定的配對為基礎）。來源區域中來源機器人的任何更新都會自動更新為第二個區域中複寫的機器人。 **注意** 當機器人啟用全域彈性時，所有現有的別名及其相關聯的版本都會在複本區域中複寫。啟用複寫之前未與別名相關聯的版本會在與別名建立關聯時複寫。啟用複寫後建立的每個版本和別名都會自動複寫。使用者可以使用 `ListBotVersionReplicas`和 `ListBotAliasReplicas`來檢閱每個個別版本和別名的複寫狀態。機器人變動是從機器人到其複本的單向變動。使用者無法修改複本機器人，因為它始終與機器人保持同步。 有關使用全域彈性的其他資訊： + 全域彈性目前僅適用於預先決定的區域對。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/global-resiliency.html) + 當機器人啟用全域彈性時，所有現有的別名及其相關聯的版本都會在複本區域中複寫。在啟用複寫之前未與別名相關聯的版本，會在與別名建立關聯時複寫。啟用複寫後建立的每個版本和別名都會自動複寫。使用者可以使用 `ListBotVersionReplicas`和 `ListBotAliasReplicas` 來了解每個個別版本和別名的複寫狀態。機器人變動是從機器人到其複本的單向變動。使用者無法修改複本機器人，因為它始終與機器人保持同步。 + 任何別名都可以與任何版本相關聯。如果版本尚未複寫，則會在與別名的關聯期間複寫。 限制: + 全域彈性不會複寫使用 LLM 所建立的機器人，例如 CFAQ 和差異產生。 + 全域彈性不會複寫機器人網路，但屬於機器人網路的任何機器人仍然可以個別複寫。 **Topics** + [ # 在 Lex V2 中複寫機器人和管理機器人複本的許可 ](gr-permissions.md) + [ # 使用 Lex V2 機器人部署全域彈性 ](navigation-gr.md) # 在 Lex V2 中複寫機器人和管理機器人複本的許可 如果 IAM 角色已連接 [AmazonLexFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonLexFullAccess) 政策，則可以建立和管理機器人複本。 如果您偏好建立具有最低全域恢復許可的角色，請使用下列政策，其中包含下列陳述式。 + 存取 Amazon Lex V2 [服務連結角色以進行機器人複寫](using-service-linked-roles.md#slr-replication)的許可。 + 允許 Amazon Lex V2 [代表您建立機器人複寫服務連結角色的](using-service-linked-roles.md#slr-replication)許可。 + 呼叫機器人複寫 APIs許可。 您可以修改許可，進一步限制許可，如下所示。 + 將 *\$1* 取代為特定機器人或機器人別名 IDs，以限制特定機器人或機器人別名的許可。 + 使用動作的子集`lex BotReplica`，將角色限制為特定動作。 如需範例，請參閱 [允許使用者建立和檢視機器人複本，但不能刪除它們](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-gr-permissions)。 # 使用 Lex V2 機器人部署全域彈性 全域彈性可讓您在次要區域中複寫機器人。次要區域可以透過在兩個區域中自動複寫使用者的機器人來啟用。如果發生區域中斷，您將有一個備份區域。全域彈性啟用後，會在第二個 AWS 區域中複寫建立的新機器人。 ## 全域彈性資訊面板會顯示部署的詳細資訊 您可以在全球彈性面板中存取下列資訊： + **來源詳細資訊** – 有關機器人來源區域、複本類型、複寫啟用日期和上次建立版本的資訊。使用此資訊來追蹤機器人的反覆運算。 + **複寫詳細資訊** – 建立機器人複本後，您可以追蹤複寫的區域、複本類型、最後一個版本同步日期和最後一個複寫版本。使用此資訊來追蹤機器人複本的同步。 + **來源區域** – 啟用全域彈性的區域。您可以在來源區域中進行變更，以在這兩個區域中複寫機器人。 + **複本類型** – 指出機器人是唯讀還是能夠根據區域讀取和寫入。 + **複本區域** – 用於複寫您的來源機器人以進行全域恢復的次要區域。全域彈性目前僅適用於 IAD/PDX 和 LDN/FRA 區域配對。 + **啟用複寫的日期** – 啟用機器人複本的日期和時間。 + **上次建立的版本** – 與來源區域中複本相關聯的最後一個機器人版本。 ## 為您的 Lex V2 機器人啟用全域彈性 在 Amazon Lex V2 主控台中啟用全域彈性之前，您必須確保啟用機器人複寫的使用者具有建立服務連結角色 (SLR) 的許可。調用 CreateReplica 時，全域彈性將使用這些 FAS 登入資料在已啟用的帳戶中建立 SLR。如需在 Amazon Lex V2 中設定全域彈性 SLR 的詳細資訊，請參閱 [AWS 受管政策：AmazonLexFullAccess](https://docs.aws.amazon.com/lexv2/latest/dg/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonLexFullAccess)。 **注意** 此功能僅適用於在美國東部 （維吉尼亞北部） 和美國西部 （奧勒岡） 區域，以及歐洲西部 （倫敦） 和歐洲中部 （法蘭克福） 區域中建立的 Amazon Connect 和 Amazon Lex V2 執行個體。 若要存取此功能，請聯絡您的 Amazon Connect 解決方案架構師或技術客戶經理。 啟用全域彈性並設定第二個區域的機器人複寫： 1. 登入 AWS 管理主控台，並在 https：/[/https://console.aws.amazon.com/lex/](https://console---aws.amazon.com.rproxy.govskope.uslex/) 開啟 Amazon Lex 主控台。 1. 從左側導覽面板的機器人導覽中選擇您要複寫的機器人。 1. 選擇部署 > 全域彈性。 1. 選取視窗右上角的**建立複本**按鈕，以建立機器人的草稿版本。 **注意** 檢查以確定次要區域中沒有任何機器人與您要複寫的機器人名稱相同。（您的機器人必須唯一命名）。 1. 移至**全域彈性**，按一下**建立複本** - 此動作會建立機器人的草稿版本。 （除了檢閱狀態或查看未來建置的詳細資訊之外，您不需要返回全域彈性索引標籤）。 **注意** 您也可以前往別名，然後選取為啟用全域恢復的機器人**建立新別名**，以在全域恢復中建立複寫的別名機器人。即使已在啟用複寫之前建立，也會複寫所有別名。 1. 前往**別名** - 為啟用全域彈性的機器人**建立新的別名**。所有別名都會複寫，即使它們是在啟用複寫之前建立。 1. 移至**版本** - **為啟用全域彈性的機器人建立新版本**。任何與別名相關聯的版本都會複寫，即使是在啟用複寫之前建立的。 **注意** 客戶仍然可以完全控制管理其複寫機器人的資源型政策和標籤。Lambda 函數和 CloudWatch Logs 群組將需要部署在具有相同識別符的兩個區域中。使用者不必在複本區域中再次關聯 lambda 函數。 ## 停用全域彈性 您可以隨時選取停用全域彈性按鈕來**停用全域彈性**。此動作會停止在其他區域中複寫來源機器人及其相關聯的任何別名和版本。 ## 使用 APIs搭配 Lex V2 機器人的全域彈性 您可以使用下列 API 在全域彈性中進行 APIs 呼叫。如需有關全域彈性 APIs 和 Amazon Lex V2 的其他資訊，請參閱 [Amazon Lex V2 API 指南](https://docs.aws.amazon.com/lexv2/latest/dg/api_ref.html)。 + **CreateBotReplica** 啟用全域彈性並建立複寫的機器人。需要 `replicaRegion`。 如需詳細資訊，請參閱《Amazon Lex V2 API 指南》中的 [CreateBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotReplica.html)。 + **DeleteBotReplica** 停用全域彈性並刪除複寫的機器人。需要 `replicaRegion` 和 `botId`。 如需詳細資訊，請參閱《Amazon Lex V2 API 指南》中的 [DeleteBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteBotReplica.html)。 + **ListBotReplicas** 列出次要區域中的複寫機器人。需要 `botId`。 如需詳細資訊，請參閱《Amazon Lex V2 API 指南》中的 [ListBotReplicas](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotReplicas.html)。 + **DescribeBotReplica** 複寫機器人的資訊摘要。需要 `replicaRegion` 和 `botId`。 如需詳細資訊，請參閱《Amazon Lex V2 API 指南》中的 [DescribeBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotReplica.html)。 # 將 Amazon Lex V2 機器人與簡訊平台整合 本節說明如何將 Amazon Lex V2 機器人與 Facebook、Slack 和 Twilio 訊息平台整合。如果您還沒有 Amazon Lex V2 機器人，請建立一個。在本主題中，我們假設您使用的是您在 中建立的機器人[練習 1：從範本建立聊天機器人](exercise-1.md)。不過，您可以使用任何機器人。 **注意** 儲存 Facebook、Slack 或 Twilio 組態時，Amazon Lex V2 會使用 AWS KMS key 來加密資訊。第一次建立其中一個簡訊平台的頻道時，Amazon Lex V2 會在您的 AWS 帳戶中建立預設客戶受管金鑰 (`aws/lex`)，您也可以選取自己的客戶受管金鑰。Amazon Lex V2 僅支援對稱金鑰。如需詳細資訊，請參閱《AWS Key Management Service 開發人員指南》[https://docs.aws.amazon.com/kms/latest/developerguide/](https://docs.aws.amazon.com/kms/latest/developerguide/)。 當訊息平台將請求傳送至 Amazon Lex V2 時，它會包含平台特定資訊，做為 Lambda 函數的請求屬性。使用此屬性來自訂機器人的行為方式。如需詳細資訊，請參閱[設定 Lex V2 機器人的請求屬性](context-mgmt-request-attribs.md)。 **訊息平台的常見請求屬性** | 屬性 | Description | | --- | --- | | x-amz-lex：channels：platform | 下列其中一值： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/deploying-messaging-platform.html) | # 將 Amazon Lex V2 機器人與 Facebook Messenger 整合 您可以在 Facebook Messenger 中託管 Amazon Lex V2 機器人。當您這麼做時，Facebook 使用者可以與您的機器人互動，以滿足意圖。 開始之前，您需要前往 https：//[https://developers.facebook.com](https://developers.facebook.com) 註冊 Facebook 開發人員帳戶。 您需要執行下列步驟： **Topics** + [ # 步驟 1：建立 Facebook 應用程式 ](facebook-step-1.md) + [ # 步驟 2：整合 Facebook Messenger 與 Amazon Lex V2 機器人 ](facebook-step-2.md) + [ # 步驟 3：與您的 Lex V2 機器人完成 Facebook 整合 ](facebook-step-3.md) + [ # 步驟 4：測試與 Facebook Messenger 的整合 ](facebook-step-4.md) # 步驟 1：建立 Facebook 應用程式 在 Facebook 開發人員入口網站上，建立 Facebook 應用程式和 Facebook 粉絲專頁。 **建立 Facebook 應用程式** 1. 開啟 [ https://developers.facebook.com/apps ](https://developers.facebook.com/apps) 1. 選擇 **Create App (建立應用程式)**。 1. 在**建立應用程式**頁面中，選擇**商務**，然後選擇**下一步**。 1. 對於**新增應用程式名稱**、**應用程式聯絡人電子郵件**和**企業帳戶**欄位，為您的應用程式做出適當的選擇。選擇**建立應用程式**以繼續。 1. 從**將產品新增至您的應用程式**，從 **Messenger** 圖磚選擇**設定**。 1. 在**存取字符**區段中，選擇**新增或移除頁面**。 1. 選擇要與應用程式搭配使用的頁面，然後選擇**下一步**。 1. 對於**允許應用程式執行的操作**，請保留預設值，然後選擇**完成**。 1. 在確認頁面上，選擇 **OK** (確定)。 1. 在**存取字符**區段中，選擇**產生字符**，然後複製字符。您可以在 Amazon Lex V2 主控台中輸入此字符。 1. 從左側選單中，選擇**設定**，然後選擇**基本**。 1. 對於**應用程式秘密**，選擇**顯示**，然後複製秘密。您可以在 Amazon Lex V2 主控台中輸入此字符。 ## 下一步驟 [步驟 2：整合 Facebook Messenger 與 Amazon Lex V2 機器人](facebook-step-2.md) # 步驟 2：整合 Facebook Messenger 與 Amazon Lex V2 機器人 在此步驟中，您將 Amazon Lex V2 機器人與 Facebook 連結。 1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。 1. 從機器人清單中，選擇您建立的 Amazon Lex V2 機器人。 1. 在左側選單中，選擇**頻道整合**，然後選擇**新增頻道**。 1. 在**建立頻道**中，執行下列動作： 1. 針對**平台**，選擇 **Facebook**。 1. 針對**身分政策**，選擇 AWS KMS 金鑰來保護頻道資訊。預設金鑰由 Amazon Lex V2 提供。 1. 針對**整合組態**，請為頻道指定名稱和選用的描述。選擇指向要使用之機器人版本的別名，然後選擇頻道支援的語言。 1. 針對**其他組態**，輸入下列內容： + **別名** – 識別呼叫 Amazon Lex V2 之應用程式的字串。您可以使用任何字串。記錄此字串，您可以在 Facebook 開發人員主控台中輸入。 + **頁面存取字符** – 您從 Facebook 開發人員主控台複製的頁面存取字符。 + **應用程式私密金鑰** – 您從 Facebook 開發人員主控台複製的私密金鑰。 1. 選擇 **Create** (建立) 1. Amazon Lex V2 會顯示機器人的頻道清單。從清單中，選擇您剛建立的頻道。 1. 從**回呼 URL**，記錄回呼 URL。您可以在 Facebook 開發人員主控台中輸入此 URL。 ## 下一步驟 [步驟 3：與您的 Lex V2 機器人完成 Facebook 整合](facebook-step-3.md) # 步驟 3：與您的 Lex V2 機器人完成 Facebook 整合 在此步驟中，使用 Facebook 開發人員主控台來完成與 Amazon Lex V2 的整合。 **完成 Facebook Messenger 整合** 1. 開啟 [ https://developers.facebook.com/apps ](https://developers.facebook.com/apps) 1. 從應用程式清單中，選擇您要與 Facebook Messenger 整合的應用程式。 1. 在左側選單中，選擇 **Messenger**，然後選擇**設定**。 1. 在 **Webhooks** 區段中： 1. 選擇**新增回呼 URL**。 1. 在**編輯回呼 URL** 中，輸入下列內容： + **回呼 URL** – 輸入您從 Amazon Lex V2 主控台記錄的回呼 URL。 + **驗證權杖** – 輸入您在 Amazon Lex V2 主控台中輸入的別名。 1. 選擇**驗證並儲存**。 1. 選擇頁面旁的 **Webhook **下的**新增訂閱**。 1. 在彈出的視窗中，選擇 `messages` ，然後按一下**儲存**。 ## 下一步驟 [步驟 4：測試與 Facebook Messenger 的整合](facebook-step-4.md) # 步驟 4：測試與 Facebook Messenger 的整合 您現在可以從 Facebook Messenger 開始與 Amazon Lex V2 機器人的對話。 **測試 Facebook Messenger 與 Amazon Lex V2 機器人之間的整合** 1. 開啟您在步驟 1 中與機器人相關聯的 Facebook 頁面。 1. 在 Messenger 視窗中，使用 中提供的測試表達用語[練習 1：從範本建立聊天機器人](exercise-1.md)。 # 將 Amazon Lex V2 機器人與 Slack 整合 本主題提供將 Amazon Lex V2 機器人與 Slack 訊息應用程式整合的說明。您會執行以下步驟： **Topics** + [ # 步驟 1：註冊 Slack 並建立 Slack 團隊 ](slack-step-1.md) + [ # 步驟 2：建立 Slack 應用程式 ](slack-step-2.md) + [ # 步驟 3：整合 Slack 應用程式與 Amazon Lex V2 機器人 ](slack-step-3.md) + [ # 步驟 4：完成與 Lex V2 機器人的 Slack 整合 ](slack-step-4.md) + [ # 步驟 5：測試 Lex V2 機器人與 Slack 之間的整合 ](slack-step-5.md) # 步驟 1：註冊 Slack 並建立 Slack 團隊 註冊 Slack 帳戶並建立 Slack 團隊。如需相關指示，請參閱[使用 Slack](https://get.slack.help/hc/en-us/articles/212675257-Creating-a-Slack-account)。在下一節中，您將建立任何 Slack 團隊都可以安裝的 Slack 應用程式。 ## 下一步驟 [步驟 2：建立 Slack 應用程式](slack-step-2.md) # 步驟 2：建立 Slack 應用程式 請在本節執行以下動作： 1. 在 Slack API 主控台中建立 Slack 應用程式。 1. 設定應用程式，將互動式訊息新增至您的機器人。 在本節結尾處，您會取得應用程式登入資料 （用戶端 ID、用戶端秘密和驗證字符）。在下一個步驟中，您可以使用此資訊在 Amazon Lex V2 主控台中整合機器人。 **建立 Slack 應用程式** 1. 在 https：//[https://api.slack.com ](https://api.slack.com)登入 Slack API 主控台。 1. 建立 應用程式。 在您成功建立應用程式後、Slack 會顯示應用程式的 **Basic Information** (基本資訊) 頁面。 1. 如下設定應用程式功能： 1. 在左側選單中，選擇**互動與捷徑**。 + 選擇切換開關以啟用互動式元件。 + 在 **Request URL** (請求 URL) 方塊中，指定任何有效的 URL。例如，您可以使用 **https://slack.com**. **注意** 暫時先輸入任何有效的 URL 以取得下一步驟所需的驗證符記。您將在 Amazon Lex 主控台中新增機器人頻道關聯後更新此 URL。 + 選擇 **Save Changes** (儲存變更)。 1. 在左側功能表的 **Settings** (設定) 中，選擇在 **Basic Information** (基本資訊)。記錄以下應用程式登入資料： + 用戶端 ID + 用戶端密碼 + 驗證符記 ## 下一步驟 [步驟 3：整合 Slack 應用程式與 Amazon Lex V2 機器人](slack-step-3.md) # 步驟 3：整合 Slack 應用程式與 Amazon Lex V2 機器人 在本節中，將您建立的 Slack 應用程式與您使用頻道整合建立的 Amazon Lex V2 機器人整合。 1. 登入 AWS 管理主控台，並在 [https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)：// 開啟 Amazon Lex 主控台。 1. 從機器人清單中，選擇您建立的 Amazon Lex V2 機器人。 1. 在左側選單中，選擇**頻道整合**，然後選擇**新增頻道**。 1. 在**建立頻道**中，執行下列動作： 1. 針對**平台**，選擇 **Slack**。 1. 針對**身分政策**，選擇 AWS KMS 金鑰來保護頻道資訊。預設金鑰由 Amazon Lex V2 提供。 1. 針對**整合組態**，請為頻道指定名稱和選用的描述。選擇指向要使用之機器人版本的別名，然後選擇頻道支援的語言。 **注意** 如果您的機器人提供多種語言，您必須為每個語言建立不同的頻道和不同的應用程式。 1. 針對**其他組態**，輸入下列內容： + **用戶端 ID** – 輸入來自 Slack 的用戶端 ID。 + **用戶端秘密** – 輸入來自 Slack 的用戶端秘密。 + **驗證字符** – 輸入來自 Slack 的驗證字符。 + **成功頁面 URL** – Slack 應在使用者進行身分驗證時開啟的頁面 URL。一般而言，請將此保留空白。 1. 選擇**建立**以建立頻道。 1. Amazon Lex V2 會顯示機器人的頻道清單。從清單中選擇您剛建立的頻道。 1. 從**回呼 URL**，記錄端點和 OAuth 端點。 ## 下一步驟 [步驟 4：完成與 Lex V2 機器人的 Slack 整合](slack-step-4.md) # 步驟 4：完成與 Lex V2 機器人的 Slack 整合 在本節中，使用 Slack API 主控台來完成與 Slack 應用程式的整合。 1. 在 https：//[https://api.slack.com](https://api.slack.com) 登入 Slack API 主控台。選擇您在[步驟 2：建立 Slack 應用程式](slack-step-2.md)中建立的應用程式。 1. 依下列方式更新 **OAuth 與許可**功能： 1. 在左側功能表中，選擇 **OAuth 與許可**。 1. 在**重新導向 URLs**區段中，新增 Amazon Lex 在上一個步驟中提供的 OAuth 端點。選擇 **Add** (新增)，然後選擇**Save URLs** (儲存 URL)。 1. 在**機器人字符範圍**區段中，使用新增 **OAuth 範圍按鈕新增**兩個許可。以下列文字篩選清單： + **chat:write** + **team:read** 1. 將**請求 URL** 值更新為 Amazon Lex 在上一個步驟中提供的端點，以更新**互動與捷徑**功能。輸入您在步驟 3 中儲存的端點，然後選擇**儲存變更**。 1. 依下列方式訂閱**事件訂閱**功能： + 選擇 **On** (開) 選項來啟用事件。 + 將**請求 URL** 值設定為 Amazon Lex 在上述步驟中提供的端點。 + 在**訂閱機器人事件**區段中，選取**新增機器人使用者事件**並新增**message.im**機器人事件，以在最終使用者和 Slack 機器人之間啟用直接傳訊。 + 儲存變更。 1. 從訊息索引標籤啟用傳送訊息，如下所示： + 從左側選單中，選擇**應用程式首頁**。 + 在**顯示標籤**區段中，選擇**允許使用者從訊息索引標籤傳送斜線命令和訊息。** 1. 選擇 **Settings** (設定) 下的 **Manage Distribution** (管理分佈)。選擇 **Add to Slack** (新增到 Slack) 以安裝應用程式。如果您已驗證多個工作區，請先從下拉式清單的右上角選擇正確的工作區。接著，選取**允許**以授權機器人回應訊息。 **注意** 如果您稍後對 Slack 應用程式設定進行任何變更，則必須重做此子步驟。 ## 下一步驟 [步驟 5：測試 Lex V2 機器人與 Slack 之間的整合](slack-step-5.md) # 步驟 5：測試 Lex V2 機器人與 Slack 之間的整合 現在請使用瀏覽器視窗來測試 Slack 與 Amazon Lex V2 機器人的整合。 **測試您的 Slack 應用程式** 1. 啟動 Slack。在左側選單的**直接訊息**區段中，選擇您的機器人。如果您沒有看到您的機器人，選擇 **Direct Messages** (直接訊息) 旁邊的加號圖示 (\$1) 來搜尋。 1. 與您的 Slack 應用程式進行聊天。您的機器人會回應訊息。 如果您使用 建立機器人[練習 1：從範本建立聊天機器人](exercise-1.md)，您可以使用該練習中的範例對話。 # 將 Amazon Lex V2 機器人與 Twilio SMS 整合 本主題提供將 Amazon Lex V2 機器人與 Twilio 簡單訊息服務 (SMS) 整合的說明。您會執行以下步驟： **Topics** + [ # 步驟 1：建立 Twilio SMS 帳戶 ](twilio-step-1.md) + [ # 步驟 2：整合 Twilio 訊息服務端點與 Amazon Lex V2 機器人 ](twilio-step-2.md) + [ # 步驟 3：完成 Lex V2 機器人與 Twilio 之間的 Twilio 整合 ](twilio-step-3.md) + [ # 步驟 4：測試 Lex V2 機器人與 Twilio 之間的整合 ](twilio-step-4.md) # 步驟 1：建立 Twilio SMS 帳戶 註冊 Twilio 帳戶，並記錄以下帳戶資訊： + **ACCOUNT SID** + **AUTH TOKEN** 如需註冊說明，請參閱 [ https：//https://www.twilio.com/console。 ](https://www.twilio.com/console) ## 下一步驟 [步驟 2：整合 Twilio 訊息服務端點與 Amazon Lex V2 機器人](twilio-step-2.md) # 步驟 2：整合 Twilio 訊息服務端點與 Amazon Lex V2 機器人 1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/) 開啟 Amazon Lex 主控台。 1. 從機器人清單中，選擇您建立的 Amazon Lex V2 機器人。 1. 在左側選單中，選擇**頻道整合**，然後選擇**新增頻道**。 1. 在**建立頻道**中，執行下列動作： 1. 針對**平台**，選擇 **Twilio**。 1. 針對**身分政策**，選擇 AWS KMS 金鑰來保護頻道資訊。預設金鑰由 Amazon Lex V2 提供。 1. 對於**整合組態**，請為頻道指定名稱和選用的描述。選擇指向要使用之機器人版本的別名，然後選擇頻道支援的語言。 1. 對於**其他組態**，從 Twilio 儀表板輸入帳戶 SID 和身分驗證字符。 1. 選擇**建立**。 1. 從頻道清單中，選擇您剛建立的頻道。 1. 複製**回呼 URL**。 ## 下一步驟 [步驟 3：完成 Lex V2 機器人與 Twilio 之間的 Twilio 整合](twilio-step-3.md) # 步驟 3：完成 Lex V2 機器人與 Twilio 之間的 Twilio 整合 使用 Twilio 主控台來完成 Amazon Lex V2 機器人與 Twilio SMS 的整合。 1. 在 https：//[https://www.twilio.com/console ](https://www.twilio.com/console)開啟 Twilio 主控台。 1. 從左側選單中，選擇**所有產品和服務**，然後選擇**電話號碼**。 1. 如果您有電話號碼，請選擇它。如果您沒有電話號碼，請選擇**購買號碼**以取得號碼。 1. 在**訊息**區段的 **MESSAGE COMES IN** 中，從 Amazon Lex V2 主控台輸入回呼 URL。 1. 選擇**儲存**。 ## 下一步驟 [步驟 4：測試 Lex V2 機器人與 Twilio 之間的整合](twilio-step-4.md) # 步驟 4：測試 Lex V2 機器人與 Twilio 之間的整合 使用您的手機測試 Twilio SMS 與您的機器人之間的整合。使用您的手機傳送訊息至 Twilio 號碼。 如果您使用 建立機器人[練習 1：從範本建立聊天機器人](exercise-1.md)，您可以使用該練習中的範例對話。 # 將 Amazon Lex V2 機器人與聯絡中心整合 您可以將 Amazon Lex V2 機器人與您的聯絡中心整合，以使用 Amazon Lex V2 串流 API 啟用自助式使用案例。使用這些機器人做為電話上的互動式語音回應 (IVR) 客服人員，或做為整合到您的聯絡中心的文字型聊天機器人。如需串流 APIs的詳細資訊，請參閱 [將對話串流至 Amazon Lex V2 機器人](streaming.md)。 透過串流 APIs，您可以啟用下列功能： + **中斷 **("barge-in") – 呼叫者可以在提示完成之前中斷機器人並回答問題。如需詳細資訊，請參閱[讓使用者中斷您的 Amazon Lex V2 機器人](interrupt-bot.md)。 + **等待並繼續** – 來電者可以指示機器人在通話期間需要時間擷取其他資訊時等待，例如信用卡號碼或預訂 ID。如需詳細資訊，請參閱[讓 Amazon Lex V2 機器人在暫停期間等待使用者提供更多資訊](wait-and-continue.md)。 + **DTMF 支援** – 來電者可以透過語音或 DTMF 交替提供資訊。 + **SSML 支援** – 您可以使用 SSML 標籤設定 Amazon Lex V2 機器人提示，以更好地控制文字產生的語音。如需詳細資訊，請參閱《*Amazon Polly 開發人員指南*》中的[從 SSML 文件產生語音](https://docs.aws.amazon.com/polly/latest/dg/ssml.html)。 + **可設定的逾時 –** 您可以設定在 Amazon Lex V2 收集語音輸入之前，等待客戶完成說話的時間，例如回答是或否的問題，或提供日期或信用卡號碼。如需詳細資訊，請參閱[設定使用 Lex V2 機器人擷取使用者輸入的逾時](session-attribs-speech.md)。 + **履行進度更新** – 您可以設定機器人根據意圖履行的業務邏輯執行期間的履行狀態來回應多個訊息。您可以設定機器人在履行開始和完成時以訊息回應，並為長時間執行的 Lambda 函數提供定期更新。如需詳細資訊，請參閱[為您的 Lex V2 機器人設定履行進度更新](streaming-progress.md)。 # Amazon Chime SDK 使用 Amazon Chime SDK 將即時音訊、影片、螢幕共用和訊息功能新增至您的 Web 或行動應用程式。Amazon Chime SDK 提供公有交換電話網路 (PSTN) 音訊服務，讓您可以使用 AWS Lambda 函數建置自訂電話語音應用程式。 Amazon Chime PSTN 音訊已與 Amazon Lex V2 整合。您可以使用此整合來存取 Amazon Lex V2 機器人，做為聯絡中心中的互動式語音回應 (IVR) 系統，以進行音訊互動。在下列案例中，使用 PSTN 音訊服務來整合 Amazon Lex V2。 **聯絡中心整合** - 您可以使用 Amazon Chime Voice Connector 和 Amazon Chime SDK PSTN 音訊服務來存取 Amazon Lex V2 機器人。在將工作階段啟動通訊協定 (SIP) 用於語音通訊的任何聯絡中心應用程式中使用它們。此整合透過 SIP 支援，將自然語言語音對話體驗新增至您現有的現場部署或雲端聯絡中心。如需支援的聯絡中心平台清單，請參閱 [Amazon Chime 語音連接器資源](https://aws.amazon.com/chime/voice-connector/resources/)。 下圖顯示使用 SIP 和 Amazon Lex V2 的聯絡中心之間的整合。 ![\[使用 Amazon Chime SDK 的聯絡中心與 Amazon Lex V2 之間的資訊流程。\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/images/chime-sip.flow.png) **直接電話支援** - 您可以使用 Amazon Chime SDK 中佈建的電話號碼，建置自訂的 IVR 解決方案來直接存取 Amazon Lex V2 機器人。 如需詳細資訊，請參閱《*Amazon Chime SDK 指南*》中的下列主題。 + [使用 Amazon Chime 語音連接器的 SIP 整合](https://docs.aws.amazon.com/chime/latest/dg/mtgs-sdk-cvc.html) + [使用 Amazon Chime SDK PSTN 音訊服務](https://docs.aws.amazon.com/chime/latest/dg/build-lambdas-for-sip-sdk.html) + [將 Amazon Chime PSTN 音訊與 Amazon Lex V2 整合](https://docs.aws.amazon.com/chime/latest/dg/start-bot-conversation.html) 當 Amazon Chime SDK 將請求傳送至 Amazon Lex V2 時，它會包含平台特定資訊到您的 Lambda 函數和對話日誌。使用此資訊來判斷將流量傳送至機器人的聯絡中心應用程式。 | 常見請求屬性 | Value | | --- | --- | | x-amz-lex：channels：platform | Amazon Chime SDK PSTN Audio | # Amazon Connect Amazon Connect 是全通道雲端聯絡中心。您只需幾個步驟即可設定聯絡中心、新增位於任何地方的客服人員，並開始與客戶互動。如需詳細資訊，請參閱《[Amazon Connect 管理員指南](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-get-started.html)*》中的 Amazon Connect *入門。 您可以使用全通道通訊，為客戶建立個人化體驗。例如，您可以根據客戶偏好和預估等待時間提供聊天和語音聯絡。同時，客服人員可以從一個界面處理所有客戶。例如，他們可以與客戶聊天，並在路由到他們的任務時建立或回應任務。 您可以使用 Amazon Connect 與客戶進行音訊互動，或使用 Amazon Connect Chat 進行純文字互動。 如需詳細資訊，請參閱《*Amazon Connect 管理員指南*》中的下列主題。 + [什麼是 Amazon Connect ](https://docs.aws.amazon.com/connect/latest/adminguide/what-is-amazon-connect.html) + [新增 Amazon Lex V2 機器人 ](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-lex.html) + [Amazon Connect 取得客戶輸入聯絡區塊](https://docs.aws.amazon.com/connect/latest/adminguide/get-customer-input.html) 當聯絡中心傳送請求至 Amazon Lex V2 時，會將平台特定資訊做為請求屬性納入您的 Lambda 函數和對話日誌。使用此資訊來判斷哪個聯絡中心應用程式將流量傳送至您的機器人。 **Amazon Connect 的一般請求屬性** | 屬性 | Value | | --- | --- | | x-amz-lex：channels：platform | 下列其中一值： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/contact-center-connect.html) | # Genesys 雲端 Genesys Cloud 是企業通訊、協作和聯絡中心管理的雲端服務套件。Genesys Cloud 建立在 AWS 之上，並使用分散式雲端環境，為工作中的組織提供安全的存取。 如需詳細資訊，請參閱 Genesys Cloud 網站上的下列頁面。 + [ 關於 Genesys Cloud 聯絡中心 ](https://help.mypurecloud.com/articles/about-genesys-cloud-contact-center/) + [ 關於 Amazon Lex V2 整合 ](https://help.mypurecloud.com/articles/about-the-amazon-lex-v2-integration/) 當聯絡中心傳送請求至 Amazon Lex V2 時，會將平台特定資訊做為請求屬性納入您的 Lambda 函數和對話日誌。使用此資訊來判斷哪個聯絡中心應用程式將流量傳送至您的機器人。 **Genesys 雲端的常見請求屬性** | 屬性 | Value | | --- | --- | | x-amz-lex：channels：platform | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/lexv2/latest/dg/contact-center-genesys.html) | *進一步了解* + [使用 Amazon Lex 和 Genesys Cloud 為您的聯絡中心提供支援](https://aws.amazon.com/blogs/machine-learning/enhancing-customer-service-experiences-using-conversational-ai-power-your-contact-center-with-amazon-lex-and-genesys-cloud/)