意向创建概述

• 为应用程序计划意向。

  请考虑客户可能希望执行的操作以及希望应用程序能够代表客户处理的内容。 例如，您可能希望应用程序帮助客户购物。 为此，可以添加 #buy_something 意向。 （添加为意向名称前缀的 # 用于帮助明确将其标识为意向。）

• 向 watsonx Assistant 传授有关意向的信息。

  在决定希望应用程序为客户处理哪些业务请求之后，必须向 watsonx Assistant 传授这些请求。 对于每个业务目标（例如，#buy_something），必须提供客户通常用于指示其目标的至少 5 条话语示例。 例如， I want to make a purchase.

  理想情况下，请查找现实世界用户话语示例，这可以从现有业务流程中进行抽取。 根据您的特定业务定制用户示例。 例如，如果您是一家保险公司，那么用户示例可能更类似于：I want to buy a new XYZ insurance plan.

  助手使用您提供的示例来构建机器学习模型，该模型可以识别相同和相似类型的话语，并将其映射到相应的意向。

首先从几个意向开始，并在以迭代方式扩大应用程序的作用域时，对这些意向进行测试。

创建意向

1. 单击 意向。

2. 选择创建意向。

3. 在意向名称字段中，输入意向的名称。

   • 意向名称可以包含字母（Unicode 格式）、数字、下划线、连字符和句点。
   • 名称不能由 .. 或仅由句点组成的任何其他字符串组成。
   • 意向名称不能包含空格，并且不能超过 128 个字符。 下面是意向名称的示例：
     • #weather_conditions
     • #pay_bill
     • #escalate_to_agent

   意向名称中自动包含数字符号 # 前缀，以帮助将术语标识为意向。 您无需添加该符号。

   请在“试用”窗格和对话日志中尽可能短的名称以实现可读性。

   （可选）在描述字段中添加意向的描述。

4. 选择创建意向以保存意向名称。

   

5. 在用户示例字段中，输入意向的用户示例的文本。 示例可以是最大长度为 1,024 个字符的任意字符串。 以下话语是可能的 #pay_bill 意向示例：

   • I need to pay my bill.
   • Pay my account balance
   • make a payment

   要了解有关在用户示例中包含对实体的引用所产生影响的信息，请参阅如何处理实体引用。

   当应用程序与 watsonx Assistant交互时，可以在 URL 中显示意向名称和示例文本。 因此不要在这些工件中包含敏感或个人信息。

6. 单击添加示例以保存用户示例。

   

7. 重复同一过程以添加更多示例。

   为每个意向至少提供 5 个示例。

8. 完成添加示例后，单击关闭箭头 以完成创建意向。

系统会根据您添加的意向和用户示例来训练自身。

重要信息：

• 意向示例数据应该是用户提供的数据中具有代表性和典型性的数据。 可以从实际的用户数据中收集示例，也可以从您的特定领域的专家收集示例。 重要的是数据准确且具有代表性。
• 训练和测试数据（用于评估目的）都应该反映出在实际使用中意向的分布情况。 通常，更频繁的意向具有的示例相对较多，并且响应覆盖范围更好。
• 您可以在示例文本中包含标点符号 (如果它自然出现)。 如果您认为有些用户会使用包含标点符号的示例来表达他们的意向，但有些用户不会这样做，请包含有标点符号和无标点符号这两种版本。 通常，各种模式的覆盖范围越广，响应越好。

如何处理实体引用

在用户示例中包含实体提及项时，在以下场景中机器学习模型会以不同的方式使用这些信息：

• 在意向示例中引用实体值和同义词
• 注释的提及项
• 在意向示例中直接引用实体名称

在意向示例中直接引用实体名称

这是高级方法。 如果使用此方法，那么必须以一致的方式使用。

