动作
动作是机器人在反应触发时执行的操作。一个反应可以有多个动作,按从上到下的顺序依次执行。在编辑器的动作区块中点击添加动作来添加。动作之间通过执行上下文(ctx)和用户参数共享数据——详见替换与公式。
消息与回复
- 发送消息 — 核心动作:通过区块(文本、照片、文件、延迟、AI、调用反应)组装回复,添加 inline 按钮、菜单和对话步骤。详见消息与按钮。
- 保存消息 — 将收到的消息文本写入用户参数。
- 转发 — 将收到的消息转发到指定聊天(可选话题 ID)。
- 通知 — 向服务聊天发送包含用户、聊天和文本信息的通知。
用户:标签与参数
- 修改标签 — 为订阅者添加和/或删除标签。
- 修改参数 — 设置、删除或增加用户参数值。
内容审核
- 删除收到的消息 — 删除收到的消息(可选:删除该用户的所有消息,支持延迟)。
- 删除已发送的消息 — 删除机器人发出的消息(本反应的或聊天中所有的,支持延迟)。
- 修改权限 — 静音 / 取消静音 / 封禁 / 解封 / 限制权限成员,可设置时限或永久;限制时可选择具体权限。
- 重要反应(颜色) — 为运营商标记对话颜色。
数据与集合
- 创建记录 — 向集合中添加一行;配合"去重键"可实现 upsert(无重复)。
- 更新记录 — 修改符合过滤条件的行。
- 查找记录 — 将行读入上下文作为数组(用于遍历)。
- 删除记录 — 按过滤条件删除行。
- 循环列表 — 遍历
ctx中的数组,对每个元素执行嵌套动作(例如按列表群发)。
集合详情见集合与数据。
外部请求
- Web 请求 — HTTP 请求(GET/POST/PUT/DELETE),支持自定义头部、请求体、成功状态码、超时和重试;响应通过 JSONPath 保存到参数或
ctx;可异步执行,并在成功/失败时启动对应反应。 - 加载 URL — 抓取页面并将其可读文本保存到
ctx(供后续处理或 AI 使用)。 - 查询数据源 — 从已接入的连接器(REST / OzmaDB)读取数据到
ctx。 - 写入数据源 — 向连接器写入数据(POST/PUT/DELETE)。
数据源和密钥详见数据源与密钥。
AI 与计算
- AI — 调用语言模型:提示词、将回复保存到参数/
ctx、可选 JSON 模式用于结构化提取、向用户发送回复。详见 AI 回复。 - 计算 — 按公式或决策表("当 → 则"规则,第一个为真的胜出)计算并将结果保存到
ctx/参数。
逻辑与场景
- 链式反应 — 按名称启动另一个反应。
- 下一个反应 — 将控制权交给列表中下一个匹配的反应。
- 启动场景 — 启动步骤式向导(flow)。详见场景。
- 请求确认 — 向审批人发送卡片;"确认"/"拒绝"按钮触发对应反应。
- 转给运营商 — 将对话移入运营商收件箱。详见聊天与运营商。
集成
GetCourse、Google Sheets 和 Google 云端硬盘动作通过同名集成接入(详见集成)。在反应构建器中这些动作标记为"即将推出"——目前请通过集成设置、Web 请求或 AI 使用它们。向外部服务的通用发送可通过 Webhook 集成和 Web 请求动作实现。