反应:基础

反应是机器人的核心构建单元:一条规则,描述何时触发、在什么条件下以及做什么。机器人是一个有序的反应列表;每来一个事件,平台从列表从上到下逐一匹配,执行第一个符合条件的反应。功能区入口在左侧菜单:反应

反应的组成

反应包含四个部分(编辑器标签页):

  • 触发器 — 触发反应的事件:文本、命令、媒体、按钮点击、系统事件、定时任务等。详见触发器
  • 在聊天中 — 反应生效的范围:与机器人的私聊、群组中对机器人的@、特定聊天;以及按用户状态过滤。
  • 条件 — 额外过滤器(标签、参数、时间、消息数等)。详见条件与聊天
  • 动作 — 触发后机器人执行的操作:发送消息、打标签、写入集合、调用 AI 等。详见动作

创建与编辑

点击创建反应(或打开已有反应)。编辑器顶部显示:名称(必填)、编号 #N描述启用开关。左侧为触发器/在聊天中/条件/动作导航,中间为表单,右侧为 Telegram 预览,显示带区块、键盘和菜单的消息效果。点击保存完成保存。

已保存的反应编辑器会显示统计面板:触发次数、趋势图及最近事件。

顺序与优先级

反应列表支持拖拽排序——顺序决定优先级。每个事件触发第一个匹配的反应后,遍历停止。若要继续遍历并允许后续匹配的反应也触发,请添加下一个反应动作(goto_next)。

启用与停用

列表行中的开关(或编辑器中的启用)可在不删除的情况下启用或停用反应。已停用的反应在遍历时会被跳过。

复制与删除

列表行中有复制(创建副本)和删除按钮。当需要创建稍有差异的类似反应时,复制功能非常方便。

导入与导出

可将反应导出为 JSON(编辑器中的导出按钮),也可重新导入(列表中的导入)。这样可以在机器人之间迁移反应,并在平台外保存版本历史。

群发反应

反应列表行中的群发按钮("发送"图标)会将该反应发送给机器人的所有活跃订阅者——适合发公告和通知。可按标签缩小受众范围。详见群发

链式调用与对话

多个反应可组合成场景:

  • 链式反应chain)— 在执行过程中启动另一个反应的动作。
  • 下一个反应goto_next)— 将控制权交给列表中下一个匹配的反应。
  • 对话步骤 — 消息区块可等待用户回复(并验证格式),让场景暂停。详见消息与按钮
  • 否则分支 — 若反应条件未满足,可启动另一个反应("条件"区的字段)。

下一步