创建并编辑主题

主题类型

智能体可以拥有两种类型的主题：系统和自定义主题。 每个新代理都从一组预定义的系统主题和自定义主题开始。

• 系统主题支持基本行为，例如与某人交谈或结束对话的自定义请求。 一些系统主题有触发短语，您可以根据代理的需求进行定制。

  • 您无法创建系统主题。
  • 您不能删除系统主题，但可以禁用它们。
  • 您可以更改系统主题。 但是，在您习惯创建完整的代理体验之前，我们不建议您编辑系统主题。

  有关详细信息，请参阅使用系统主题。

• 预定义的自定义主题涵盖常见行为，如问候客户、结束对话或重新启动对话。

  • 您可以更改预定义的自定义主题，或将其彻底从代理中删除。
  • 您创建的所有主题都是自定义主题。

节点类型

以下是可用的节点类型：

创建主题

1. 转到代理的主题页面。 为了获得更好的可见性，请暂时关闭测试面板。

2. 选择添加主题，然后选择从空白。

   触发器节点出现在空白的主题创作画布上。

3. 选择触发器节点的更多图标 (…)，然后选择属性。 将显示识别的意图属性面板。

4. 在识别的意图属性中，选择短语区域。 此时会出现短语二级面板。

5. 在添加短语下，为您的主题输入一个触发短语。

   您的代理需要 5 到 10 个触发短语来训练 AI 理解您的客户的回复。 若要添加更多触发短语，您可以：

   • 选择文本字段旁边的添加图标，并输入所需的短语。
   • 粘贴一组触发短语，每个短语单独一行，然后选择输入。
   • 键入一组触发短语，在每个短语后按 Shift+Enter，将其放在单独的一行上，然后选择Enter。
   • 上传文件列出要为此主题添加的触发短语。

   您可以在触发短语中包含标点符号，但最好使用短句而不是长句。

6. 选择工具栏上的详细信息，打开主题详细信息面板。

7. 为您的主题添加详细信息：

   • 输入名称以标识主题，如“商店营业时间”。主题页面按名称列出了您的代理中定义的所有主题。
   • 如果需要，输入显示名称，在代理无法确定与客户的邮件匹配的主题时显示给客户。
   • 如有需要，使用描述字段为您自己和团队中的其他代理制作者描述主题的目的。 客户永远不会看到主题描述。

8. 选择顶部菜单栏上的保存，保存您的主题。

上传主题的触发短语

在主题的触发器节点的短语面板中，您可以添加或替换与主题相关的触发短语集。

1. 准备一个文本文件（最大 3 MB），列出要为主题添加的所有触发短语，每个短语都放在单独的行上。

2. 在添加短语下，选择上传文件。

3. 在上传文件中，选择所需的选项：

   • 如果要为主题添加新的触发词组，请选择添加。
   • 要使用文件中的列表替换所有现有触发短语，请选择替换。

4. 将文件拖放到窗口上。 或者，选择单击浏览，导航到文件并将其选中。

5. 查看出现的触发短语，然后选择添加。

6. 保存您的主题。

下载主题的触发短语

在主题触发器节点的短语面板中，可以下载与主题相关的触发短语集。

1. 在添加短语下，选择下载。

2. 保存生成的文本文件，或在文本编辑器中打开查看其内容。 每个触发短语都显示在单独的行上。

设计主题对话路径

创建主题时，触发器节点会自动出现在创作画布上。 然后，您可以添加不同类型的节点，实现您的主题所需的对话路径。

要在主题创作画布上的另一个节点之后或两个节点之间添加节点：

1. 选择您要在其下添加新节点的节点下方的添加节点图标。

2. 从出现的列表中选择所需的节点类型。

   

删除注释

选择您要删除的节点的更多图标 (…)，然后选择删除。

用于编辑区域上的节点的控件

可以使用工具栏上的控件剪切、复制、粘贴和删除选定节点或选定相邻节点。

工具栏还有一个撤销编辑的控件。 打开撤消菜单，将所有操作恢复到上次保存的状态，或重做上一个操作。

粘贴节点

使用剪切或复制工具将一个或多个节点放入剪贴板后，有两种方法可以将它们粘贴到画布中：

