Docs

Engine Builder

The Engine Builder is where you design a conversation visually. You lay out phases on a canvas, fill them with cards, wire logic gates between them, and choose where the chat begins. This is the full reference.

引擎 就是一段被画成流程图的对话。你在画布上用几种部件把它搭起来,在模拟器里测好,然后发布。本页会讲到构建器的每一个部分。如果你是全新上手,建议先扫一眼 人设 :每个引擎都是以某个人设的身份在跑。

核心概念

有几个词会在构建器里反复出现。把它们弄懂,别的就顺理成章了。

  • 阶段: 对话的一个环节。一个阶段由 开场消息 (AI 怎么起这个头)加上一副 卡组 组成,卡组是对话停留在这个阶段时它可以打出的卡。典型的引擎会有几个阶段:冷开场、预热、发出邀请。
  • 卡组: 挂在某个阶段上的那组卡。每一轮,引擎会用加权随机从卡组里抽 一张 卡打出去,所以同一个阶段每次的感觉都不太一样。
  • 卡片: 一个动作:闲聊、提问、发照片、丢链接、收尾。每张卡都有自己的设置(见下面的卡片说明)。
  • 逻辑门 / 转移: 决定对话何时从一个阶段走到另一个阶段,或者触发某种反应的规则。有的门夹在两个阶段之间;有的则悬着,盯着整段对话。
  • 信息: 引擎从线索那里学到的细节(名字、城市、兴趣)。这些信息会在聊天进行中被提取出来,并可以通过标记再放回消息里。
  • 起点: 指明对话从哪里开始的节点:AI 先发消息、用户先发消息,或者由外部事件触发。
  • 浮动观察者: 没有接在某两个具体阶段之间的门。它们盯着整段对话,一旦条件满足就触发(比如某条信息出现了,或者线索接受了链接)。

画布

构建器是一块可缩放的画布,上面是用连线相连的节点。你从侧边拖入部件,把卡片丢到阶段上,再拉线把流程接起来。

节点面板

  • 起点: 开启对话的那些节点(AI 开场、对方来消息、事件触发)。
  • 阶段: 在画布上新增一个阶段节点。
  • 规则: 你接在阶段之间或阶段周围的逻辑门与观察者。

卡片库

卡片库 列出了所有卡片类型。把一张卡拖到某个阶段上,它就加入了那个阶段的卡组。同一种卡可以出现在多个阶段里,各自设置不同。

连线

从一个节点的输出把手拖到另一个节点,就会生成一条连线。起点能走到第一个阶段、逻辑门能把聊天往前推,靠的都是连线。

自动排列

手工连出来的图很快就会乱。流程画布右上角的 自动排列 按钮(那根魔杖)会把整张图重新排成整齐的从左到右布局,节点之间不再重叠,然后自动适配到视图里。新的位置会在你保存引擎时一并记录。每个引擎收尾之前,都跑一次它。

卡片类型

卡片就是引擎在某个阶段里能走的招。以下是内置类型,用的是它们在卡片库里的名字:

  • 随意聊天(CHAT): 自由发挥的消息。这是唯一一张会完整遵循你自定义「指令」的卡,所以它是你操控措辞的主力。
  • Fact Finder(PROBE): 去问下一条还缺的信息,自动瞄准引擎目前还没拿到的那一项。
  • 发送照片(PHOTO): 从人设的照片库里发出最合适的一张,依据每张照片的描述自动挑选。
  • 验证照片(VERIFICATION): 请线索发一张能证明本人的验证照片。
  • 丢出链接(LINK_DROP): 丢出你的漏斗链接。需要在全局设置里配好漏斗网址。
  • 结束 / 收尾(CLOSE): 把话收住,结束这段对话。
  • 回应(REACT), 调侃 / 撩(TEASE), 敞开聊(SHARE), 共情(RELATE): 几句内置的短打,用来让对话保持人味。见下面那个坑:这四张走的是固定台词。

注意

回应、调侃 / 撩、敞开聊和共情这四张走的是固定的内置台词,会忽略「指令」输入框。 你在这四张卡里打的任何内容(以及任何标记)都不会被用到。如果需要自定义措辞,请改用一张 随意聊天 卡。

逻辑门与转移

逻辑门决定对话何时往前走、何时作出反应。它有两种形态: 内联计数器 接在两个阶段之间,以及 浮动观察者 盯着整段聊天。

内联计数器

  • N 条消息之后(MESSAGE_COUNT): 接法是 阶段 → 门 → 阶段。它数着回合,一旦到达阈值就把对话推进下去。阈值范围是 1–20。这是让聊天按阶段往前走的标准做法。

浮动观察者

  • 信息核对(FACT_EXISTS): 当某条特定信息从对话里被提取出来时触发。
  • 转化判定(CONVERSION_CHECK): 根据线索接受还是拒绝了你上一次丢出的链接来触发。
  • 信号探测(DETECTOR): 支撑「被怀疑是机器人」应对逻辑的内部观察者。它不出现在面板里,你也不需要自己摆放。

起点

