设置主题触发器

对于使用生成式编排的智能体,默认的主题触发器是通过智能体。 当智能体确定触发器节点上指定的主题名称和描述与用户发来的消息相匹配时,它就会激活。

对于使用经典编排的智能体,默认的主题触发器是短语。 当一个或多个指定的触发短语与用户发来的消息密切匹配时,它就会激活。 还有其他可用的触发器类型可以确定何时应执行主题。

先决条件

熟悉创建和编辑主题

触发器类型

触发器使您的智能体可以拦截和处理不同类型的事件或传入活动。 以下触发器类型确定主题应何时触发。

小费

当用户向智能体发送消息时,有效负载是信息类型的活动。 代理可以接收其他类型的活动,具体取决于聊天或其他事件中发生的情况。

例如,Microsoft Teams 发送调用类型的隐藏活动,表示用户操作,例如与消息扩展交互。

类型​​ Description
通过智能体 适用于使用生成式编排的代理。 当智能体确定触发器节点上指定的主题名称和描述与用户发来的消息相匹配时激活。
短语 适用于使用经典编排的智能体。 首先当一个或多个触发短语与用户传入的消息匹配时。
已收到消息 当收到消息类型(最常见的活动类型)的活动时触发。 当用户向代理键入或说出某些内容时收到。
已收到事件 首先当收到事件类型的活动时。 默认情况下,系统会响应所有事件活动。 使用触发器属性中的事件名称属性可筛选特定事件。
已收到活动 首先当收到任何类型的活动时。 您可以选择设置触发器属性中的活动类型属性,以筛选特定的活动类型。
已收到对话更新 首先当收到 conversationUpdate 类型的活动时。 例如,当用户加入对话时,Teams 会发送此类活动。
已收到调用 首先当收到调用类型的活动时。 最常从 Teams 渠道接收 - 例如,当用户与 Teams 中的消息或搜索扩展进行交互时。
重定向时 当主题被其他主题显式调用时触发。 使用触发器属性中的非活动持续时间属性设置所需的非活动时间。
非活动 当用户在配置的时间段后未与代理交互时触发。
计划完成 适用于使用生成式编排的代理。 当代理完成执行所有计划步骤以响应用户查询或自主触发器时触发。
已生成 AI 回复 适用于使用生成式编排的代理。 当智能体在调用一个或多个主题、操作或知识源后为用户生成响应时触发。 使用 Response.FormattedText 系统变量查看生成的响应。 如果想阻止协调响应的发送(例如,修改消息并使用消息节点发送自己的消息),请将 ContinueResponse 变量设置为 false。

更改主题的触发器

  1. 转到智能体的主题页面,打开所需的主题。

  2. 将鼠标悬停在触发器节点的方框上,然后选择更改触发器图标。

    显示触发器节点上“更改触发器”图标位置的截图。

  3. 为您的主题选择合适的触发器类型

    • 对于通过智能体触发器,请描述智能体应在何时使用此主题。
    • 对于短语触发器,输入所需的触发短语。
  4. 在触发器方框上选择编辑。 此时将显示指定触发器类型的属性面板。

  5. 设置触发器的适用属性:

触发条件

指定触发器触发所必须满足的条件。 例如,您可能希望触发器仅在员工使用的渠道为 Microsoft Teams 时触发。

触发器条件截图。

如果需要更复杂的条件,可以切换到 Power Fx 公式编辑器:选择生成器,然后选择公式

显示转到公式编辑器选项的屏幕截图。

触发优先级

单个传入活动(如消息)可以触发多个触发器。 触发器类型决定触发器触发的顺序。

执行顺序:

  1. 已收到活动
  2. 已收到消息 / 事件 / 对话更新 / 调用
  3. 通过智能体 / 词语

如果存在多个相同类型的合格触发器,则触发器将按照创建顺序执行(最旧的在前)。

您可以设置优先级属性来明确决定执行顺序。