• 如果选择某个节点，然后选择粘贴，则剪贴板上的节点会插入到所选节点之后。

• 如果您选择“+”来查看添加节点菜单，然后选择粘贴，剪贴板上的节点将插入到该位置。

为主题添加输入和输出参数

主题可以有输入和输出参数。 当主题重定向到另一个主题时，您可以使用这些参数在主题之间传递信息。

此外，如果您的代理使用生成式模式，它可以从对话上下文中自动填充主题输入，或者在生成问题后从用户那里收集值。 此行为类似于操作的生成式时隙填充的工作方式。

要了解有关主题输入和输出参数的更多信息，请参阅管理主题输入和输出。

使用代码编辑器编辑主题

代码编辑器在 YAML 中显示主题，这是一种易于读取和理解的标记语言。 使用代码编辑器复制和粘贴来自其他机器人的主题，甚至是其他作者创建的主题。

在本例中，您将 YAML 复制并粘贴到代码编辑器中，以快速添加一个向客户询问运输信息的主题。

1. 在主题页面上，选择创建>从空白。

2. 在创作画布的右上角，选择更多，然后选择打开代码编辑器。

   

3. 选择并删除代码编辑器的内容。 然后复制并粘贴以下 YAML 代码：

   kind: AdaptiveDialog
   beginDialog:
     kind: OnRecognizedIntent
     id: main
     intent:
       displayName: Lesson 3 - A topic with a condition, variables and a prebuilt entity
       triggerQueries:
         - Buy items
         - Buy online
         - Buy product
         - Purchase item
         - Order product
   
     actions:
       - kind: SendMessage
         id: Sjghab
         message: I am happy to help you place your order.
   
       - kind: Question
         id: eRH3BJ
         alwaysPrompt: false
         variable: init:Topic.State
         prompt: To what state will you be shipping?
         entity: StatePrebuiltEntity
   
       - kind: ConditionGroup
         id: sEzulE
         conditions:
           - id: pbR5LO
             condition: =Topic.State = "California" || Topic.State = "Washington" || Topic.State     = "Oregon"
   
         elseActions:
           - kind: SendMessage
             id: X7BFUC
             message: There will be an additional shipping charge of $27.50.
   
           - kind: Question
             id: 6lyBi8
             alwaysPrompt: false
             variable: init:Topic.ShippingRateAccepted
             prompt: Is that acceptable?
             entity: BooleanPrebuiltEntity
   
           - kind: ConditionGroup
             id: 9BR57P
             conditions:
               - id: BW47C4
                 condition: =Topic.ShippingRateAccepted = true
   
             elseActions:
               - kind: SendMessage
                 id: LMwySU
                 message: Thank you and please come again.
   

4. 选择保存，然后选择关闭代码编辑器。 问题节点现在有许多关于运输的条件。

   

测试并发布您的代理

对您的主题进行更改时，请测试您的代理，以确保一切按预期运行。

在您设计并测试您的代理后，将其发布到网络、移动或本地应用程序，或 Microsoft Bot Framework 渠道。

使用系统和示例主题

创建机器人时，会为您创建几个主题。

这些自动创建的主题分为两类：

• 课程主题可帮助您了解使用节点创建机器人对话的简单到复杂的方法。

  您可以编辑课程主题或将其整个删除。

• 系统主题是您在机器人对话期间可能需要的主题。

  您不能删除或禁用系统主题或编辑其触发短语。 但是，您可以在创作画布上自定义节点。 我们建议您在熟悉创建端到端机器人对话之前不要自定义这些主题。

创建主题

1. 从导航菜单中选择主题，然后选择新建主题，再选择从空白。

   触发短语窗格打开。

2. 在添加短语部分为您的主题添加几个触发短语。

   

   您可以为一个主题指定多个触发短语，每个短语占一行。 您可以在触发短语中包含标点符号，但最好使用短句而不是长句。

3. 在顶部栏中，编辑您的主题的标题，为其命名。

   

4. 按 Enter 或选择保存图标保存您的更改。

5. 选择详细信息图标。 您也可以在这里编辑名称，并添加显示名称和描述。

   显示名称告诉机器人用户在询问哪个主题。

   描述向您和其他机器人制作者描述了主题的目的。 此描述不会显示给用户。

   

6. 选择保存将主题添加到主题列表中。