每个引擎都得知道一段聊天是怎么开始的。添加一个或多个起点节点,并把每一个接到那条路径开始的阶段上。

  • AI 开场 / 主动搭讪: 由 AI 发出第一条消息(冷启动搭讪)。适合你主动出击的漏斗。
  • 对方来消息 / 默认: 由用户先发消息(普通的入站私信)。一个引擎必须有 且只有一个 「对方来消息 / 默认」起点。
  • 事件触发: 当某个特定的外部事件发生时开启聊天。它需要一个 事件 id (例如 story_reaction)。
  • 跟进: 把已经不吭声的线索重新拉回对话。

注意

AI 开场里的提示标记不会被替换。 在开场白里打的 {name} 会原样显示给线索。请把 AI 开场用大白话写完整。

信息与「知识」标签页

知识 标签页里,你管理引擎会收集的信息。分两类:

  • 系统信息: 引擎总会尝试了解的内置项(比如线索的名字和所在地)。
  • 自定义信息: 你自己的字段,针对你这条漏斗量身定的。

每条信息都会被 分配到某个阶段: ,也就是引擎应该在哪个环节去把它问出来。Fact Finder 卡随后就会去追当前阶段里还没拿到的那条信息。

注意

每条信息只能归属于一个阶段。 如果你想让引擎在别的阶段去了解某件事,就把这条信息挪过去。它不能同时挂在两个阶段上。

节点检查器

点击任意节点,右侧会打开检查器。能改什么取决于节点类型,但常见字段有:

  • 指令 / 指示: 用大白话写清 AI 该做什么。在卡片上,它引导这条消息;在阶段上,它就是这个阶段的目的。(别忘了那四张快捷卡会无视它。)
  • 阶段开场白: 某个阶段的开场消息:AI 进入这个环节时怎么起头。
  • 使用次数上限(0–20): 一段对话里这张卡最多能打出几次。 0 表示不限。
  • 两次使用的间隔: 一张卡要隔多少回合才能再次打出,避免它一张接一张地重复。

提示标记

在一张卡的「指令」里,你可以打一个 标记 ,引擎会在消息发出前把它换成真实的值。可用的标记有:

人设信息

  • {name}: 人设的名字
  • {age}: 人设的年龄
  • {origin}: 人设来自哪里
  • {city}: 人设所在的城市
  • {job}: 人设的职业
  • {hobbies}: 人设的爱好与兴趣
  • {bio}: 人设的简介
  • {style_tags}: 人设发消息的风格特征
  • {time}: 当前时段,让人设说起话来有早晚之分

你的漏斗

  • {platform}: 你们正在聊天的那个应用
  • {funnel_platform}: 你的漏斗平台或目的地平台

动作

  • {photo}: 从照片库里发出最合适的一张,按描述自动挑选
  • {link}: 发出你的转化链接,并已做过规避过滤的处理

卡片专属

  • {fact}: 在 Fact Finder 卡上:下一个要摸清的线索信息
  • {vibe}: 在发送照片卡上:当前的照片调性,随性还是辣一点
  • {context}: 在入口 / 开场卡上:开场白所回应的那条首发来信

全局与身份设置

作用于整个引擎的设置放在「身份 / 全局设置」标签页里:

  • 消息平台: 对话所在的应用(决定这个标记的值: {platform} )。
  • 回合上限(1–100,默认 60): 对话停止之前最多能走多少个回合。
  • 最多消息气泡数(1–5): 一条回复最多可以拆成几个独立的气泡。
  • 漏斗平台: 你的目的地平台(决定 {funnel_platform})。
  • 漏斗网址: 「丢出链接」这张卡会发出的链接。
  • 链接遮蔽: 在丢出链接时自动应用,用来绕开链接过滤。
  • 线索价值: 一条转化线索值多少钱,数据分析用它来估算收入。

拒绝与「你是机器人吧」应对

你可以把引擎在尴尬场面下的处理方式写成脚本:线索开始抗拒,或者怀疑 AI 是机器人。每个场景把一个 触发条件 和一个 回应配成一对,回应可以是一段文字或一张图片,好让对话优雅地接住,而不是卡在那儿。

校验与发布

构建器会在你动手的过程中检查引擎,并把问题报到 问题面板里。有两个级别值得注意:

  • 错误会拦下发布。 校验不通过的引擎无法发布。
  • 只有硬性限制的错误会拦下保存。 还带着一些较轻问题的半成品照样能存下来,之后再回来接着弄。
  • 点击问题面板里的某一条,它会 跳到对应节点 ,让你就地修好。

注意

一个阶段至少要有一张卡和一条开场消息。 空阶段过不了校验。

注意

逻辑门和起点节点不能改名。 只有 阶段 事件触发 可以起自定义名字:其余的交给构建器自动命名就好。

注意

发布到 Marketplace 需要校验完全干净: 这比保存更严格。发布之前,请把问题面板里的每一条错误都清掉。

引擎的增删改与 Marketplace

  • 新建: 从一张空白画布开始做一个新引擎。
  • 复制(克隆): 把现有引擎复制一份,改起来不影响原件。
  • 重命名: 你自己的 引擎改名。
  • 删除: 移除一个属于你的引擎。
  • 发布 / 取消发布: 把一个干净的引擎分享到 Marketplace,或者再撤回来。

下一步

引擎搭好了,就可以派它上场了。它以哪个人设的身份运行,见 人设;想从一条被验证过的漏斗起步,见 Marketplace 模板;上场前先空跑一遍,见 测试与模拟器;真正接上线,见 上线

Engine Builder: FluidTalk Documentation | FluidTalk