本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 设置 Lex V2 机器人的请求属性
<a name="context-mgmt-request-attribs"></a>

*请求属性*包含请求特定的信息，并仅应用于当前请求。客户端应用程序将此信息发送到 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 机器人请求设置用户定义的请求属性
<a name="context-mgmt-user"></a>

*用户定义的请求属性*是您在每个请求中发送给自动程序的数据。可在 `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 机器人”。

## 设置响应类型
<a name="response-type-context"></a>



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

您可以将此属性设置为以下消息类型的任意组合：
+ `PlainText`— 消息包含 UTF-8 纯文本。
+ `SSML`— 消息包含为语音输出设置格式的文本。
+ `CustomPayload`— 消息包含为您的客户端创建的自定义格式。您可以定义负载以满足应用程序的需要。

Amazon Lex V2 仅返回具有响应的消息字段中指定的类型的消息。您可以设置多个值，以逗号分隔这些值。如果您使用消息组，则每个消息组必须至少包含一个指定类型的消息。否则，您将收到 `NoUsableMessageException` 错误。有关更多信息，请参阅消息组。

## 设置 Lex V2 机器人的预定义请求属性
<a name="setting-predefined-request-attributes"></a>

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

## 在 Lex V2 机器人中禁用意图开关
<a name="disabling-intent-switches-attributes"></a>

要控制在意图确认或插槽引发期间用户是否可以在意图之间切换，请使用 `x-amz-lex:intent-switch` 请求属性。如果设置为 `DISABLE`，则此属性会阻止用户在完成当前意图流的过程中触发另一个意图。

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