设计主题的对话路径

1. 在主题列表中，选择要编辑的主题。 您会看到该主题的触发短语。 在这里，您可以定义客户和代理之间的对话路径。

   对于现有或系统主题，会自动创建多个节点。 您可以像编辑其他节点一样编辑这些节点。

   创建新主题时，将为您插入触发节点和空白的消息节点。

2. 要添加节点，请选择位于节点之间或之后的“+”、添加节点。

   

3. 若要更改节点之间的路径，请将节点顶部的小圆圈（其节点定位点）拖到画布中的新位置。 虚线表示原始路径。

   

插入节点

当您在触发短语节点之后或消息节点之间添加节点时，您可以：

• 提出问题
• 调用操作
• 显示消息
• 将对话重定向到另一个主题
• 结束对话

提出问题

1. 选择“+”添加节点菜单中的提问选项，添加一个新的问题节点。 出现一个问题节点。

   

2. 在提问字段中输入问题短语。

   例如，如果用户想知道商店营业时间，机器人的问题可能是您需要哪个商店位置？

3. 在标识下，为用户的回答选择一个选项，例如多选选项。

   该选项决定了用户回复时机器人应该听取什么。 有关详细信息，请参阅在对话中使用实体。

4. 在用户选项下，输入对机器人问题的预期回复。

   例如，如果您在标识中选择了多选选项，这些选项可能包括商店位置，如西雅图、贝尔维尤或柯克兰。

   

   在聊天中，每个选项都以多选按钮的形式呈现给用户，但用户也可以键入他们的答案。

5. （可选）将用户回复保存在变量中供以后使用。

对话编辑器在对话中创建单独的路径，具体取决于客户的响应。 对话路径将客户引导到每个回复的适当解决方法。 您可以添加节点来创建分支逻辑，并指定机器人应该对每个路径或变量做出什么回复。

调用操作

要调用 Power Automate 流程和插入身份验证节点，请从“+”添加节点菜单中选择调用操作。

如果您的机器人启用了基于语音的功能，您会看到更多操作。

显示消息

1. 要指定机器人的回复，请选择“+”添加节点以添加节点，然后选择显示消息以添加新的消息节点。

2. 在文本框中输入您希望机器人说的内容。

   可以应用一些基本格式设置，例如粗体、斜体、已排序和无排序表以及超链接。 您还可以使用您在机器人对话中其他地方定义的变量。

重定向到其他主题

1. 要让机器人移动到不同的主题，请选择“+”添加节点以添加节点，然后选择重定向到另一个主题。 将出现主题列表。

2. 选择机器人应该转移到的主题。 例如，如果用户询问商店的营业时间，您可能会将他们发送到有关商店关门的主题。

   

重定向的主题是子主题。

您可以在子主题的节点下插入更多节点。

当子主题的对话路径结束时，机器人返回到原始主题。 然后，机器人跟踪子主题节点下的节点。

但是，如果您重定向到这些系统主题中的任何一个，整个对话就会结束。

• 对话结束
• 确认成功
• 确认失败
• 再见
• 上报
• 从头开始（还将重置所有全局变量）

结束对话

当对话结束时，您可以进行调查，询问用户他们的问题是否得到解答或解决。 回复将在客户满意度分析页面上收集。

如果在使用适合的客户服务门户（如 Customer Service 全渠道），也可以将对话转交给人工代理。

在解决用户问题或回答问题的回复的末尾，添加一个结束对话节点。

• 若要使用客户满意度调查结束，请选择使用调查结束。

• 要插入与您的配置的转接产品链接的转接节点，请选择转接到代理。

  （可选）输入给代理的私人消息。

  

添加条件

1. 要添加基于变量的分支逻辑，请选择“+”添加节点来添加节点。

2. 选择添加条件。

3. 选择基于条件的分支。

4. 选择决定机器人对话是否应在此时分支的变量。

   例如，如果您设置了用户身份验证，您可能希望在用户登录时收到不同的消息。

删除节点

选择您要删除的节点的菜单图标 (⋮)，然后选择删除。

测试和发布机器人

对主题进行更改时，测试您的代理，以确保一切按预期运行。

在您设计并测试您的机器人后，将其发布到网络、移动或本地应用程序，或 Microsoft Bot Framework 渠道。

