飞书智能伙伴Aily之飞书群组触发器 - 飞书官网
产品功能

飞书智能伙伴Aily之飞书群组触发器

飞书

2024-12-23

功能介绍​
配置步骤​
测试任务​
提交启用​
发布​
常见问题​
功能介绍 ​
当期望飞书群组中发生的特定事件(如机器人进群、用户进群、群解散等)变更时,通过AI准确、高效传递信息,提效各类工作场景(比如当机器人进群时执行总结群消息的技能;当用户进群时发送群欢迎语👏等),可在任务中配置 「飞书群组」 触发方式,以达到预期效果。 ​
​
常见的飞书群组触发器使用场景和实践: ​
  • 群聊智能总结:在日常飞书工作中,群聊过多已成为普遍现象,每天需要处理的信息量庞大。比如在oncall处理群、问题讨论群中,面临着中途拉进群缺失上下文、整理总结费时。可以通过「机器人进群」事件触发器实现群聊内容智能总结:机器人进群自动总结群内容 - > @机器人总结群上下文 的链路。本方案已提供开箱即用的接入方式,5分钟可快速在 Aily 平台搭建完成 ​
配置步骤 ​
(一)添加触发器 ​
进入任务编辑页面,触发方式选择「 飞书群组」:​
​
250px|700px|reset
image.png
​
​
(二)配置触发事件 ​
触发事件是指可以触发当前流程的具体事件,目前「飞书群组」支持的触发事件如下图所示:​
​
250px|700px|reset
image.png
​
​
​
触发事件 ​
事件说名 ​
需申请的飞书权限 ​
更详细的事件业务说明 ​
  • 机器人进群 ​
机器人被用户添加至群组时,触发此事件 ​
订阅机器人进、出群事件 ​
  • 用户进群 ​
新用户进群(包含话题群)时,触发此事件 ​
查看群成员 ​
  • 用户出群 ​
用户主动退群或被移出群组时,触发此事件 ​
查看群成员 ​
  • 撤销拉用户进群 ​
撤销拉用户进群时,触发此事件 ​
查看群成员 ​
  • 机器人被移出群 ​
机器人被移出群组时,触发此事件 ​
订阅机器人进、出群事件 ​
  • 群解散 ​
群组被解散时,触发此事件 ​
查看群信息 ​
  • 群配置修改 ​
​
群主转移、群基本信息修改(群头像/群名称/群描述/群国际化名称)、群权限修改时,触发此事件 ​
查看群信息 ​
​
(三)触发条件 ​
设置特定的触发条件,可以实现:事件发生并且满足所设置的条件时才触发。 ​
触发条件非必选属性,如无需求,可跳过。 ​
​
250px|700px|reset
​
​
当无需配置触发条件时,默认监听到即触发 ​
​
250px|700px|reset
​
​
(四)输出数据 ​
在选择了触发事件后,会根据所选的触发事件显示接收到的事件内容,接收到的事件内容也是当前触发节点的「输出变量」。 ​
​
250px|700px|reset
​
​
以「机器人进群」触发器为例 ​
展示了事件发生后,在后续的技能配置中,我们可以引用这具体字段作为变量入参 ​
​
​
250px|700px|reset
image.png
​
​
​
250px|700px|reset
image.png
​
​
在技能的入参中,可以引用事件输出内容的变量​
在消息推送中可以选到对应的人员、群变量,比如「机器人进群」触发器中,可以选择「拉机器人进群的用户」变量作为推送对象​
​
测试任务 ​
配置完成后,可点击「测试」进行任务的运行效果测试。 ​
在测试面板中,支持通过模拟数据(mock)触发 ​
  • 根据触发器要求,自动生成模拟数据 ​
  • 模拟数据支持修改 ​
点击底部“执行测试”按钮,即可使用该模拟数据进行测试去执行开发环境的技能,触发后执行技能的结果可以在「调试和预览」中查看。 ​
​
250px|700px|reset
​
​
提交启用 ​
任务测试完之后,效果符合预期。可点击「提交」,启用当前任务。 ​
​
250px|700px|reset
​
​
发布 ​
任务提交后,需要发布应用。发布成功后,修改后的任务才可以正常生效。 ​
如果这个触发事件涉及到应用的飞书权限、飞书事件有变化,则需要提交飞书应用发布申请,申请成功到该权限和事件后,相应的飞书事件才可以正常监听,任务才可以正常触发。 ​
首次发布应用时,在发布应用时会一并把权限和事件一起申请和发布 ​
二次发布应用时,当检测到有新增的权限、事件时,有「小i」提示,可点击后弹窗中申请对应飞书权限和事件。 ​
​
250px|700px|reset
​
​
​
250px|700px|reset
​
​
常见问题 ​
  1. 测试任务时,在线上和测试企业做相应的群组事件后,比如「用户进群」,并没有在「调试和预览」中触发? ​
在测试任务时,任务的触发器数据为模拟数据(mock),所有需要在模拟数据中进行修改来模拟触发,触发后将测执行开发环境的技能,执行技能的结果可以在「调试和预览」中查看 ​
  • 如技能有消息推送配置,将推送消息到「调试预览」框中 ​
  • 如技能中没有消息推送配置,将可在「调试预览」框中查看技能日志,看技能执行是否符合预期 ​
  1. 为什么线上相应的事件触发了,预期应该执行技能,但最终没有执行技能? ​
一般来说,有以下几种情况,请按顺序逐个检查: ​
​
问题情况 ​
解决方法 ​
  1. 检查下新增/修改后的任务是否有发布?未发布的话,任务还未生效,自然不会执行 ​
发布任务 ​
  1. 检查下任务是否有对应的飞书权限、事件尚未申请?未申请的话,将无法监听到对应的事件触发 ​
将对应的飞书权限、事件进行发布申请 ​
  1. 检查下是否配置了触发条件?只有满足触发条件的事件才会触发并执行任务 ​
因为没有满足触发条件,所有没有执行技能。可根据情况修改触发条件。 ​
  1. 检查下机器人是否在群中?「飞书群组」的触发事件只向群内订阅了该事件的机器人进行推送,需要保障机器人在所在群中,才能监听到相应事件 ​
将机器人拉进对应的群 ​
  1. 检查下推送的用户是否应用可用范围中?如果推送用户不在应用可用范围中,将收不到机器人推送的消息 ​
将对应用户加到应用可用范围中 ​
​
​
预约飞书企业效能顾问 深度诊断企业痛点,定制专属 AI 办公方案

先进团队,先用飞书

欢迎联系我们,飞书效能顾问将为您提供全力支持
分享先进工作方式
输送行业最佳实践
全面协助组织提效
标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题标题

字节跳动旗下 AI 工作平台

联系我们立即试用