本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 为生产环境部署 Lex V2 机器人 创建并测试完成后，可以部署机器人与您的客户进行交互。在本节中，学习如何在更新后创建机器人*版本*。当准备部署机器人时，使用*别名*表示不同版本的机器人。了解如何将您的机器人与消息收发平台、移动应用程序和网站集成。 **Topics** + [ # Lex V2 机器人的版本控制和别名 ](versions-aliases.md) + [ # 使用 Java 应用程序与 Amazon Lex V2 机器人进行交互 ](deploy-java.md) + [ # 使用 Global Resiliency 将机器人部署到其他区域 ](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 支持创建机器人的版本，以便您控制客户端应用程序使用的实现方案。*版本*是您工作的带编号快照，您可以创建版本以用于您的工作流的不同阶段，如开发、测试部署和生产。 ### Lex V2 机器人的草稿版本 当您创建 Amazon Lex V2 机器人时，只有一个版本，即 `Draft` 版本。 `Draft` 是您机器人的工作副本。您只能更新 `Draft` 版本，直到您创建第一个版本，`Draft` 是您所拥有的唯一机器人版本。 您机器人的 `Draft` 版本与 `TestBotAlias` 相关联。`TestBotAlias` 只应用于手动测试。Amazon Lex V2 限制可对机器人的 `TestBotAlias` 别名进行的运行时请求的数量。 ### 为 Lex V2 机器人创建版本 当您对 Amazon Lex V2 机器人进行版本控制时，您创建该机器人的带编号快照，从而能够以该机器人在创建该版本时的状态来使用该机器人。创建数字版本后，该版本在您继续处理应用程序的草稿版本时将保持不变。 创建版本时，您可以选择包含在该版本中的区域设置。您无需选择机器人中的所有区域设置。此外，在创建版本时，可以从先前版本中选择区域设置。例如，如果您有三个版本的机器人，则在创建第四版本时，可以从 `Draft` 版本中选择一个区域设置，并且从第二版中选择一个区域设置。 如果从 `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_cn/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_cn/lexv2/latest/dg/images/lex-publish-alias-bot-v2.png) 当您将客户端应用程序设置为调用 [Amazon Lex Runtime 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 应用程序中与机器人进行交互。使用 SDK for Java 来为用户构建客户端应用程序。 以下应用程序与您在中创建的 OrderFlowers 机器人进行交互。[练习 1：使用模板创建聊天机器人](exercise-1.md)它使用 SDK for Java SDK 中的调用该[RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)操作来与机器人进行对话。`LexRuntimeV2Client` 该对话的输出如下所示： ``` 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; } } ``` # 使用 Global Resiliency 将机器人部署到其他区域 Global Resiliency 允许您在辅助区域复制机器人。通过在两个区域自动复制用户的机器人，可以使辅助区域处于活动状态。如果发生区域中断，您将有一个备份区域。Global Resiliency 激活后，新创建的机器人将在第二个 AWS 区域复制。 **注意** 此功能仅适用于在美国东部（弗吉尼亚州北部）和美国西部（俄勒冈州）区域，以及欧洲西部（伦敦）和欧洲中部（法兰克福）区域创建的 Amazon Connect 和 Amazon Lex V2 实例。 要获得对此功能的访问权限，请联系您的 Amazon Connect 解决方案架构师或技术客户经理。 激活此功能后，您可以近乎实时地在配对的 AWS 区域中自动复制 Amazon Lex V2 机器人及其资源、版本和别名。使用此特征，您可以监控原始和副本机器人的版本号，以确保机器人副本与原始机器人保持同步。启用复制后，您可以激活要在其中复制机器人的预先确定的 AWS 区域（区域基于预先确定的配对）。对源区域中源机器人进行的任何更新都会自动应用到第二个区域中复制的机器人。 **注意** 为机器人启用 Global Resiliency 后，所有现有别名及其关联版本都将在副本区域中复制。在启用复制之前未与别名关联的版本将在与别名关联时进行复制。启用复制后创建的每个版本和别名都会自动复制。用户可以使用 `ListBotVersionReplicas` 和 `ListBotAliasReplicas` 来查看每个版本和别名的复制状态。从机器人到其副本的机器人变更是单向的。因为副本机器人始终与机器人保持同步，所以用户无法修改副本机器人。 有关使用 Global Resiliency 的其他信息： + Global Resiliency 目前仅适用于预先确定的区域对。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/global-resiliency.html) + 为机器人启用 Global Resiliency 后，所有现有别名及其关联版本都将在副本区域中复制。在启用复制之前未与别名关联的版本将在与别名关联时进行复制。启用复制后创建的每个版本和别名都会自动复制。用户可以使用 `ListBotVersionReplicas` 和 `ListBotAliasReplicas` 来了解每个版本和别名的复制状态。从机器人到其副本的机器人变更是单向的。因为副本机器人始终与机器人保持同步，所以用户无法修改副本机器人。 + 任何别名可以与任何版本关联。如果版本尚未复制，则将在与别名关联的过程中对其进行复制。 限制： + 如果使用槽位创建了机器人，而槽位使用 LLM（例如 CFAQ 和言语生成），则 Global Resiliency 不会复制这些机器人。 + Global Resiliency 不会复制机器人网络，但仍可单独复制任何属于机器人网络的机器人。 **Topics** + [ # 在 Lex V2 中复制机器人和管理机器人副本的权限 ](gr-permissions.md) + [ # 使用 Lex V2 机器人部署 Global Resiliency ](navigation-gr.md) # 在 Lex V2 中复制机器人和管理机器人副本的权限 如果 IAM 角色附加了[AmazonLexFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonLexFullAccess)策略，则它可以创建和管理机器人副本。 如果您希望创建具有最低 Global Resiliency 权限的角色，请使用包含以下语句的策略。 + 访问 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 机器人部署 Global Resiliency Global Resiliency 允许您在辅助区域复制机器人。通过在两个区域自动复制用户的机器人，可以使辅助区域处于活动状态。如果发生区域中断，您将有一个备份区域。Global Resiliency 激活后，新创建的机器人将在第二个 AWS 区域复制。 ## Global Resiliency 信息面板显示有关部署的详细信息 您可以在 Global Resiliency 面板中访问以下信息： + **来源详情**：有关机器人源区域、副本类型、启用复制的日期和上次创建的版本的信息。使用这些信息来跟踪机器人的迭代。 + **复制详细信息**：创建机器人副本后，您可以跟踪复制区域、副本类型、上次版本同步日期和上次复制的版本。使用这些信息来跟踪机器人副本的同步。 + **源区域**：启用了 Global Resiliency 的区域。您可以在源区域进行更改，以便在两个区域复制机器人。 + **副本类型**：指明机器人是只读还是能够根据区域进行读写。 + **副本区域**：用于为 Global Resiliency 复制源机器人的辅助区域。全球弹性目前仅适用于 IAD/PDX 和 LDN/FRA 区域配对。 + **启用复制的日期**：启用机器人副本的日期和时间。 + **上次创建的版本**：源区域中与副本关联的最后一个机器人版本。 ## 为 Lex V2 机器人启用 Global Resiliency 在 Amazon Lex V2 控制台中激活 Global Resiliency 之前，必须确保启用机器人复制的用户有权创建服务相关角色（SLR）。调用时 CreateReplica ，全球弹性将使用这些 FAS 凭证在启用的账户中创建 SLR。有关在 Amazon Lex V2 中设置 SLR 以实现全球弹性的更多信息，请参阅 AW [S 托管策略](https://docs.aws.amazon.com/lexv2/latest/dg/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonLexFullAccess)：。 AmazonLexFullAccess **注意** 此功能仅适用于在美国东部（弗吉尼亚州北部）和美国西部（俄勒冈州）区域，以及欧洲西部（伦敦）和欧洲中部（法兰克福）区域创建的 Amazon Connect 和 Amazon Lex V2 实例。 要获得对此功能的访问权限，请联系您的 Amazon Connect 解决方案架构师或技术客户经理。 激活 Global Resiliency 并为第二个区域设置机器人复制： 1. 登录 AWS 管理控制台，然后在以下网址打开 Amazon Lex 控制台[ https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/lex/)。 1. 从左侧导航面板的机器人导航栏中选择要复制的机器人。 1. 选择“部署”>“Global Resiliency”。 1. 选择窗口右上角的**创建副本**按钮，创建机器人的草稿版本。 **注意** 检查以确保辅助区域中没有任何机器人与您要复制的机器人同名。（您的机器人必须具有唯一名称）。 1. 转到 **Global Resiliency**，单击**创建副本**：此操作将创建机器人的草稿版本。（除了查看状态或未来内部版本的详细信息外，无需返回“Global Resiliency”选项卡）。 **注意** 您还可以通过转到“别名”并为启用了 Global Resiliency 的机器人选择**创建新别名**，在 Global Resiliency 中创建别名机器人用于复制。所有别名都会复制，即使是在启用复制之前创建的别名也会复制。 1. 转到**别名**：为启用了 Global Resiliency 的机器人**创建新别名**。所有别名都会复制，即使是在启用复制之前创建的别名也会复制。 1. 转到**版本**：为启用了 Global Resiliency 的机器人**创建新版本**。任何与别名关联的版本都会复制，即使是在启用复制之前创建的版本也会复制。 **注意** 客户仍可完全控制对基于资源的策略和复制机器人标签的管理。需要在两个区域部署具有相同标识符的 Lambda 函数和 CloudWatch 日志组。用户无需在副本区域中再次关联 Lambda 函数。 ## 禁用 Global Resiliency 您可以随时通过选择**禁用 Global Resiliency** 按钮来禁用 Global Resiliency。此操作可阻止您的源机器人以及与之关联的任何别名和版本在其他地区复制。 ## 将 Lex V2 机器人 APIs 与 “全球弹性” 配合使用 您可以使用以下 APIs方法在 “全球弹性” 中进行 API 调用。有关全球弹性 APIs 和 Amazon Lex V2 的更多信息，请参阅 A [mazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/api_ref.html) API 指南。 + **CreateBotReplica** 启用 Global Resiliency 并创建复制机器人。需要 `replicaRegion`。 有关更多信息，请参阅 [CreateBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBotReplica.html)Amazon Lex V2 API 指南。 + **DeleteBotReplica** 禁用 Global Resiliency 并删除复制机器人。需要使用 `replicaRegion` 和 `botId`。 有关更多信息，请参阅 [DeleteBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DeleteBotReplica.html)Amazon Lex V2 API 指南。 + **ListBotReplicas** 列出辅助区域中的复制机器人。需要 `botId`。 有关更多信息，请参阅 [ListBotReplicas](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListBotReplicas.html)Amazon Lex V2 API 指南。 + **DescribeBotReplica** 复制机器人的信息摘要。需要使用 `replicaRegion` 和 `botId`。 有关更多信息，请参阅 [DescribeBotReplica](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeBotReplica.html)Amazon Lex V2 API 指南。 # 将 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/)。 当消息收发平台向 Amazon Lex V2 发送请求时，它将包含平台特定信息作为您的 Lambda 函数的请求属性。使用该属性可自定义您的机器人的行为方式。有关更多信息，请参阅 [设置 Lex V2 机器人的请求属性](context-mgmt-request-attribs.md)。 **消息收发平台的常见请求属性** | 属性 | 说明 | | --- | --- | | x-amz-lex:channels: 平台 | 下列值之一： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/deploying-messaging-platform.html) | # 将 Amazon Lex V2 机器人与 Facebook Messenger 集成 您可以将 Amazon Lex V2 机器人托管在 Facebook Messenger 中。在此情况下，Facebook 用户可以与您的机器人交互以履行意图。 在你开始之前，你需要在以下网址注册一个 Facebook 开发者账户[https://developers.facebook.com](https://developers.facebook.com)。 请执行下列步骤： **Topics** + [ # 第 1 步：创建 Facebook 应用程序 ](facebook-step-1.md) + [ # 第 2 步：将 Facebook Messenger 与 Amazon Lex V2 机器人集成 ](facebook-step-2.md) + [ # 步骤 3：完成 Facebook 与 Lex V2 机器人的集成 ](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. 在**创建应用**页面中，选择 **Business**，然后选择**继续**。 1. 在**添加应用名称**、**应用联系邮箱**和**业务帐户**字段中，选择适用于您的应用程序的值。选择**创建应用**以继续。 1. 在**为应用添加产品**部分中，选择 **Messenger** 磁贴中的**设置**。 1. 在**访问口令**部分，选择**添加或移除主页**。 1. 选择要与您的应用程序配合使用的页面，然后选择**继续**。 1. 在**可管理的业务功能**中，保留默认值，然后选择**完成**。 1. 在确认页面上，请选择**确认**。 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 管理控制台，然后在以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/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。记下该 URL，然后访问 Facebook 开发人员控制台并输入该 URL。 ## 后续步骤 [步骤 3：完成 Facebook 与 Lex V2 机器人的集成](facebook-step-3.md) # 步骤 3：完成 Facebook 与 Lex V2 机器人的集成 在此步骤中，使用 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. 选择**添加回调网址**。 1. 在**编辑回调网址**中，输入以下内容： + **回调网址**：输入您从 Amazon Lex V2 控制台记录下的回调 URL。 + **验证口令**：输入您在 Amazon Lex V2 控制台中输入的别名。 1. 选择 **Verify and Save**。 1. 在页面旁边的 **Webhooks** 下选择**添加订阅**。 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：完成 Slack 与 Lex V2 机器人的集成 ](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. 登录 Slack API 控制台，网址为[https://api.slack.com](https://api.slack.com)。 1. 创建应用程序。 在您成功创建应用程序以后，Slack 会显示应用程序的 **Basic Information** 页面。 1. 按如下所示配置应用程序的功能： 1. 在左侧菜单中，选择**互动性和快捷方式**。 + 选择打开交互式组件的开关。 + 在 **Request URL** 框中，指定任何有效的 URL。例如，您可以使用 **https://slack.com**。 **注意** 目前，请输入任何有效的 URL，以便获得在下一步中需要的验证令牌。您在 Amazon Lex 控制台中添加机器人通道关联后，将需要更新此 URL。 + 选择**保存更改**。 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 管理控制台并通过以下网址打开 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/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：完成 Slack 与 Lex V2 机器人的集成](slack-step-4.md) # 步骤 4：完成 Slack 与 Lex V2 机器人的集成 在本部分中，使用 Slack API 控制台完成与 Slack 应用程序的集成。 1. 登录 Slack API 控制台，网址为[https://api.slack.com](https://api.slack.com)。选择您在[第 2 步：创建 Slack 应用程序](slack-step-2.md)中创建的应用程序。 1. 按如下方式更新 **“OAuth 和权限”** 功能： 1. 在左侧菜单中，选择**OAuth 和权限**。 1. 在**重定向 URLs**部分中，添加 Amazon Lex 在上一步中提供的 OAuth 终端节点。选择 **Add**，然后选择 **Save URLs**。 1. 在 **Bot Token Scopes** 部分中，使用**添加 OAuth 作用域**按钮添加两个权限。用以下文本筛选列表： + **chat:write** + **team:read** 1. 通过将**请求 URL** 值更新为 Amazon Lex 在上一步中提供的端点来更新**互动性和快捷方式**功能。输入您在第 3 步中保存的端点，然后选择**保存更改**。 1. 按如下所述订阅 **Event Subscriptions** 功能： + 通过选择 **On** 选项启用事件。 + 将**请求 URL** 值设置为 Amazon Lex 在上一步中提供的端点。 + 在**订阅机器人事件**部分中，选择**添加机器人用户事件**，然后添加 **message.im** 机器人事件，以便启用最终用户与 Slack 机器人之间的直接消息收发。 + 保存更改。 1. 启用从消息选项卡发送消息，如下所示： + 从左侧菜单中，选择**应用程序主页**。 + 在**显示选项卡**部分中，选择**允许用户从消息选项卡中发送 Slash 命令和消息**。 1. 在**设置**下选择**管理分发**。选择 **Add to 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 Simple Messaging Service（SMS）集成的说明。请执行下列步骤： **Topics** + [ # 第 1 步：创建 Twilio SMS 账户 ](twilio-step-1.md) + [ # 第 2 步：将 Twilio 消息收发服务端点与 Amazon Lex V2 机器人集成 ](twilio-step-2.md) + [ # 步骤 3：完成 Lex V2 机器人与 Twilio 的集成 ](twilio-step-3.md) + [ # 步骤 4：测试 Lex V2 机器人与 Twilio 的集成 ](twilio-step-4.md) # 第 1 步：创建 Twilio SMS 账户 注册 Twilio 账户，并记录以下账户信息： + **ACCOUNT SID** + **AUTH TOKEN** 有关注册说明，请参阅 [ https://www.twilio.com/](https://www.twilio.com/console)console。 ## 后续步骤 [第 2 步：将 Twilio 消息收发服务端点与 Amazon Lex V2 机器人集成](twilio-step-2.md) # 第 2 步：将 Twilio 消息收发服务端点与 Amazon Lex V2 机器人集成 1. 登录 AWS 管理控制台并打开位于的 Amazon Lex 控制台[https://console.aws.amazon.com/lex/](https://console.aws.amazon.com/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-step-3.md) # 步骤 3：完成 Lex V2 机器人与 Twilio 的集成 使用 Twilio 控制台完成 Amazon Lex V2 机器人与 Twilio SMS 的集成。 1. 在 [ https://www.twilio.com/](https://www.twilio.com/console)console 上打开 Twilio 控制台。 1. 从左侧菜单中选择 **All Products & Services**，然后选择 **Phone Number**。 1. 如果您有电话号码，请选择该电话号码。如果您没有电话号码，请选择 **Buy a Number** 以获取电话号码。 1. 在 **Messaging** 部分的 **A 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 集成。借助此集成，您在联络中心访问作为交互式语音响应 (IVR) 系统的 Amazon Lex V2 机器人，以进行音频交互。在以下场景中，以此来使用 PSTN 音频服务集成 Amazon Lex V2。 **联络中心集成**：您可以使用 Amazon Chime Voice Connector 和 Amazon Chime SDK PSTN 音频服务来访问 Amazon Lex V2 机器人。在任何使用会话初始协议 (SIP) 进行语音通信的联络中心应用程序中使用该等集成。借助此集成，您现有的本地或基于云的联络中心可实现自然语言语音对话体验，并支持 SIP。有关支持的联络中心平台列表，请参阅 [Amazon Chime Voice Connector 资源](https://aws.amazon.com/chime/voice-connector/resources/)。 下图显示了使用 SIP 的联络中心与 Amazon Lex V2 之间的集成。 ![\[使用 Amazon Chime SDK，联络中心与 Amazon Lex V2 之间的信息流。\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/images/chime-sip.flow.png) **直接电话支持**：您可以构建自定义 IVR 解决方案，以便使用 Amazon Chime SDK 中配置的电话号码直接访问 Amazon Lex V2 机器人。 有关更多信息，请参阅 *Amazon Chime SDK 指南* 中的以下主题： + [使用 Amazon Chime Voice Connector 进行 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 函数和对话日志中。通过此信息来确定正在向您的机器人发送流量的联络中心应用程序。 | 通用请求属性 | 值 | | --- | --- | | x-amz-lex:channels: 平台 | Amazon Chime SDK PSTN Audio | # Amazon Connect Amazon Connect 是一个全渠道云联系中心。只需执行几个步骤，便能设置联系中心，添加任意位置的客服，并开始与客户接洽。有关更多信息，请参阅 *Amazon Connect 管理员指南*中的[开始使用 Amazon Connect](https://docs.aws.amazon.com/connect/latest/adminguide/amazon-connect-get-started.html)。 您可以使用全渠道通信为客户创建个性化体验。例如，您可以根据客户偏好和预计等待时间提供聊天和语音联系方式供选择。同时，客服可以在一个界面处理所有客户。例如，他们可以与客户聊天，创建任务，并响应传送给他们的任务。 您可以使用 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 的常见请求属性** | 属性 | 值 | | --- | --- | | x-amz-lex:channels: 平台 | 下列值之一： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/lexv2/latest/dg/contact-center-connect.html) | # Genesys Cloud 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 Cloud 的常见请求属性** | 属性 | 值 | | --- | --- | | x-amz-lex:channels: 平台 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/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/)