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

# 示例言语
<a name="sample-utterances"></a>

您可以创建示例言语，这些言语是您预期用户用于发起意图的短语的变体。例如，对于 **BookFlight** 意图，您可以包括以下言语：

1. 我想预订航班

1. 帮我预定航班

1. 我需要预定航班机票

1. 从 {{{DepartureCity}}} 到 {{{DestinationCity}}} 的航班

您应提供 10 个或更多示例言语。提供相应的示例以表示用户可能说出的各种句子结构和单词。也可以考虑不完整的句子，例如以上的示例 3 和示例 4。您也可以使用您在示例言语中为意图定义的槽位，方法是在槽位名称前后添加花括号，如示例 4 中的 {{{DepartureCity}}} 所示。如果您在示例言语中包含槽位名称，Amazon Lex V2 会使用用户在言语中提供的值来填充意图的槽位。

各种示例言语可帮助 Amazon Lex V2 进行归纳，从而有效地识别出用户想要发起意图。

您可以在意图编辑器、可视化对话生成器中或通过 [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) 或 [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html) API 操作来添加示例言语。您还可以利用 Amazon Bedrock 的生成式人工智能功能自动生成示例言语。有关更多信息，请参阅 [使用言语生成功能生成用于意图识别的示例言语](utterance-generation.md)。

**使用意图编辑器或可视化对话生成器**

1. 在意图编辑器中，导航到**示例言语**部分。在可视化对话生成器中，在**开始**块中找到**示例言语**部分。

1. 在带有透明文本 **I want to book a flight** 的框中，键入示例言语。选择**添加话语**以添加言语。

1. 查看您在**预览**或**纯文本**模式下添加的示例言语。在**纯文本**中，每行都是单独的言语。在**预览模式下**，将鼠标悬停在言语上可显示以下选项：
   + 选择文本框以编辑该言语。
   + 选择文本框右侧的 x 按钮可删除该言语。
   + 拖动文本框左侧的按钮可更改示例言语的顺序。

1. 使用顶部的搜索栏搜索您的示例言语，使用旁边的下拉菜单按您添加言语的顺序或者按字母顺序进行排序。

**使用 API 操作**

1. 使用 [CreateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_CreateIntent.html) 操作创建新意图，或者使用 [UpdateIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UpdateIntent.html) 操作更新现有意图。

1. API 请求包含一个 `sampleUtterances` 字段，该字段映射到 [SampleUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_SampleUtterance.html) 对象数组。

1. 对于每个要添加的示例言语，请向该数组添加 `SampleUtterance` 对象。将示例言语添加为 `utterance` 字段的值。

1. 要编辑和删除示例言语，请发送 `UpdateIntent` 请求。您在 `sampleUtterances` 字段中提供的言语列表将替换现有的言语。
**重要**  
您在 `UpdateIntent` 请求中留空的任何字段都将导致意图中的现有配置被删除。使用 [DescribeIntent](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_DescribeIntent.html) 操作返回机器人配置，并将您不想删除的所有配置复制到 `UpdateIntent` 请求中。