发送事件或活动

Microsoft Copilot Studio 提供了两个允许您发送非消息活动的节点:发送事件和发送活动。 以下各部分将讨论这些节点类型。

添加高级节点的屏幕截图,其中包括“发送事件”和“发送活动”选项。

发送事件

“发送事件”节点旨在发送事件活动。 事件活动从助手发送,可以被渠道拦截和使用,渠道决定是否以及如何使用活动。 发送事件时,您会给它提供一个名字,然后可以为此事件设置值。 此值可以是任意格式:原始文字值、变量引用或 Power Fx 公式。 该值被序列化为 JSON 并添加到传出活动。

显示“事件活动”节点的设置菜单的屏幕截图。

此节点的用途包括:

  • 您可以配置自定义网络聊天控件来处理从助手发送的事件。 例如,您可以查找从助手返回的事件并在页面上执行操作。 GitHub 上的 Microsoft Bot Framework Web 聊天示例存储库中的 04.api/c.incoming-activity-event 示例演示了事件处理的工作原理。
  • AudioCodes 使用事件活动让您控制服务。 例如,开始或停止通话记录。 有关其他信息,请参阅通话录音

发送其他活动类型

除了事件活动之外,您还可以使用“发送活动”节点发送其他类型的活动。 通常,此节点的用法是高级用法 - 因此它属于高级子类别。 您可以发送的活动类型是 Bot Framework 架构 - ActivityTypes 类中提供的活动类型的子集。 使用此节点时,您可以选择活动类型,然后可以选择设置名称或值。

常见类型包括:

  • 键入 - 发送一个键入活动,通道可以选择接收该活动并在客户端上显示一个键入指示器。
  • 延迟 - 可用于在消息之间提供延迟。 例如:发送消息,然后发送延迟活动,最后发送另一条消息。 对于最终用户,他们会看到第一条消息,停顿一下后,然后看到第二条消息。 在本例中,“值”被设置为延迟毫秒数。 有关详细信息,请参阅 ActivityTypes.Delay 字段
  • 调用/调用响应 - 通常用于 Microsoft Teams。 用户创建一个带有调用触发器的主题,拦截来自 Teams 的传入调用,并使用调用响应活动将适当的响应发送回 Teams。
  • 转接 - 允许用户发送一个具有对值的显式控制的转接活动。 转接用于一些外部渠道,例如 AudioCodes。

此屏幕截图显示带有“类型”下拉列表的“调用活动”节点。