工作流系统

目标：学会用"一句话生成"和"画布拖拽"两种方式创建工作流，并激活使用（专注模式、智能闹钟、派对模式）

一、什么是工作流

工作流（Workflow）是 LeLamp 的多步骤对话脚本：AI 按照一张"节点图"一步步引导你完成任务，每一步都可以提问、执行动作（开灯 / 放音乐 / 设定时器），并根据你的回答决定下一步走哪条分支。

普通对话 vs 工作流：

LeLamp 内置 3 个工作流：专注模式（focus_session）、智能闹钟（bedside_alarm）、派对模式（party_it_up），你也可以自己创建。

二、三个核心概念

• 节点：流程中的一步。三种类型：
  • 对话节点（dialog）：AI 向你提问或说明
  • 动作节点（action）：执行开灯、放音乐、设定时器等动作
  • 分支节点（branch）：按某个状态变量的值分流
• 连线：节点之间的流转方向。normal 是顺序执行；condition 是按变量值走不同分支。
• 状态变量：跨步骤记住信息的"便签"，比如精力等级（high/medium/low）、任务内容、专注时长。分支就是靠它判断的。

每个工作流自动有 START（入口）和 END（结束）两个虚拟节点。

三、方式一：一句话让 AI 生成（推荐）

1. 打开 Web 界面的 Workflows 页面，点 ** AI 生成**。
2. 输入一句话描述，例如：

   睡前模式：先播报晚安，然后关灯，播放下雨声，30 分钟后自动停止

3. 点 生成，等待 1-2 分钟。
   • 你应看到什么：画布上出现一张节点图（绿色圆点 = 开始，红色方框 = 结束，箭头 = 流程走向），底部列出状态变量。
4. 不满意点 重新生成；满意点 保存。
   • 你应看到什么：工作流出现在左侧列表中，可以选中、编辑、激活。

四、方式二：可视化画布编辑（精细调整）

在 Workflows 页面点 新建，或选中已有工作流点 编辑，进入画布：

保存时系统会校验：START/END 是否存在、有无悬空连线、分支是否必填。不合规会直接报错，按提示补全即可。

想删除某个节点：选中后按删除键（或看属性面板的删除按钮），连线会自动移除。

五、状态变量：工作流怎么"记住"你

以专注模式为例，完整链路是：

1. 定义：每个变量声明类型（文本/整数/布尔）和默认值，如 energy_level 默认 medium。
2. 节点声明写入：编辑节点时勾选"本节点要写入的变量"。运行时 AI 每步结束都会收到强制清单，必须把这一步收集到的信息写进去。
3. AI 读取：每步提示里都带当前所有变量的值，AI 全程看得到。
4. 写入：AI 把你的回答整理成变量值提交，比如你说"我很累" → energy_level = low。
5. 分流：条件边的 state_key 取当前值 → 查映射 → 走对应分支（high / medium / low 三条路）。

写"指令"（intent）的建议：说清楚"怎么取值"，比如"询问用户现在的状态，判断能量级别，只能是 high（充沛）/ medium（中等）/ low（疲惫）三者之一"。

六、激活与交互模式

工作流建好后，有两种启动方式：

网页激活（最可靠）

1. Workflows 页面选中工作流，点 激活。
   • 你应看到什么：当前步骤节点出现蓝色边框 + 顶部提示条显示当前步骤，页面自动轮询刷新。
2. 激活后，直接对 LeLamp 说话，对话就进入了该工作流的交互模式：AI 按节点一步步提问、执行动作，直到流程结束（到达 END）。

语音触发

直接说触发词，AI 会调用工具启动对应工作流：

也可以问"你能做什么？"或"有哪些工作流？"，LeLamp 会列出可用的工作流。

七、内置工作流示例

八、常见问题