Coze 工作流出错时,怎样把问题问清楚
整理报错信息、复现步骤和上下文,让自己或 AI 更快定位问题。
前言
大家好!我是云途。 最近大家都在如火如荼地搭建自己的 Coze 工作流,我也非常开心能在群里看到这么多奇思妙想。
不过,随着实操的深入,我发现群里每天都会出现大量的求助信息,比如
❌ “云途,我的 Coze 报错了,怎么办?” ❌ “大佬救命,我的工作流跑不通了!” ❌ (甩过来一张用手机拍的、满是摩尔纹的反光电脑屏幕照片...) 每次看到这样的提问,我哪怕有心想帮,也是“拔剑四顾心茫然”——因为信息太少了,神仙也猜不出哪里出了问题。 为了帮大家更快、更精准地解决问题,也为了节省解答者的时间,今天云途就来教大家:遇到报错时,到底该怎么截图?怎么提供信息? Coze 工作流报错,到底该截什么图? 这是大家踩坑最多的地方。Coze 的工作流(Workflow)是一个由多个节点串联的系统,只说“报错了”是没用的。你需要提供以下 3 张关键截图: 关键截图 1:全局工作流视图 怎么截:缩小画布,截取你整个工作流的结构(至少包含报错节点的前后节点)。 为什么截:让大家知道你的整体逻辑是什么,数据是从哪里流向哪里的。
原文配图请通过页面开头的飞书公开链接查看。
关键截图 2:报错节点的具体配置 怎么截:点击那个标红报错的节点,截取右侧弹出的节点配置面板(尤其是你填写的 Prompt、选择的参数等)。 为什么截:很多错误是因为参数填错、变量引用错导致的,看配置能排查 80% 的人为失误。
关键截图 3:测试运行详情 怎么截:在试运行报错后,点击报错节点下方的“运行结果”,截图发出来。 为什么截:这里包含了系统底层返回的真实错误原因。如果是很长的一段英文报错,请务必把文本直接复制发出来,不要只发截图,方便解答。
补充截图
如果遇到的情况是由于前边某一个节点的内容为空,导致出现了问题,那么就还需要根据情况去返回找到没有数据或者返回数据错误的节点排查。 不过这个需要我来根据以上三张截图判定是不是需要补充截图,我也会讲清楚整体数据流转。