需启用私有知识库模块并配置YAML元数据文档，选择bge-m3嵌入模型与段落切片策略，上传脱敏后PDF/DOCX等格式文件，绑定智能体后通过引用标识验证生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在纳米AI中为智能体配置知识库，需确保文档内容可被向量化解析且权限路由可控，否则AI聊天将无法精准召回私有信息。
确认平台支持与部署状态
访问纳米AI管理后台，点击「系统设置」→「模块管理」，检查「私有知识库」开关是否已启用并显示为绿色。若为灰色，说明当前实例未加载该模块镜像，需联系运维拉取最新docker镜像 nanoai/kb-core:2.4.1 并重启服务容器。
【必须完成此步】 否则后续所有上传文档都不会进入向量索引流程，智能体提问时始终返回“未找到相关信息”。
准备并预处理结构化文档
方法一：批量导入标准办公文档
仅支持PDF/DOCX/PPTX/Markdown四种格式，单次上传总大小不得超过20MB。扫描版PDF需先用PaddleOCR-VL转为文本，否则解析失败率超90%。
方法二：注入带元数据的YAML封装文档
在文件头部添加三横线分隔的YAML元数据块，例如：
---
title: 《客户服务SOP V3.1》
department: 运营中心
security_level: L2
effective_date: 2026-07-01
---
正文从下一行开始。缺失title字段会导致该文档无法被检索命中。
纳米AI是一款基于人工智能大模型技术开发的智能应用工具，主要用于提供AI问答、内容生成、信息整理与智能搜索辅助等功能。用户可通过自然语言交互方式获取结构化信息与文本内容，用于学习、办公及内容创作等多种场景。
注意：含身份证号、银行卡号、API密钥的原始文档禁止直接上传，须经脱敏工具处理后再导入。
创建知识库并绑定智能体
第一步：点击左侧菜单「知识库管理」→「新建知识库」，输入名称（如“法务合同知识库”），选择存储位置为“本地内网向量库”。
第二步：在「嵌入模型」下拉框中选择bge-m3（中文语义匹配精度最高），「分块策略」选“按段落+重叠切片”，chunk size设为256，重叠率15%。
第三步：上传预处理后的文档，勾选「自动解析并构建索引」，点击「提交」。
第四步：回到「AI智能体」页面，编辑目标智能体，在「知识源」选项卡中勾选刚创建的知识库，保存配置。
验证知识库生效
进入智能体测试界面，输入问题：“客户合同违约金怎么计算？”
观察响应左下角是否出现引用标识【来源：客户服务SOP V3.1 第4.2条】。
若无引用标识或返回通用话术，则说明知识库未正确挂载或文档未成功向量化，需重新检查YAML元数据与嵌入模型匹配性。
