RAG功能未正确配置导致AI未使用专属内容。需依次启用内置知识库、设置检索权重、用@前缀调用、验证生效状态、对接企业文档系统。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在使用骡子快跑时接入自有文档、内部资料或行业数据，但发现ai回复仍基于通用知识而非您的专属内容，则可能是rag（检索增强生成）功能尚未正确配置。以下是实现知识库接入的具体操作路径：一、启用内置知识库上传模块
骡子快跑为每位用户提供独立云端虚拟机环境，其RAG能力默认集成于个人工作区的知识管理面板中，无需额外部署向量数据库或调用外部API。该模块支持将本地文件解析为语义向量，并与用户行为画像动态绑定。
1、登录mulerun.com后，点击左下角「我的知识库」进入管理界面。
2、点击「+ 新建知识集」，输入名称如“电商运营手册”或“公司产品白皮书”。
3、拖拽PDF、TXT、DOCX、MD格式文件至上传区域，单次最多支持50个文件，总容量上限为2GB。
4、勾选「自动切片与嵌入」选项，系统将调用Gemini Embedding 2模型完成多模态向量化处理。
5、点击「发布并启用」，该知识集即刻生效，后续所有对话将优先检索此集合内内容。
二、配置私有知识源的检索权重
骡子快跑允许对不同知识源设置响应优先级，确保关键文档在多源冲突时获得更高置信度输出。该机制通过语义相似度阈值与来源可信度双维度控制，避免通用知识覆盖专业判断。
1、在「我的知识库」列表中，找到已上传的知识集右侧操作栏，点击「权重设置」。
2、滑动「领域专精度」条至85%以上，适用于技术规范、合同条款等强约束性文档。
3、开启「时效敏感开关」，系统将自动识别文档内日期字段，对超180天未更新的内容降低检索权重。
4、点击「保存策略」，修改即时同步至当前用户的Agent运行时环境。
三、通过自然语言指令触发特定知识源
用户可在任意对话框中使用前缀语法显式调用指定知识集，绕过全局检索流程，实现毫秒级定向响应。该方式适用于需严格依据某份文件作答的场景，如法务审核、合规检查等。
1、在聊天输入框中键入「@电商运营手册」，随后接续问题，例如：“@电商运营手册 退货率超过5%时应启动哪些SOP？”
2、系统识别到@符号后缀后，立即锁定对应知识集进行局部检索，不加载其他知识源。
使用AIsa生成图像与视频。仅需一个API密钥即可调用Gemini 3 Pro Image（图像）和Qwen Wan 2.6（视频）。
3、若该知识集中无匹配段落，界面将显示未在指定知识库中找到相关依据，并保持静默，不回退至通用模型。
4、连续两次使用同一知识源前缀后，系统自动记忆偏好，在后续30分钟内默认启用该知识集。
四、验证知识库生效状态
配置完成后需执行有效性校验，确保向量化质量与检索逻辑符合预期。骡子快跑提供实时诊断看板，可查看分词准确率、向量密度分布及Top3命中片段原文。
1、进入「知识库诊断中心」，选择目标知识集后点击「运行健康检测」。
2、等待约12秒，页面显示「语义切片完成」「向量空间密度达标」「跨文档关联正常」三项绿色标识。
3、在测试框中输入问题：“这份文档里提到的KPI阈值是多少？”，观察返回结果是否精确指向原文数值及上下文段落。
4、若出现检测到高亮关键词未被向量化提示，需返回编辑该文档，将术语加粗或单独成行后重新上传。
五、对接企业级文档管理系统
对于已部署SharePoint、Confluence或钉钉知识库的企业用户，骡子快跑支持OAuth2.0协议直连，无需导出文件即可建立增量同步通道。该连接采用端到端加密传输，所有文档元数据均保留在客户侧服务器中。
1、在「知识库」页点击「连接外部系统」，选择对应平台图标。
2、输入企业域名（如company.atlassian.net），点击「获取授权码」跳转至SSO登录页。
3、管理员授予「只读+目录遍历」权限后，返回骡子快跑界面选择需同步的空间或文件夹。
4、设定同步周期为「每6小时自动拉取变更」，首次全量同步将在后台持续运行，完成后弹出已建立17个文档节点映射关系提示。
