创建并编辑主题

在 Copilot Studio 主题中定义代理对话的进度。

若要创作主题，您可以自定义提供的模板、从头开始创建主题或说明您想要的内容，让 AI 创建主题。

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

通常，主题有一组触发短语—客户可能会使用的与特定问题相关的短语、关键词和问题。 Copilot Studio 代理使用自然语言理解、客户的消息以及所有主题的扳机键短语来找到最佳扳机键。 消息不需要与主题的触发短语完全匹配即可触发主题。 例如，关于商店营业时间的主题可能包含触发短语 check store hours。 如果顾客输入“查看商店营业时间”，这将触发您的商店营业时间话题。

先决条件

• 要创建代理，请参阅 快速入门：创建和部署代理。

自然语言理解

代理使用自然语言理解（NLU）来解析客户键入的内容并找到最佳触发短语或节点。

例如，用户可能会键入“Open hours”（开放时间）。代理将其与 Store hours 主题匹配，开始一个对话，询问客户对哪个商店感兴趣，然后显示商店的营业时间。

测试 代理 窗格显示代理对话在每个步骤的进度。 您可以使用 Test 代理 （测试 #）窗格来微调主题，而无需退出 Copilot Studio 门户。

有关代理和主题限制，请参阅 配额、限制、应用程序注册、证书和配置值。

Copilot Studio 中的主题

Web 应用程序

主题类型

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

• 系统主题支持基本行为，例如与某人交谈或结束对话的自定义请求。 一些系统主题有扳机键短语，您可以自定义这些短语以满足代理的需求。

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

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

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

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

节点类型

以下是可用的节点类型：

选项	Description
发送邮件	给客户发送消息。
提出问题	向客户提问。
使用自适应卡片询问	创建一个 JSON 代码片段来与其他应用程序交换。
使用条件创作	根据条件转移对话。
变量管理	设置值、解析值或清除所有变量。
管理主题	重定向、传输或结束主题或对话。
调用流	调用类似 Power Automate 或 Excel Online 的流，或者使用连接器或插件。
高级	生成式答案、HTTP 请求、事件等等。

小费

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

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

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

创建主题

1. 从代理 页面的列表中 打开您的代理。 为了获得更好的可见性，请暂时关闭 Test your 代理 （测试你的 #）面板。

2. 在顶部菜单栏上，选择主题。

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

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

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

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

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

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

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

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

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

8. 添加您的代理主题详细信息：

   • 输入名称以标识主题，例如“商店营业时间”。Topics （主题 ）页面按此名称列出了代理中定义的所有主题。
   • 如果需要，请输入一个显示名称，当代理无法确定哪个主题与客户的消息匹配时，向客户显示。
   • 如果需要，请使用 Description 字段为您自己和团队中的其他代理制作者描述主题的用途。 客户永远不会看到主题描述。

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

重要提示

避免在主题名称中使用句点 (.)。 无法导出包含任何主题名称中带有句点的代理的解决方案。

设计主题对话路径

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

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

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. 选择保存，然后选择关闭代码编辑器。 问题节点现在有许多关于运输的条件。

   

测试并发布您的代理

在更改主题时测试代理 ，以确保一切按预期工作。

设计并测试代理后， 将其发布到 Web、移动或本机应用程序或 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

设计主题的对话路径 - Teams

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

   

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

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

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

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

   

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

   

插入节点 - Teams

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

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

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

提出问题 - Teams

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

   

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

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

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

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

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

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

   

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

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

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

添加条件 - Teams

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

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

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

   

调用操作 - Teams

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

显示消息 - Teams

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

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

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

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

结束对话 - Teams

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

有两个选项：

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

  

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

重定向到其他主题 - Teams

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

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

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

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

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

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

使用变量

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

删除节点 - Teams

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

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

更改主题后， 请测试您的代理 以确保一切按预期工作。

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