夜雨聆风用CoMi Builder搭AI助手，我踩了这5个坑
上周接到一个客户案例：某制造企业想用致远CoMi Builder搭一个车间报工AI助手，要求工人用自然语言报工、自动写入ERP。听起来简单，实际做下来我踩了5个坑，分享给正在做类似项目的你。
坑1：权限配置比想象中复杂
一开始我以为CoMi Builder拖拖组件就能跑，结果第一关就卡在权限。Builder设计的AI助手默认走的是「应用级权限」，但车间报工需要写YonSuite的「生产报工表」，这涉及到：
表单数据写入权限（需要YonSuite许可） 人员身份鉴权（工人扫码登录后的OpenID映射） 字段级权限（有些字段只能看不能改）
解决方案：在CoMi Builder的「数据源配置」里，不要直接用默认系统账号，改用「服务账号+作用域限制」模式。具体是：在YonSuite里建一个专门的服务账号，只给「生产报工」模块的写权限，然后把这个账号的API Token配置到Builder的数据源里。
客户现场我花了半天查文档才搞明白这个逻辑，如果提前知道能省很多事。
坑2：自然语言理解准确率只有60%
工人说「今天做了50个」——AI助手需要理解这是「生产订单号XXX的完成数量50」。一开始我没做任何训练，直接接的通用大模型，结果准确率只有60%，工人骂娘。
解决方案：在Builder的「意图识别」配置里，加了一层「领域词典」+「示例训练」：
领域词典：导入该客户的「产品编号」「工序名称」「班组代号」，共300多条 示例训练：收集了20个工人真实报工话术，标注对应的字段映射
加完这两层，准确率跑到85%。剩下的15%是口音问题和「今天做了差不多50个吧」这种模糊表达，我加了一个「确认环节」：AI助手会复述「确认：订单#PO20240701，完成数量50，是否提交？」，工人回复「对」再写入。
坑3：YonSuite API限流让我措手不及
测试环境一切正常，上线第一天上午10点，工人集中报工，AI助手突然开始报错「API调用频率超限」。
查了YonSuite的API文档才知道：YonSuite的开放API有「租户级QPS限制」，标准版是「每秒5次」，我们那个客户有80个工人同时报工，直接打爆了。
解决方案：在CoMi Builder的「API调用」节点前，加了一个「请求队列+限速器」：
把并发请求改成「每秒最多3次」 超出部分进入队列，排队执行 队列长度设50，超出就提示「当前报工人数较多，请稍等片刻」
改完之后再没出过限流问题。但这个坑如果提前压测就能发现，我是在生产环境踩的。
坑4：附件上传的坑比想象中深
车间报工需要上传「质检照片」，工人用手机拍完直接发到AI助手对话框。一开始Builder默认的附件处理是「临时存储+24小时过期」，结果第二天MES系统想调这张照片的时候，链接已经失效了。
解决方案：改成了「附件→对象存储→持久化URL」的链路：
AI助手收到图片后，先调YonSuite的「附件上传API」存到YonSuite的附件服务器 拿到持久化的FileID和下载URL 把这个URL写进「生产报工表」的「质检附件」字段 MES系统通过YonSuite API直接拿这个URL，不会过期
这个方案需要YonSuite开「附件API」权限，标准版是支持的，但要在「开放平台」里单独申请。
坑5：多轮对话的上下文管理
最后一个坑是「工人说了一半换话题」。比如工人说「今天做了50个」，AI助手问「请问是哪个订单？」，工人突然说「对了，昨天那个不良品怎么处理？」——这时候上下文就乱了。
解决方案：在Builder的「对话管理」里设置了「意图超时+主动澄清」机制：
每个「报工意图」设置120秒超时，超时后自动清理上下文 如果检测到用户切换了话题（意图分类器识别到新意图），主动说「好的，我们先处理不良品问题，报工稍后继续」 用「会话变量」记录未完成的状态，用户可以随时说「继续报工」恢复
这个功能CoMi Builder是支持的，但需要手动配置「意图切换检测」，默认是不开的。
总结：CoMi Builder搭AI助手，80%的时间是花在「权限+API+边界处理」上，真正拖拽组件可能只用了20%。如果你正在做类似项目，建议提前把YonSuite的API限流、权限模型、附件存储这三个点摸清楚，能少踩很多坑。
你们在用CoMi Builder做哪些场景？评论区聊聊，我看到回复。
关注「小勇AI笔记」，每周分享AI实战踩坑记录。
