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

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

智能伙伴Aily手册精选NaN-NaN-NaN
产品功能
功能介绍
当期望飞书群组中发生的特定事件(如机器人进群、用户进群、群解散等)变更时,通过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. 检查下推送的用户是否应用可用范围中?如果推送用户不在应用可用范围中,将收不到机器人推送的消息
将对应用户加到应用可用范围中
先进生产力和业务协同平台
联系我们立即试用

先进团队,先用飞书

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