创建和编辑主题

在 Copilot Studio 中，主题定义了智能体对话的进展方式。

要创建主题，您可以描述您想要的内容，然后让人工智能为您创建主题，或者从头开始创建主题。

有关智能体和主题限制的更多信息，请参阅配额、限制、应用程序注册、证书和配置值。

选择正确的主题来响应用户

若要确定如何响应用户，代理使用 生成编排 或经典编排。

使用 生成编排，代理通过选择最适当的主题、动作和知识组合来回答用户查询或响应事件触发器。 每个主题都有一个描述，告知智能体其用途。 了解有关撰写描述的更多信息。

在配置为使用经典协调的智能体中，每个主题都有一组触发短语 - 客户可能用于查询特定问题的短语、关键词和问题。 这些代理使用自然语言理解、客户的消息和主题的触发短语来查找最佳主题。 客户输入不需要完全匹配主题触发短语即可触发主题。 例如，有关商店营业时间的主题可能具有触发短语“检查商店营业时间”。如果客户输入“查看商店营业时间”，此短语将触发您的商店营业时间主题。 了解有关编写触发短语的更多信息。

Copilot Studio 中的主题

在 Copilot Studio 中， 主题 表示用户和代理之间的对话的一部分。 在 创作画布 上定义主题。主题包含一个或多个 节点，这些节点 共同确定主题可以采用的对话路径。 每个节点都执行一个操作，如发送消息或提出问题。

Web 应用

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

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

  • 您无法创建系统主题。
  • 无法删除系统主题，但可以将其关闭。
    • 您可以更改系统主题。 但是，在开始编辑系统主题之前，应等到你熟悉如何创建完整的代理体验。

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

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

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

经典/团队

创建机器人时，Copilot Studio 会为你生成多个主题。 自动创建的主题分为以下类别：

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

  可以编辑课程主题或删除它们。

• 系统主题 是机器人对话期间所需的主题。

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

注释

建议主题（旧版）

在现已弃用的主题建议功能的聊天机器人中，建议的主题可能仍处于待审查状态。 可以在代理的“主题”列表中单独的“建议主题”选项卡上看到这些主题。 可查看这些主题并根据需要添加至聊天机器人。

节点类型

可以使用以下类型的节点。

Web 应用

节点类型	描述
信息节点	给客户发送消息。
问题节点	向客户提问。
自适应卡片节点	显示包含一个或多个响应按钮或输入字段的交互式卡片。
条件 节点	根据条件转移对话。
变量管理节点	设置值、分析值或清除变量（包括清除智能体使用的对话历史记录的功能）。
主题管理	重定向对话、转移用户或结束主题或对话。
工具 节点	调用 Power Automate 或 Excel Online 等流，或使用连接器或其他类型的工具。
高级	发送生成式答案、HTTP 请求、事件等等。

提示

重命名节点，使其更容易识别。 选择节点的名称字段以直接更新名称，或者选择节点的更多图标 (…)，然后从菜单中选择重命名。 您也可以在代码编辑器中重命名节点。

无法重命名触发器节点和转到步骤节点。

节点名称最长可达 500 个字符。

经典/团队

节点类型	描述
问题节点	向客户提问。
条件 节点	根据条件转移对话。 仅在可用变量的主题中可用。
工具 节点	调用 Power Automate 流。
信息节点	给客户发送消息。
重定向 节点	重定向对话、转移用户或结束主题或对话。
结束 节点	结束会话。 仅在对话路径底部可能。

创建主题

Web 应用

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. 选择新建主题>从空白开始。 Copilot Studio 会自动插入触发器节点和空白消息节点。 此时将显示触发短语面板。

3. 为当前主题添加所需触发短语。

   

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

4. 输入所需消息，并根据需要添加更多节点。

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

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

   • 显示名称告诉机器人用户在询问哪个主题。
   • 描述向您和其他机器人制作者描述了主题的目的。 此描述不会显示给用户。

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

编辑主题

Web 应用

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

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

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. 选择“ 保存”，然后选择“ 关闭代码编辑器”。 请注意一些 问题 节点后面的条件逻辑。

   

经典/团队

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

主题包含若干自动生成的节点。 您可以像编辑其他节点一样编辑这些节点。

• 若要添加节点，请选择要在其中添加新 节点的节点下的“添加节点 ”图标 ，然后从显示的列表中选择所需的 节点类型 。

• 删除节点时，请点击目标节点菜单图标 (⋮)，选择删除。

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

提出问题

从“添加节点”菜单中选择“提问”时，将显示一个新的“问题”节点。

1. 输入要提问的问题。

   例如当用户询问营业时间时，聊天机器人可能询问“您需要查询哪个门店？”

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

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

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

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

   

   Copilot Studio 会为每个选项自动创建条件路径。 您可在分支逻辑中添加节点，并为每条路径或值指定机器人的响应方式。

   在对话过程中，每个选项都在聊天中显示为一个按钮，但用户也可以键入他们的回答。

4. （可选）重命名保存用户响应的变量，并配置其属性。 有关更多信息，请参阅使用变量。

添加条件

在支持变量的主题中，可根据变量值添加分支逻辑。 例如，如果您设置了用户身份验证，您可能希望聊天机器人在用户登录时显示不同的消息。

从“添加节点”菜单中选择“添加条件”时，将显示一个菜单。

• 要根据特定变量值添加路径，请选择基于条件的分支，并配置所需条件。
• 要添加覆盖所有其他值的路径，请选择所有其他条件的分支。

调用工具

要调用 Power Automate 流或插入身份验证节点，请从添加节点菜单中选择调用工具，并选择所需工具或创建新工具。

若您的机器人具备语音功能，则可使用更多工具。

显示消息

从“添加节点”菜单中选择“显示消息”时，将显示一个新的消息节点。

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

重定向到其他主题

从“添加节点”菜单中选择“重定向到另一个主题”时，将显示主题列表。

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

此时将出现重定向节点。

您可以将重定向的主题视为子主题。 您可在重定向节点下方插入更多节点。 当子主题的对话路径完成时，机器人将返回到原始主题。 然后，机器人跟踪子主题节点下的节点。

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

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

结束对话

对话结束后，可以添加一项调查，询问用户其问题或疑问是否得到解答或解决。 回复将在客户满意度分析页面上收集。

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

在解决问题或回答疑问的对话路径末尾，从添加节点菜单选择结束对话后，将显示以下菜单：

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

• 要插入与您的配置的转接产品链接的转接节点，请选择转接到代理。 可选：为客户服务代表输入私密消息。

测试并发布

Web 应用

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

确认无误后，将智能体发布至目标渠道。

经典/团队

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

确认无误后，将其发布至目标渠道。