设计主题的对话路径 - Teams

1. 在代理的主题列表中，选择要编辑的主题。 例如，您可能希望编辑主题商店营业时间。

   

   一旦打开，您会看到主题的触发短语。 在此创作画布上，您可以定义客户和机器人之间的对话路径。

   创建新主题时，会为您插入一个触发短语节点和一个空白的消息节点。

   对于现有主题或系统主题，每个新主题都会自动创建几个节点。 如果需要，您可以编辑这些节点。

2. 您可以通过选择“+”在节点之间或节点之后添加节点来添加更多节点。

   

3. 要更改节点之间的路径，请拖动节点定位点（节点顶部的小圆圈）。 您会看到一条指示原始路径的虚线。

   

插入节点 - Teams

向触发短语节点添加节点时，从五个不同选项中进行选择：

• 提出问题
• 调用操作
• 显示消息
• 重定向到其他主题
• 结束对话

如果要重定向某个主题，可以转到另一个主题。

提出问题 - Teams

1. 选择“+”添加节点菜单中的提问选项，添加一个新的问题节点。 出现一个问题节点。

   

2. 在提问字段中输入问题短语。

   例如，如果用户想知道商店营业时间，机器人的问题可能是您需要哪个商店位置？

3. 在标识下，为用户的回答选择一个选项，例如多选选项。

   该选项决定了用户回复时机器人应该听取什么。 有关详细信息，请参阅在对话中使用实体。

4. 在用户选项下，输入对机器人问题的预期回复。

   例如，如果您在标识中选择了多选选项，这些选项可能包括商店位置，如西雅图、贝尔维尤或柯克兰。

   

   在聊天中，每个选项都以多选按钮的形式呈现给用户，但用户也可以键入他们的答案。

5. （可选）将用户回复保存在变量中供以后使用。

对话编辑器在对话中创建单独的路径，具体取决于客户的响应。 对话路径将客户引导到每个回复的适当解决方法。 可以添加节点以创建分支逻辑，并为每个路径或值指定机器人应采取的响应内容。

添加条件 - Teams

在某些节点类型上，您可以添加一个条件。

1. 要添加基于变量的分支逻辑，请选择“+”添加节点菜单，然后选择添加条件添加新节点。 将出现几个条件节点。

2. 选择要用于确定机器人对话是否应在此时分支的变量。

   

调用操作 - Teams

通过在“+”添加节点菜单中选择调用操作，您可以调用 Power Automate 流。

显示消息 - Teams

消息可以指定您的机器人对用户的回复。

1. 选择“+”添加节点菜单，然后选择显示消息以添加新的消息节点。

2. 输入机器人要在文本框中说出的内容。 可以应用一些基本格式设置，例如粗体、斜体、已排序和无排序表以及超链接。

   您还可以使用您在机器人对话中其他地方定义的变量。

结束对话 - Teams

您可以选择结束对话作为机器人对话的最终节点。

有两个选项：

• 结束时开展调查显示一项调查，询问用户他们的问题是否得到了正确回答或解决。 此信息收集在客户满意度分析页下。

  

• 转接给代理允许您向代理发送私密消息，以启动他们与用户的联系。

重定向到其他主题 - Teams

要自动让机器人移动到单独的主题，选择添加节点 (+) 添加一个节点，然后选择重定向到其他主题。

在弹出项目菜单中，选择机器人应该转向的主题。 例如，您可能希望在用户询问某家商店的营业时间时，将该用户发送到有关该商店节假日的特定主题。

当机器人转到其他主题时，机器人会遍历该主题的对话路径，然后返回到最初的主题—即离开之处。

您可以将重定向的主题视为子主题。

但是，如果您重定向到以下任何系统主题，整个对话就会结束：

• 重新开始（重置任何全局变量）
• 升级
• 对话结束
• 确认失败
• 确认成功
• 再见

使用变量

您可以使用您在机器人对话中其他地方定义的变量。

删除节点 - Teams

选择您要删除的节点的菜单图标 (⋮)，然后选择删除。

测试并发布您的机器人 - Teams

更改主题后，测试您的代理，确保一切按预期运行。

完成机器人的设计和测试后，您可以发布，以便其他团队成员可以使用。