上周接了个需求搭一条工作流自动抓取竞品数据、分析后生成报告。结果从大模型节点到循环节点每个节点都让我翻了一次车。整条链路调了三天不是因为逻辑多复杂而是每个节点都有隐藏的坑。大模型输出格式永远对不上、代码节点60秒超时改不了、知识库检索出来的全是废话、HTTP请求超时没重试、条件分支走错路、循环变量引用后缀搞混……今天把踩过的坑全整理出来按节点分类照着避坑能省不少时间。遇到问题无法解决可以直接私信我或者miheaii.com一、大模型节点输出格式永远在跟你捉迷藏大模型节点是工作流里最常用的节点也是最容易让人崩溃的节点。坑1输出格式不稳定我在Prompt里写请以JSON格式输出包含title、summary、tags三个字段。结果跑出来一会儿多一个content字段一会儿tags变成字符串而不是数组。后来加了一个代码节点做格式校验不符合格式就重新调用才稳住。但这样会增加一次大模型调用成本和耗时都上去了。坑2Prompt太长导致超时大模型节点默认超时3分钟最多可以调到10分钟。但如果你把几百条数据塞进Prompt让它一次性处理很容易超时。我的经验是单次Prompt输入控制在2000字以内超长内容用循环节点分批处理。坑3温度参数设置不当温度设0输出太死板设1输出太放飞。建议从0.3开始调0.3-0.5是比较舒适的区间。解法总结加格式校验节点不符合就重试注意成本单次输入控制在2000字以内温度从0.3开始调关键输出用代码节点做后处理二、代码节点60秒超时是不可逾越的红线代码节点功能强大但限制也多。坑160秒超时不可调代码节点执行超过60秒就会超时中断而且这个时间改不了。我之前写了一个数据处理脚本要遍历几千条数据做清洗每次都在60秒时被掐断。最后只能把逻辑拆到循环节点里每次只处理50条。坑2无法安装第三方库代码节点只支持Python标准库pandas、requests都用不了。如果逻辑需要第三方库要么用标准库重写要么把逻辑移到HTTP请求节点调用外部API。坑3入参2MB限制代码节点的输入参数有2MB大小限制。如果上游传过来一个很大的JSON数组直接报错。解法是先在前面用代码节点拆分分批传入。坑4main函数返回值必须是对象这个坑我踩了两次。代码节点的main函数必须返回一个字典对象直接return字符串或列表会报错。正确写法def main(args): result {data: 处理结果} return result错误写法def main(args): return 处理结果 # 报错坑5沙箱状态不保留每次执行代码节点都是全新的沙箱环境上一次执行的全局变量、缓存都不会保留。如果你需要跨执行保留状态只能用数据库节点或变量赋值节点。解法总结拆分逻辑到循环节点单次执行控制在60秒内只用Python标准库不依赖第三方包入参超过1MB就拆分处理main函数返回字典对象不要依赖沙箱状态需要持久化就用数据库三、知识库节点明明上传了文档为什么检索出来的都是废话知识库节点看起来简单上传文档就能用。但实际用下来检索质量经常让人怀疑人生。坑1分段策略不对关键信息被切散我上传了一份产品手册里面有大量表格和列表。默认的分段策略把表格切成了碎片检索时匹配不到完整信息。后来改成按标题分段每个段落保留完整的表格结构检索效果才正常。坑2相似度阈值设置两难阈值设太高比如0.8召回太少阈值设太低比如0.5噪声太多。我的经验是先从0.65开始根据实际效果微调。召回太少就降到0.6噪声太多就升到0.7。坑3多知识库调度混乱我建了三个知识库产品文档、FAQ、技术手册。结果用户问产品问题检索出来的是技术手册内容。后来加了意图识别节点先判断问题类型再调用对应知识库才解决。坑4查询改写失效用户问这个怎么用知识库里有操作指南但检索不到。因为怎么用和操作指南语义差距大。解法是在知识库节点前加一个大模型节点先把用户问题改写成更规范的表述再去检索。解法总结分段策略按内容类型调整表格多的用按标题分段相似度阈值从0.65开始调多知识库场景用意图识别节点路由加查询改写节点提升口语化问句的匹配率四、HTTP请求节点调个API我翻车了10次HTTP请求节点用来调用外部API但配置细节多稍微不注意就报错。坑1超时时间不够默认超时时间比较短对方接口响应慢比如国外API经常超时断开。建议把超时时间调到最大10分钟同时在代码节点里加重试逻辑。坑2请求格式搞错JSON、form-data、raw、x-www-form-urlencoded……格式选错对方接口直接返回400错误。先看对方API文档确认Content-Type再在HTTP节点里选对应格式。不确定的话先用Postman测试通了再来配置。坑3响应解析失败API返回的JSON嵌套很深比如data.items[0].name在HTTP节点里直接引用经常取不到值。解法是在后面接一个代码节点手动解析JSON提取需要的字段。坑4触发频率限制很多API有频率限制比如每分钟最多60次请求。工作流高频调用很容易触发429错误。解法有两个一是在工作流里加延迟节点控制调用频率二是在代码节点里加重试逻辑遇到429就等几秒再试。解法总结超时时间调到最大严格按照API文档选请求格式复杂JSON响应用代码节点解析加延迟节点或重试逻辑应对频率限制五、条件分支节点判断条件写对了但还是走错路条件分支节点IF节点逻辑很简单但翻车率不低。坑1等于判断太严格用户输入是的你判断input 是结果走不到对应分支。建议用包含运算符或者先把输入标准化再判断。坑2类型不匹配上游节点输出的是字符串10你在条件里写input 5结果永远false。因为字符串和数字比较扣子会按字符串逻辑处理。解法是先用代码节点把字符串转成数字再做比较。坑3多条件组合逻辑搞反且和或的关系经常搞混。比如你想实现用户是VIP且消费满1000结果写成了用户是VIP或消费满1000。我的习惯是复杂条件拆成多个IF节点串联每个节点只判断一个条件逻辑更清晰。坑4空值没处理上游节点因为某种原因没输出值下游条件判断直接报错。建议在条件判断前先加一个代码节点检查变量是否为空给个默认值。解法总结优先用包含而不是等于类型不匹配时先转换复杂条件拆成多个IF节点条件判断前检查空值六、循环/批处理节点变量引用后缀问题坑了我一整晚循环节点和批处理节点是工作流里最容易让人迷惑的节点尤其是变量引用。坑1循环内外变量引用方式不同循环内部引用变量用{{循环节点.变量名}}循环外部引用要用{{循环节点_循环.变量名}}。我第一次在循环外面直接写{{循环节点.变量名}}结果取不到值调了一个晚上才发现是后缀问题。坑2循环输出是数组直接引用取不到值循环节点的输出是一个数组包含每次循环的结果。如果你想取第一次循环的结果要用{{循环节点_循环.变量名[0]}}。直接写{{循环节点_循环.变量名}}会得到整个数组后续节点处理不了。坑3批处理并发太高触发限流批处理节点默认并发比较高如果里面调用了第三方API很容易触发频率限制。建议在批处理节点里设置并发上限或者在API调用前加延迟。坑4循环次数过多导致工作流超时工作流整体有10分钟超时限制异步任务24小时。循环次数太多单次循环又比较慢很容易超时。我的经验是单次循环控制在50次以内超过的话用批处理节点或者分批执行。解法总结循环内外变量引用方式不同注意后缀循环输出是数组用索引取单个值批处理设置并发上限单次循环控制在50次以内七、避坑清单一张表总结所有坑表格节点类型核心坑解法大模型节点输出格式不稳定、Prompt超时、温度不当加格式校验、控制输入长度、温度0.3起步代码节点60秒超时、无法装库、入参2MB限制、返回值必须是对象、沙箱状态不保留拆分逻辑、只用标准库、分批传入、返回字典、用数据库持久化知识库节点分段策略不对、阈值两难、多知识库混乱、查询改写失效按标题分段、阈值0.65起步、意图识别路由、加查询改写HTTP请求节点超时、格式错误、响应解析失败、频率限制超时调最大、按文档选格式、代码节点解析、加延迟/重试条件分支节点等于判断太严、类型不匹配、组合逻辑搞反、空值报错用包含、先转类型、拆分IF、检查空值循环/批处理节点变量引用后缀、输出是数组、并发限流、循环超时注意后缀、用索引取值、设并发上限、控制循环次数工作流搭完后先单节点测试再串联先测正常数据再测边界数据。很多坑都是在集成测试时才发现的提前单测能省很多时间。 关于作者米核AI易山专注AI自动化和智能体搭建。官网miheaii.com本文部分内容由 AI 辅助完成。
)