辅助生成给出的是一份候选版本,不是可用版本。验收要在四处停下来确认:生成结果与方案是否对得上、应用之后画布有没有被覆盖、调试时每个节点的输入输出是否成立、发布前变量与回流是否可解析。四处都确认过,候选版本才算落成一条可维护的流程。
这条链路解决的是搭建成本,不是判断成本
一条工作流包含节点、连线、变量与条件四层结构。手搭的成本集中在结构上:摆节点、连箭头、起名字、改引用。辅助生成把这一层接过去,按自然语言方案生成候选版本,自动排版后交回画布。判断层仍然留在人这边:这次改动该落在哪个节点、异常时回到哪一步、写入前是否需要二次确认。
分清两层之后,验收的目标也就清楚了:不要求生成结果一次正确,要求每一处不确定都能被发现。4.17.3 的辅助生成是商业版能力,需要执行人具备应用编辑权限,并由管理员启用辅助生成与沙盒;两项缺一,入口不出现或生成中途失败。
生成之前写清方案的三段
第一段写输入:流程从哪拿数据、字段叫什么、由谁触发。第二段写判断:按什么条件分流、哪些情况要转人工。第三段写输出:结果交给哪个系统、回执给谁看。三段写清楚,生成的节点清单才有对照物;只写“做一个客服流程”,生成结果与预期的偏差会大到无法逐条比对。
写方案时避开两类词。一类是程度词,如“更快”“更准”,生成不出对应节点;另一类是隐含动作,如“顺便归档”,归档落在哪个节点、归到哪里,都要写出来,否则会在调试时才发现这一步没人做。
第一道确认:生成结果与方案对得上
生成之后先不急着应用,先读候选版本里的节点清单,把它与方案里的动作逐条对照。方案里写“读取工单、判断优先级、写入备注”,候选版本里就该能找到对应的三个动作;多出来的封装节点属于实现细节,可以留,但要知道它替谁做事。
应用之后立刻检查一件事:原有节点有没有被覆盖。自动排版会重排位置,位置变化不影响运行,节点被替换才会。对比方式是应用前后各存一份版本,看节点标识的增减;画布上箭头的走向会随自动排版变化,不作判断依据。
第二道确认:调试里的节点输入输出
调试面板是唯一能把“看起来对”和“跑起来对”分开的地方。按单步运行走主路径,逐个节点看输入与输出:输入里该有值的字段是否有值,输出里该出现的结构是否出现。表单类节点与选择类节点的输出字段不同,一个给结构化输入,一个给用户选择结果,两个字段在后续节点里的引用方式也不一样,验收时不能混着看。
补充一组边界输入:空值、超长文本、缺少必填项。边界输入下报错是正常结果,报错信息指不到具体节点才是问题。日志里每个节点都留着输入与输出的快照,比对两次运行的差异比读节点配置快,尤其是在变量引用改过之后。
第三道确认:变量、动态选项与回流
变量分三类看:普通字段引用、密码与工具密钥、HTTP 或 MCP 鉴权请求头。三类都能通过选择器插入,手写变量名在改名之后会失效,验收时用选择器重插一遍最快。
单选与多选支持由变量生成动态选项,选项为空时会明确报错。验收动作是先给变量一个空集合,确认报错落在预期位置;再给一个正常集合,确认渲染出的选项与数据源一致。
回流是另一处容易漏的地方。流程允许由条件出口控制的回流,纯串行回环这类不合规连线会在调试或发布前被拦下。检查方式是看每条回到上游的连线是否都挂在条件分支上,没有条件的回流一律改掉。
第四道确认:发布与回滚
发布前确认三件事:候选版本已经保存、变量在运行时可解析、应用的编辑权限与发布权限归属清楚。发布之后线上跑的是发布版本,画布上的改动属于下一版,两者是两套状态。
回滚按发布记录走,不按画布撤销。发布记录里保留版本、时间与发布人,回滚时选回上一版,并找当时发布的人确认范围内改动;靠撤销操作回到过去,会把中间的人工修改一起丢掉。
失败表现的分层与排查顺序
第一层是生成层:候选版本缺少动作、节点名称与方案无关。原因多在方案描述太抽象,改描述比重试有效。
第二层是应用层:节点被覆盖、原有分支条件指向不存在的节点。原因多在应用前没有对比版本。
第三层是运行层:主路径通过、分支报变量为空。原因多在上游节点在当前分支上没执行,引用却按“一定执行”写。
第四层是发布层:调试正常、线上报错。原因多在发布版本与调试版本不一致,或者发布时依赖的权限、模型引用没跟上。
排查按层往下走,不要跳层。生成层的问题改描述,应用层的问题回滚重来,运行层的问题改引用,发布层的问题重发。四层混在一起改,改完不知道是哪一处起的作用。每修完一层,重跑一次四道确认:生成结果改动之后,应用与调试的结论一起失效,不能只补跑改动的那一道。
用一张工单验收分支与字段
以售后退款为例,验收用例应含一条符合条件的请求和一条信息不足的请求。两条都填写同一个订单编号,前者提供能核对的凭证,后者缺少凭证。应用候选版本后,先在画布上标出负责读订单、判断凭证、反馈处理状态的节点,再检查每个节点的输入引用。订单编号应沿同一条链路传递,分支条件应读取凭证判断结果,反馈节点应把申请状态与判断依据一起交给后续环节。
调试时再加一条查不到订单的输入,确认异常出口能保留原始输入并把任务交回人工。保存每次运行的节点输入与输出。若缺凭证样例走进了通过分支,先比对判断节点读到的字段,再比对分支上的条件,避免用改提示词掩盖接错引用。发布复核只需重跑这些高风险输入,确认引用的应用版本与测试记录对齐。后续修改退款条件时,保留原输入作为回归集,并新增一条处在新旧条件分界处的样例。
数据来源
技术版本:FastGPT v4.17.3。
| 主题 | 来源 |
|---|---|
| 工作流辅助生成、变量与回流、发布要求 | 官方更新说明 4.17.3 |
| 节点工具调用与参数生成 | 官方更新说明 4.16.0 |