本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 与 Lex V2 机器人的对话上下文 *对话上下文*是用户、您的客户端应用程序或 Lambda 函数向 Amazon Lex V2 机器人提供的用于实现意图的信息。对话上下文包括用户提供的槽数据、客户端应用程序设置的请求属性以及客户端应用程序和 Lambda 函数创建的会话属性。 **Topics** + [设置 Lex V2 机器人的意图上下文](context-mgmt-active-context.md) + [在 Lex V2 机器人的意图中使用默认槽位值](context-mgmt-default.md) + [设置 Lex V2 机器人的会话属性](context-mgmt-session-attribs.md) + [设置 Lex V2 机器人的请求属性](context-mgmt-request-attribs.md) + [设置超时会话](context-mgmt-session-timeout.md) + [通过 Lex V2 机器人在意图之间共享信息](context-mgmt-cross-intent.md) + [在 Lex V2 机器人中设置复杂属性](context-mgmt-complex-attributes.md) # 设置 Lex V2 机器人的意图上下文 *您可以根据情境让 Amazon Lex V2 触发意图。**上下文*是一个在定义机器人时与意图相关联的状态变量。通过控制台或 [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) 操作创建意图时，您可以为该意图配置上下文。目前，只支持在英语（美国）（en-US）语言环境中使用上下文。 上下文有两种类型的关系，即输出上下文和输入上下文。当履行关联的意图时，*输出上下文*就会变为活动状态。在 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 或 [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 操作的响应中，会将输出上下文返回到您的应用程序，并为当前会话设置上下文。上下文被激活后，会保持活动状态，直到定义上下文时配置的回合数或时间限制。 *输入上下文*指定了可以识别意图的条件。只有当对话的所有输入上下文都处于活动状态时，才能识别出意图。没有输入上下文的意图始终可以被识别。 Amazon Lex V2 自动管理通过使用输出上下文实现意图而激活的上下文的生命周期。您还可以在调用 `RecognizeText` 或 `RecognizeUtterance` 操作时设置活动上下文。 您也可以通过 Lambda 函数为意图设置对话上下文。来自 Amazon Lex V2 的输出上下文将发送到 Lambda 函数输入事件。Lambda 函数可以在其响应中发送上下文。有关更多信息，请参阅 [将AWS Lambda功能集成到您的 Amazon Lex V2 机器人中](lambda.md)。 例如，假设您打算预订一辆配置返回名为“book\$1car\$1fulfilled”的输出上下文的租车。意图实现后，Amazon Lex V2 会将输出上下文变量设置为 “book\$1car\$1fulfilled”。由于“book\$1car\$1fulfilled”上下文处于活动状态，因此，只要用户的言语被识别为试图引发此意图，就可以考虑将“book\$1car\$1fulfilled”上下文设置为输入上下文的意图进行识别。您可以将其用于只有在预订车辆后才有意义的意图，例如，通过电子邮件发送收据或修改预订。 ## Lex V2 机器人的意图输出上下文 当意图实现时，Amazon Lex V2 会激活意图的输出上下文。您可以通过输出上下文来控制哪些意图符合跟随当前意图的条件。 每个上下文都有一个在会话中维护的参数列表。这些参数是已履行意图的插槽值。您可以使用这些参数为其他意图预填充插槽值。有关更多信息，请参阅[在 Lex V2 机器人的意图中使用默认槽位值](context-mgmt-default.md)。 当您通过控制台或 [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) 操作创建意图时，您可以配置输出上下文。您可以为一个意图配置多个输出上下文。履行意图时，所有输出上下文都将被激活，并在 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 或 [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 响应中返回。 在定义输出上下文时，还*要定义其生存时间*、该上下文包含在 Amazon Lex V2 的响应中的时间长度或回合数。*轮*流是您的应用程序向 Amazon Lex V2 发出的一个请求。一旦回合数或时间到期，上下文将不再处于活动状态。 您的应用程序可以根据需要使用输出上下文。例如，您的应用程序可以通过输出上下文来： + 根据上下文更改应用程序的行为。例如，旅行应用程序对上下文“book\$1car\$1fulfilled”的操作可能与对“rental\$1hotel\$1fulfilled”的操作不同。 + 将输出上下文返回给 Amazon Lex V2，作为下一句话的输入上下文。如果 Amazon Lex V2 将话语识别为企图引发意图，则它会使用上下文将可以返回的意图限制为具有指定上下文的意图。 ## Lex V2 机器人的意图输入上下文 您可以设置输入上下文来限制对话中识别意图的点。没有输入上下文的意图始终可以被识别。 您可以通过控制台或 `CreateIntent` 操作设置意图响应的输入上下文。一个意图可以包含多个输入上下文。 对于具有多个输入上下文的意图，所有上下文都必须处于活动状态才能触发此意图。您可以在调用 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)、[RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 或 [PutSession](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_PutSession.html) 操作时设置输入上下文。 您可以将意图中的插槽配置为采用当前活动上下文中的默认值。当 Amazon Lex V2 识别出新的意图但没有收到槽位值时，将使用默认值。定义插槽时，可以在表单 `#context-name.parameter-name` 中指定上下文名称和插槽名称。有关更多信息，请参阅 [在 Lex V2 机器人的意图中使用默认槽位值](context-mgmt-default.md)。 # 在 Lex V2 机器人的意图中使用默认槽位值 使用默认值时，如果用户输入中未提供插槽，您可以指定一个源用于为新意图填充的插槽值。此来源可以是之前的对话、请求或会话属性，也可以是您在构建时设置的固定值。 您可以将以下内容作为默认值来源。 + 之前的对话（上下文）— \$1context-name.parameter-name + 会话属性 — [attribute-name] + 请求属性 — + 固定值 — 任何与先前值不匹配的值 通过 [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) 操作向意图添加插槽时，可以添加默认值列表。将按这些默认值列出的顺序对其进行排列。例如，假设您有一个带插槽的意图，其插槽定义如下： ``` "slots": [ { "botId": "string", "defaultValueSpec": { "defaultValueList": [ { "defaultValue": "#book-car-fulfilled.startDate" }, { "defaultValue": "[reservationStartDate]" } ] }, Other slot configuration settings } ] ``` 识别出意图后，名为 “reservation-start-date” 的插槽的值将设置为以下值之一。 1. 如果 “book-car-fulfilled” 上下文处于活动状态，则使用 “startDate” 参数的值作为默认值。 1. 如果 “book-car-fulfilled” 上下文未处于活动状态，或者未设置 “startDate” 参数，则使用 “reservationStartDate” 会话属性的值作为默认值。 1. 如果前两个默认值均未使用，则该插槽没有默认值，Amazon Lex V2 将像往常一样生成一个值。 如果使用插槽的默认值，则即使需要该插槽，也不会引发该插槽。 # 设置 Lex V2 机器人的会话属性 *会话属性*包含特定于应用程序的信息，于会话期间在机器人与客户端应用程序之间传递。Amazon Lex V2 将会话属性传递给为机器人配置的所有 Lambda 函数。如果 Lambda 函数添加或更新了会话属性，Amazon Lex V2 会将新信息返回给客户端应用程序。 在 Lambda 函数中使用会话属性来初始化机器人并自定义提示和响应卡。例如： + 初始化 — 在订购披萨机器人中，客户端应用程序在第一次调用 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 或 [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 操作时传递用户位置作为会话属性。例如 `"Location": "111 Maple Street"`。Lambda 函数根据该信息查找最近的披萨店下订单。 + 个性化提示 — 配置提示和响应卡，以引用会话属性。例如，“嘿 [FirstName]，你想要什么浇头？” 如果您传递该用户的名字作为会话属性（`{"FirstName": "Vivian"}`），Amazon Lex 将用该名字替换占位符。然后，它会向该用户发送个性化提示，“Vivian 您好，您想要什么配料？” 会话属性在会话存续期内一直存在。Amazon Lex V2 将它们存储在加密的数据存储中，直到会话结束。客户端可以在请求中通过调用[RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html)或[RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html)操作来创建会话属性，并将`sessionAttributes`字段设置为一个值。Lambda 函数可以在响应中创建会话属性。在客户端或 Lambda 函数创建会话属性后，只要客户端应用程序在向 Amazon Lex V2 发出的请求中不包含`sessionAttribute`字段，就会使用存储的属性值。 例如，假设您有两个会话属性 `{"x": "1", "y": "2"}`。如果客户端在未指定`sessionAttributes`字段的情况下调用`RecognizeText`或`RecognizeUtterance`操作，则 Amazon Lex V2 会使用存储的会话属性 `{"x": 1, "y": 2}` () 调用 Lambda 函数。如果 Lambda 函数不返回会话属性，则 Amazon Lex V2 会将存储的会话属性返回给客户端应用程序。 如果客户端应用程序或 Lambda 函数传递了会话属性，则 Amazon Lex V2 会更新存储的会话属性。传递现有值（例如 ` {"x": 2}`）将更新存储的值。如果您传递一组新的会话属性（如 `{"z": 3}`），将删除现有值而只保留新值。当传递空映射 `{}` 时，将擦除存储的值。 要向 Amazon Lex V2 发送会话属性，您需要创建属性 string-to-string映射。下面显示了如何映射会话属性： ``` { "attributeName": "attributeValue", "attributeName": "attributeValue" } ``` 对于 `RecognizeText` 操作，您可以使用 `sessionState` 结构的 `sessionAttributes` 字段将映射插入请求正文中，如下所示： ``` "sessionState": { "sessionAttributes": { "attributeName": "attributeValue", "attributeName": "attributeValue" } } ``` 对于 `RecognizeUtterance` 操作，您对映射进行 base64 编码，然后将其作为 `x-amz-lex-session-state` 标头的一部分进行发送。 如果要在会话属性中发送二进制或结构化数据，则必须先将该数据转换为简单字符串。有关更多信息，请参阅 [在 Lex V2 机器人中设置复杂属性](context-mgmt-complex-attributes.md)。 # 设置 Lex V2 机器人的请求属性 *请求属性*包含请求特定的信息，并仅应用于当前请求。客户端应用程序将此信息发送到 Amazon Lex V2。可以使用请求属性传递不需要在整个会话中保留的信息。您可以创建自己的请求属性，也可以使用预定义属性。要发送请求属性，请在 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 请求的 [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 或 `requestAttributes` 字段中使用 `x-amz-lex-request-attributes` 标头。由于请求属性不像会话属性那样在不同请求间保留，因此不会在 `RecognizeUtterance` 或 `RecognizeText` 响应中返回。 **注意** 要发送在请求间保留的信息，请使用会话属性。 ## 为每个 Lex V2 机器人请求设置用户定义的请求属性 *用户定义的请求属性*是您在每个请求中发送给自动程序的数据。可在 `RecognizeUtterance` 请求的 `amz-lex-request-attributes` 标头或 `RecognizeText` 请求的 `requestAttributes` 字段中发送信息。 要向 Amazon Lex V2 发送请求属性，您需要创建属性 string-to-string映射。下面显示了如何映射请求属性： ``` { "attributeName": "attributeValue", "attributeName": "attributeValue" } ``` 对于 `PostText` 操作，您可以使用 `requestAttributes` 字段将映射插入请求正文中，如下所示： ``` "requestAttributes": { "attributeName": "attributeValue", "attributeName": "attributeValue" } ``` 对于 `PostContent` 操作，您对映射进行 base64 编码，然后将其作为 `x-amz-lex-request-attributes` 标头发送。 如果您要在请求属性中发送二进制或结构化数据，必须先将该数据转换为简单字符串。有关更多信息，请参阅 [在 Lex V2 机器人中设置复杂属性](context-mgmt-complex-attributes.md)。 Amazon Lex V2 提供预定义请求属性，用于管理它对发送至机器人的信息的处理方式。这些属性不会在整个会话中保留，因此必须在每个请求中发送预定义属性。所有预定义属性都在 `x-amz-lex:` 命名空间中。 除了以下预定义属性之外，Amazon Lex 还提供消息收发平台的预定义属性。有关这些属性的列表，请参阅“在消息收发平台上部署 Amazon Lex 机器人”。 ## 设置响应类型 如果您有两个具有不同功能的客户端应用程序，则可能需要限制响应中的消息的格式。例如，您可能希望将发送到 Web 客户端的消息限制为纯文本，但使移动客户端能够同时使用纯文本和语音合成标记语言（SSML）。要设置`PostContent`和`PostText`操作返回的消息的格式，请使用 x-amz-lex:accept-content-types"request 属性。 您可以将此属性设置为以下消息类型的任意组合： + `PlainText`— 消息包含 UTF-8 纯文本。 + `SSML`— 消息包含为语音输出设置格式的文本。 + `CustomPayload`— 消息包含为您的客户端创建的自定义格式。您可以定义负载以满足应用程序的需要。 Amazon Lex V2 仅返回具有响应的消息字段中指定的类型的消息。您可以设置多个值，以逗号分隔这些值。如果您使用消息组，则每个消息组必须至少包含一个指定类型的消息。否则，您将收到 `NoUsableMessageException` 错误。有关更多信息，请参阅消息组。 ## 设置 Lex V2 机器人的预定义请求属性 Amazon Lex V2 提供预定义请求属性，用于管理它对发送至机器人的信息的处理方式。这些属性不会在整个会话中保留，因此必须在每个请求中发送预定义属性。所有预定义属性都在 `x-amz-lex:` 命名空间中。 ## 在 Lex V2 机器人中禁用意图开关 要控制在意图确认或插槽引发期间用户是否可以在意图之间切换，请使用 `x-amz-lex:intent-switch` 请求属性。如果设置为 `DISABLE`，则此属性会阻止用户在完成当前意图流的过程中触发另一个意图。 例如，如果用户正在预订航班，且系统提示输入航班详细信息，则系统会忽略“查看天气”或“预订酒店”之类的话语（通常可能会触发其他意图），从而确保对话的重点仍然集中在当前的预订流程上。 # 设置超时会话 Amazon Lex 保留上下文信息（插槽数据和会话属性），直到对话会话结束。要控制会话在自动程序中的持续时间，请设置会话超时。默认情况下，会话持续时间为 5 分钟，但您可以指定介于 0 到 1440 分钟（24 小时）之间的任何持续时间。 例如，假设您创建一个支持 `OrderShoes` 和 `GetOrderStatus` 等意图的 `ShoeOrdering` 机器人。当 Amazon Lex 检测到用户的意图是订购鞋子时，它会要求提供插槽数据。例如，要求提供鞋子尺码、颜色、品牌等。如果用户提供了一些槽数据，但未完成鞋子的购买，Amazon Lex 将在整个会话中记住所有槽数据和会话属性。如果用户在会话到期之前返回到会话，该用户可以提供其余槽数据并完成购买。 在 Amazon Lex V2 控制台中，您可以在创建机器人时设置会话超时。使用 AWS 命令行界面 (AWS CLI) 或 API，您可以通过设置 IdleS [ession Seconds 字段来设置使用该[CreateBot](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateBot.html)操作创建机器人时的超时TTLIn时间](https://docs.aws.amazon.com/lexv2/latest/dg/API_PutBot.html#API_CreateBot.html#lexv2-CreateBot-request-idleSessionTTLInSeconds)。 # 通过 Lex V2 机器人在意图之间共享信息 Amazon Lex V2 支持在意图之间共享信息。要在意图之间共享信息，请使用输出上下文或会话属性。 要使用输出上下文，请在创建或更新意图时定义输出上下文。履行意图时，来自 Amazon Lex V2 的响应将意图中的上下文和槽值作为上下文参数。您可以将这些参数用作后续意图、应用程序代码或 Lambda 函数的默认值。 要使用会话属性，您需要在 Lambda 或应用程序代码中设置这些属性。例如，`ShoeOrdering` 自动程序的用户从订购鞋子开始。该自动程序将与用户进行对话，收集槽数据，如鞋子尺寸、颜色和品牌。当用户下单时，履行订单的 Lambda 函数将设置 `orderNumber` 会话属性，其中包含订单号。要获取订单状态，用户可使用 `GetOrderStatus` 目的。自动程序可向用户询问槽数据，如订单号和订购日期。自动程序在获得所需的信息以后将返回订单状态。 如果您认为您的用户可能会在同一会话期间改换目的，则可将自动程序设计为返回最新订单的状态。您不必再向用户询问订单信息，而是使用 `orderNumber` 会话属性在不同目的间共享信息并实现 `GetOrderStatus` 目的。自动程序通过返回用户最后所下订单的状态完成此操作。 # 在 Lex V2 机器人中设置复杂属性 会话和请求属性是属性和值的 string-to-string映射。在许多情况下，您可以使用字符串映射在客户端应用程序与自动程序之间传输属性值。但在某些情况下，您可能需要传输无法轻易转换为字符串映射的二进制数据或复杂结构。例如，以下 JSON 对象表示由美国人口最多的三个城市组成的数组： ``` { "cities": [ { "city": { "name": "New York", "state": "New York", "pop": "8537673" } }, { "city": { "name": "Los Angeles", "state": "California", "pop": "3976322" } }, { "city": { "name": "Chicago", "state": "Illinois", "pop": "2704958" } } ] } ``` 这个数据数组不能很好地转换为 string-to-string地图。在这种情况下，您可以将对象转换为一个简单字符串，以便通过 [RecognizeText](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeText.html) 和 [RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html) 操作将其发送给自动程序。 例如，如果您正在使用 JavaScript，则可以使用`JSON.stringify`操作将对象转换为 JSON，使用`JSON.parse`操作将 JSON 文本转换为 JavaScript 对象： ``` // To convert an object to a string. var jsonString = JSON.stringify(object, null, 2); // To convert a string to an object. var obj = JSON.parse(JSON string); ``` 要通过`RecognizeUtterance`操作发送属性，在将属性添加到请求标头之前，必须对这些属性进行 base64 编码，如以下 JavaScript代码所示： ``` var encodedAttributes = new Buffer(attributeString).toString("base64"); ``` 您可以通过先将二进制数据转换为 base64 编码字符串、然后将该字符串作为会话属性中的值发送，来向 `RecognizeText` 和 `RecognizeUtterance` 操作发送二进制数据： ``` "sessionAttributes" : { "binaryData": "base64 encoded data" } ```