大家好，我是斜杠君。
先说个开场白，在我的公众号上写了非常多的实战案例教程，大家也都是跟着我的教程在学习。我觉得对大家有帮助，也一直在选更好的题目为大家分享。
最近两天，在解答同学提问的时候，突然想到一个问题：写了这么多教程，为什么同样的问题大家都是在重复的问我？写了这么多教程为什么没能解决大家普遍的问题呢？
这时才意识到一直在做教程的输出，并没有想到大家的理解和消化程度，导致大家之前的问题没被解决，却还在学习新的内容。
教程应该在输出知识的同时，也要让大家消化知识，于是就有了今天的教程。我把大家经常遇到的问题总结出来，这些问题也是我被问到的最多的问题，希望大家可以通过本教程解决在学习过程中出现的疑惑。
当然可能还有更多的问题没在这十条中列出，在之后的教程中，我也会定期进行复盘总结更多的问题，以教程的形式输出给大家，让大家在接收新知识的同时，也能解决在过程中出现的问题。
接下来，话不多说，斜杠君用最简单的方式教给大家。大家可以点个关注，领取为大家准备的【扣子视频教程和学习文档】，而且也不会错过我后面的教程了。
👊 坑一：为什么明明前面的节点输出了值，但后面的节点却找不到?
这个是在斜杠君的社群中被问的最多的问题，为什么前面的节点明明已经输出了值，后面的节点却选择不到值呢?
例如,下面图中所示的情况：
因为在扣子中对数据类型的要求比较严格，前面节点输出值的数据类型，一定要和后面输入节点的数据类型对应上。
上面的问题，这里大模型的输出是一个字符串，而循环节点要求的是一个数组，所以是选择不到值的。
🎯 解决办法：这里的输出类型改为Array类型的就可以了。
👊坑二：为什么工作流执行正常，加入到智能体中就不好用了？
大部分原因是因为超时了。
因为在正常未开启异步运行的情况下：工作流整体、模型节点超时时间为 10 分钟，而智能体的超时时间是2分钟。
所以这样就很容易理解了。 举个例子，如果你的工作流单独运行是5分钟，到放到工作流中超过了2分钟，也会超时的。
🎯 解决办法：
一、 优化工作流，减少执行时间；
二、 开启异步机制，开启异步的方法是：
在智能体加入工作流的位置点设置：
开启异步执行：
👊 坑三：为什么我的知识库输出的结果不准确？
主要原因就是一句话：不会精准分段，一篇文章直接丢给智能体，让智能体自动分段，这样的效果肯定不好。
如果想让知识库根据问题回答出精准的内容，一定要手动进行知识库的分段。
🎯 解决办法：
具体如图所示，选择通过自定义的规则进行分段。
👊 坑四：为什么都是按照斜杠君团队空间里的工作流一模一样设置的，但却不输出结果？
大家要知道，两个一模一样的工作流，在运行的时候，不可能出现一个可以正常运行，另一个却运行错误。如果出现这种情况，一定是工作流设置错了，可能在某个细节的地方。看起来觉得一模一样，实际两个工作流并不一样 。
出现这个问题的原因，一般情况是不认真导致的。不管是在我的团队空间中社群同学参考我的工作流进行搭建，还是大家平时在参考教程内容搭建，最主要的是不细心，很多都是连线错误、大小写字母写错、数据类型没按要求设置等等。
🎯 解决办法：
认真梳理流程，认真检查每一个节点的是否和参考工作流一致，除了认真没有其它的办法。
👊 坑五：工作流运慢，不关注性能
同样的一个功能，有的同学搭建出来运行速度就很快，但有的同学搭建出来的性果就出奇的慢。引发这个情况的大部分原因就是在循环中加入了过多的大模型。
举个例子：如果你想生成10个爆款文案，那你就一次性让大模型生成10个，千万不要让循环调用10次大模型，每次生成1个。
如果所示这种情况：
👊 坑六：节点复杂，工作流执行中断
因为扣子工作流上限执行的节点是1000个，如果超过1000个节点，工作流就会终止运行，这个是扣子平台设置的规则，目的是要保证服务器稳定，这个是没有问题的。
如果说你业务流程确实是非常复杂，建议通过拆分工作流的方式，让工作流分步运行。
但我遇到的大部分情况，其实业务逻辑并没有那么复杂，而是把工作流搭建的很复杂。
例如：在一个循环中，明明可以用一个大模型节点搞定的，非要分成三步，让三个大模型节点解决。如果这样的话，不但降低了整体工作流的运行效率，而且每次循环又增加了两次节点的开销。
🎯 解决办法：
一定要精简节点，删除一切不必要的节点，简化业务逻辑。
👊 坑七：工作流运行正常，加入到智能体以后，和工作流调试的结果不一样
这个问题经常被问到，但这却是一个非常简单的问题。
🎯 解决办法：
如果你想让智能体输出的结果和工作流保持一致，就要在结束节点输出的时候，使用【文本】类型的输出。如图所示：
👊 坑八：工作流中显示图片，为什么到智能体中输出的是一个图片链接。
🎯 解决办法：
如果你想在智能体中显示图片，有两种方法：
1. 扣子平台支持markdown格式的语法，如果想在智能体中显示图片，使用这个格式的语法。
2，为工流绑定卡片，这个流程相对复杂，大家可以看我之前写过的这篇教程：
最新扣子(Coze)实战案例：卡片系列教程之图片列表卡片，卡片的使用详细讲解，手把手教学，完全免费教程
👊 坑九：飞书文档为什么不能写入
扣子平台和飞书的生态链接比较紧密，经常会把内容写入到飞书文档，斜杠君几乎每天都要收到这样的问题：为什么执行工作流不报错，却不能写入文档？
🎯 解决办法：
其实这个问题的原因有很多，这里我把常见的几个列举出来，大家自行检查。
原因一&扣子 Coze 教程#xff1a;没有为飞书文档授权，或飞书文档没有写入权限，请把写入权限打开；
原因二：工作流中字段名称和飞书文档中的字段名称不匹配，有可能是字段名写错了，仔细检查一下；
原因三：字段类型不匹配。飞书对字段的类型要求很严格，如果工作流中一个数字类型的数值写入到文本类型中是写入不成功的，请仔细检查。
如下图所示的截图示例，飞书多维表格中设置的是【文本类型】，如果写入数字2，就不会成功。
👊 坑十：不会使用调试工具？
这个问题很少有人问我，但我把这个问题放到最后是因为非常重要。 因为大部分同学是不知道如何调试，或者不知道有这个功能。
大部分情况下，当我们遇到问题的时候，对于一些简单的场景，我们可以通过简单几句的描述，让其他人帮助解决问题。
但对于一些复杂的情况，和一些工作流中的细节问题，其他人就看不到了。
所以就要求我们自己要掌握工作流的调试技巧。 例如最简单的，我们要在工作流执行以后，去从开始节点逐一检查每一个节点的输出是什么，看每一个输出结果是否符合预期。
如图所示：
还有，在智能体中，我们也要用好如图所示的调试工具，去跟踪每一个步骤。
点这里就可以调试：
查看每一个步骤细节，输入和输出参数：
好了，本次的《扣子避坑指南》就为大家写到这里，希望大家通过本教程的学习，有所收获~
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/264481.html原文链接：https://javaforall.net
