添加事件触发器(预览)

事件触发器允许您的代理在其他系统中发生事件时自动做出反应。 然后,您可以为代理定义要采取的特定操作流作为响应,或者向代理提供有关如何确定要执行的最佳操作的说明。

重要提示

使用事件触发器是一项公共预览版功能。 预览参与者可以免费使用事件触发器,但需要计入 使用配额的消息。 预览功能不适合生产使用且功能可能受限。 这些功能在正式发布之前已经可用,以便客户可以抢先体验并提供反馈。

有关事件触发器如何工作以及与代理的其他组件相关的深入指导,请 转到事件触发器概述

备注

此功能仅适用于启用了生成式编排的 代理

向代理添加事件触发器:

  1. 在代理的概述页上,转到触发器部分。

  2. 选择添加触发器“概述”页面中“触发器”面板的屏幕截图。

  3. 选择所需触发器。

  4. 如有必要,请提供您的身份验证详细信息。

  5. 选择下一步

    备注

    您只能通过代理制作者的帐户(代理作者身份验证)使用身份验证触发器连接器。 您只能根据您作为代理作者有权访问的系统中的事件为您的代理设置触发器。 有关详细信息,请参阅事件触发器限制

  6. 根据需要配置触发器,并定义激活触发器的事件参数和触发器有效负载。 触发器提供默认有效负载内容,但您可以添加自己的内容和说明。 有关更多信息,请 转到定义触发器有效负载

为了让代理对事件触发器做出反应,代理需要在其响应中调用操作或主题,以及调用哪些操作或主题的说明。 有关详细信息,请参阅 调用操作或主题

测试触发器

在发布之前,请务必测试触发器及其反应。 您可以使用测试代理聊天 来测试您的代理对定义的触发器的反应。

在发布带有新触发器的代理之前,代理不会自动对触发器做出反应。 相反,您必须通过选择要发送到代理的触发器有效负载来手动激活代理。

  1. 运行触发事件一次以生成有效负载。 例如,如果在 Microsoft Planner 中使用 Microsoft Planner 触发器当有新任务分配给我时,请在 Microsoft Planner 中为自己分配一个测试任务以激活触发器。
  2. 在代理的概览页面中选择触发器旁边的测试触发器图标。 该列表包括该事件的所有最近实例。
  3. 选择要测试的实例,然后选择开始测试显示要选择的测试有效负载的屏幕截图。

您可以使用 活动图 查看代理在测试期间对触发器有效负载的反应。 要打开活动地图,请选择测试窗格顶部的地图图标

修改触发器

创建触发器后,可以通过 Power Automate 修改事件参数和有效载荷。 要从以下位置 Copilot Studio打开触发器:

  1. Overview 页面,找到触发器。
  2. 选择更多图标(...),然后 在 Power Automate 中打开如何打开 Power Automate 以编辑触发器的屏幕截图。
  3. 选择触发器,然后进入参数代码标签进行修改。 有关可以添加哪些变量和字符串运算符的信息,请转到关于选项卡。
  4. 更改并保存。 有关在 Power Automate 中进行更改的更多信息,请转到开始使用 Power Automate 中的触发器。

使用触发器发布代理

使用事件触发器发布代理后,每次激活代理的触发器时,代理都会自动做出反应。 您可以在 活动页面中查看代理的触发器和反应的分步记录。

事件触发器只能使用代理作者的凭据进行身份验证(即用于 授权连接的凭据)。 这可以允许代理的用户在未经自己授权的情况下访问他们不应该访问的数据和系统。 更多信息,请参阅故障排除和限制