MQTT连接失败常见原因有五类：认证参数错误（返回码4或5）、网络连接问题（TCP超时）、地址端口错误（如SSL用1883）、权限策略缺失（连接成功但无法收发）、设备状态冲突（Client ID重复导致踢下线）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想让扣子AI智能体准确回答“MQTT协议怎么配置客户端”或“飞书API调用失败常见原因”，但智能体默认只会凭训练数据瞎猜——必须让它读你上传的PDF、Excel或飞书文档才行，否则它连你公司内部的接口字段名都答不对。
上传本地文件建知识库
进入Coze个人空间→点击「知识库」→「创建知识库」，名称填“内部技术文档”，描述写“含MQTT、飞书API、数据库设计三类资料”。
在「导入类型」选「本地文档」，点击「上传文件」，支持PDF、DOCX、TXT、CSV、MD格式。一次最多传20个文件，单个不超过100MB。
上传后勾选「自动分段与清洗」：它会把PDF里每页拆成独立段落，删掉页眉页脚和扫描残留噪点，避免模型误读乱码。若文档是代码手册，建议手动分段，用“##”作为分隔符，否则函数说明和参数表可能被切散。
点击「确认」，等待状态变成「就绪」。此时知识库右上角显示“分段数：47”，代表原始文档被切成47块可检索单元——【分段越细、检索越准，但太多会拖慢响应】。
从飞书同步最新文档
首次使用需授权：点击「导入类型」→「飞书」→「立即授权」，跳转到飞书安装扣子应用，完成授权后返回Coze页面。
在飞书文档列表中，勾选你要同步的3份文档：《飞书开放平台接入指南》《MQTT调试日志模板》《数据库字段字典》，点击「下一步」。
分段设置阶段，选择「自定义」→分段标识符填“---”，因为这三份文档都用三横线分隔章节；最大长度设为512字符，防止一段里塞进两个接口的请求示例。
处理完成后，知识库会显示「最后更新时间：2026-07-28 11:23」。注意：【飞书文档后续编辑，知识库不会自动刷新，必须点知识库右上角「添加内容」重新同步】。
在智能体中启用知识库
打开目标智能体→左侧菜单点「工作流」→在对话节点前插入「知识库」模块。
第一步：点击模块右上角「配置」→在「知识库」下拉框中，勾选刚建好的“内部技术文档”和“飞书同步资料”两个知识库。
第二步：滚动到「高级设置」→把「相关性阈值」从默认0.5调高至0.7。这样能过滤掉匹配度低的干扰段落，比如问“如何重置token”，就不会召回“数据库连接超时”的段落。
第三步：保存后，在右侧「预览与调试」输入测试问题：“MQTT客户端connect报错code=5，可能原因有哪些？”，智能体将从你上传的PDF和飞书文档中精准定位到对应排错章节并生成回答。
