设置 Lex V2 机器人的请求属性 - Amazon Lex
为每个 Lex V2 机器人请求设置用户定义的请求属性设置响应类型设置 Lex V2 机器人的预定义请求属性在 Lex V2 机器人中禁用意图开关

设置 Lex V2 机器人的请求属性

请求属性包含请求特定的信息，并仅应用于当前请求。客户端应用程序会将此信息发送给 。可以使用请求属性传递不需要在整个会话中保留的信息。您可以创建自己的请求属性，也可以使用预定义属性。要发送请求属性，请使用 RecognizeUtterance 的 x-amz-lex-request-attributes 标头或 RecognizeText 请求中的 requestAttributes 字段。由于请求属性不像会话属性那样在不同请求间保留，因此不会在 RecognizeUtterance 或 RecognizeText 响应中返回。

注意

要发送在请求间保留的信息，请使用会话属性。

为每个 Lex V2 机器人请求设置用户定义的请求属性

用户定义的请求属性是您在每个请求中发送给自动程序的数据。可在 amz-lex-request-attributes 请求的 RecognizeUtterance 标头或 requestAttributes 请求的 RecognizeText 字段中发送信息。

要向 发送请求属性，请创建属性的字符串到字符串映射。下面显示了如何映射请求属性：

{
   "attributeName": "attributeValue",
   "attributeName": "attributeValue"
}

对于 PostText 操作，您可以使用 requestAttributes 字段将映射插入请求正文中，如下所示：

"requestAttributes": {
   "attributeName": "attributeValue",
   "attributeName": "attributeValue"
}

对于 PostContent 操作，您对映射进行 base64 编码，然后将其作为 x-amz-lex-request-attributes 标头发送。

如果您要在请求属性中发送二进制或结构化数据，必须先将该数据转换为简单字符串。有关更多信息，请参阅 在 Lex V2 机器人中设置复杂属性。

Amazon Lex V2 提供预定义请求属性，用于管理它对发送至机器人的信息的处理方式。这些属性不会在整个会话中保留，因此必须在每个请求中发送预定义属性。所有预定义属性都在 x-amz-lex: 命名空间中。

除了以下预定义属性之外，Amazon Lex 还提供消息收发平台的预定义属性。有关这些属性的列表，请参阅“在消息收发平台上部署 Amazon Lex 机器人”。

设置响应类型

如果您有两个具有不同功能的客户端应用程序，则可能需要限制响应中的消息的格式。例如，您可能希望将发送到 Web 客户端的消息限制为纯文本，但使移动客户端能够同时使用纯文本和语音合成标记语言（SSML）。要设置 PostContent 和 PostText 操作返回的消息的格式，请使用 x-amz-lex:accept-content-types 请求属性。

您可以将此属性设置为以下消息类型的任意组合：

  • 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，则此属性会阻止用户在完成当前意图流的过程中触发另一个意图。

例如，如果用户正在预订航班，且系统提示输入航班详细信息，则系统会忽略“查看天气”或“预订酒店”之类的话语（通常可能会触发其他意图），从而确保对话的重点仍然集中在当前的预订流程上。