您可以选择在意向示例中直接引用实体。 例如，假设您有一个名为 @PhoneModelName 的实体，其中包含值 Galaxy S8，Moto Z2，LG G6和 Google Pixel 2。 创建意向 (例如，#order_phone) 时，可以按如下所示提供训练数据:

• 能为我提供 @PhoneModelName 吗？
• 请帮我订购 @PhoneModelName。
• @PhoneModelName 有货吗？
• 将 @PhoneModelName 添加到我的订单。

目前，您只能直接引用定义的同义词实体（将忽略模式值）。 不能使用系统实体。

如果选择在训练数据中的@PhoneModelName任意位置引用实体作为意向示例（例如，），那么将取消在其他任何位置的意向示例中使用直接引用的值（例如，Galaxy S8）。 随后，所有意向都将使用“引用实体作为意向示例”的方法。 您不能仅针对特定意向应用此方法。

实际上，这意味着如果先前已经基于直接引用 (Galaxy S8) 训练了大部分意向，而现在将实体引用 (@PhoneModelName) 仅用于一个意向，此更改会影响您先前的训练。 如果您确实要选择使用 @Entity 引用，那么必须将所有先前的直接引用都替换为 @Entity 引用。

使用已定义 10 个值的 @Entity 来定义一个示例意向并不等同于指定该示例意向 10 次。 watsonx Assistant 服务不会为这样的一个示例意向语法授予这么大的权重。

测试意向

完成创建新意向后，您可以测试系统以查看其是否按预期识别您的意向。

1. 单击试用。

2. 在“试用”窗格中，输入问题或其他文本字符串，然后按 Enter 键以查看识别到的意向。 如果识别到的意向不正确，那么将此文本作为示例添加到正确的意向，以改进模型。

   如果您最近对技能进行了更改，那么可能会看到一条消息，指示系统仍在重新培训。 如果看到此消息，请等待训练完成后再进行测试：

   响应指示从输入中识别到的意向。

   

3. 如果系统未识别到正确的意向，您可以对其进行更正。 要更正识别的意向，请选择显示的意向，然后从列表中选择正确的意向。 提交更正后，系统会自动重新自我训练以包含新数据。

   

4. 如果输入与应用程序中的任何意向都无关，那么可以通过选择显示的意向，然后单击标记为不相关，从而指导助手学习这一点。

   

如果未正确识别意向，请考虑进行以下类型的更改：

• 将未识别到的文本作为示例添加到正确的意向。
• 将现有示例从一个意向移动到另一个意向。
• 请考虑您的意向是否过于相似，然后重新定义这些意向。

绝对评分

watsonx Assistant 服务会对每个意向的置信度独立评分，而不是相对于其他意向进行评分。 此方法增加了灵活性；可以在单个用户输入中检测多个意向。 同时，这也意味着系统可能根本不返回意向。 如果最热门意向的置信度分数较低（小于 0.2），那么虽然 API 返回的意向数组中仍会包含该最热门意向，但不会触发以该意向为条件的任何节点。 如果要检测没有检测到具有良好置信度分数的任何意向的情况，请在对话节点中使用 irrelevant 特殊条件。

意向置信度分数更改时，对话可能需要重构。 例如，如果对话节点在其条件中使用了意向，并且意向的置信度分数开始持续低于 0.2，那么将停止处理该对话节点。 如果置信度分数更改，那么该对话的行为也可能随之更改。

意向限制

可以创建的意向数和示例数取决于 watsonx Assistant 套餐类型：

编辑意向

可以单击列表中的任何意向以将其打开进行编辑。 可以进行以下更改：

• 重命名意向
• 删除意向
• 添加，编辑或删除示例
• 将示例移至其他意向

要移动或删除示例，请单击与该示例关联的复选框，然后单击移动或删除。

搜索意向

使用“搜索”功能查找用户示例、意向名称和描述。

1. 从“意向”页面中，单击“搜索”图标 。

2. 提交搜索项或搜索短语。 您还可以选择 包括部分匹配。

   第一次搜索某个内容时，可能会收到一条消息，指出正在对内容建立索引。 如果是这样，请稍等片刻，然后重新提交搜索项。

   这将显示包含搜索项的意向。

   

下载意向

您可以将多个意向下载到 CSV 文件，这样就可以在另一个 watsonx Assistant 应用程序中上载并复用这些意向。

1. 转至意向页面。

• 要下载所有意向 (表示此页面和任何其他页面上列出的意向)，请不要选择任何单独的意向。 而是单击 下载所有意向 图标 。

• 要仅下载当前页面上列出的意向，请选中标题中的复选框。 此操作将选中当前页面上的所有意向。 然后，单击 下载 按钮。

• 要下载一个或多个特定意向，请选择要下载的意向，然后单击 下载 按钮。

1. 指定要在其中存储生成的 CSV 文件的名称和位置，然后单击 保存。

上载意向和示例

如果您有许多意向和示例，那么从逗号分隔值 (CSV) 文件上载这些意向和示例可能比逐个定义这些意向和示例更容易。 确保从文件中包含的用户示例中除去任何个人数据。

1. 将意向和示例收集到 CSV 文件中，或将其从电子表格导出为 CSV 文件。 文件中每一行的必需格式如下所示：

   <example>,<intent>
   

   其中 <example> 是用户示例的文本，<intent> 是您希望示例匹配的意向的名称。 例如：

   Tell me the current weather conditions.,weather_conditions
   Is it raining?,weather_conditions
   What's the temperature?,weather_conditions
   Where is your nearest location?,find_location
   Do you have a store in Raleigh?,find_location
   

   **重要信息：**以 UTF-8 编码保存 CSV 文件，并且无字节顺序标记 (BOM)。

2. 从“意向”页面中，单击 上载意向 图标 。

3. 拖动文件或浏览以从计算机中选择文件。

   重要信息：最大 CSV 文件大小为 10 MB。 如果 CSV 文件较大，请考虑将其拆分为多个文件并单独上载。

4. 单击 上载意向。

   将验证并上载该文件，并且系统会对新数据进行自身训练。

您可以在 意向 选项卡上查看已上载的意向和相应的示例。 您可能需要刷新页面才能看到新意向和示例。

删除意向

可以选择多个意向进行删除。

通过删除您还在删除所有关联示例的意向，以后无法检索这些项。 所有引用这些意向的对话节点都必须手动更新为不再引用已删除的内容。

1. 转至意向页面

   • 要删除所有意向，即此页面和任何其他页面上列出的意向，请不要选择任何单独的意向。 请改为单击 删除所有意向 图标。

   • 要仅删除当前页面上列出的意向，请选中标题中的复选框。 此操作将选中当前页面上列出的所有意向。 单击删除。

   • 要删除一个或多个特定意向，请选择要删除的意向，然后单击删除。