若微灵ai客户端无法理解本地文档，需通过网页控制台上传、桌面客户端批量导入或api接口注入三种方式完成知识库构建与向量训练。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装微灵AI客户端，但无法将本地文档纳入其知识理解范围，则可能是由于私有资料未正确上传或未触发向量训练流程。以下是导入知识库并完成私有资料训练的具体操作路径：
一、通过网页控制台上传文件
该方式适用于Windows/macOS用户，支持PDF、TXT、Markdown、PPTX等常见格式，上传后系统将自动解析文本并构建向量索引。需确保文件内容为可提取文字的格式，扫描版PDF需预先OCR处理。
1、打开微灵AI官网，使用已绑定账号登录控制台。
2、在左侧导航栏点击“知识库管理”，进入资料上传界面。
3、点击“+ 新建知识库”，输入名称（如“技术文档库”），选择隐私级别为“仅本人可见”。
4、在知识库详情页点击“添加文件”，将目标文档拖入上传区域，或点击手动选择文件。
5、等待状态栏显示“上传完成”，此时文件名右侧出现绿色对勾图标。
6、点击“启动训练”，系统开始内容切分与向量化，进度条达100%即表示训练就绪。
二、使用桌面客户端批量导入
该方式支持离线环境下的多文件连续处理，适用于拥有大量本地资料的用户。客户端会自动识别文件编码与结构层级，并保留原始段落逻辑关系。
1、启动微灵AI桌面端，在主界面右上角点击齿轮图标进入“设置”。
2、选择“本地知识源”选项卡，开启“启用本地文件夹同步”开关。
3、点击“添加文件夹”，定位至存放私有资料的目录（例如：D:\MyDocs\AI-Reference）。
4、勾选需纳入训练的子文件夹，取消勾选临时草稿或重复备份类目录。
5、点击“应用配置”，客户端立即扫描新增/变更文件，并标记为“待训练”。
6、返回主界面，点击底部状态栏中的“立即构建索引”，触发全量向量训练流程。
三、通过API接口注入结构化数据
该方式适用于已有数据库或CMS系统的用户，可绕过手动上传环节，直接将清洗后的文本片段以JSON格式推送到微灵AI后端，实现知识库的程序化更新。
1、在控制台“开发者中心”中创建新API密钥，记录下access_token与endpoint地址。
2、构造POST请求体，包含字段：content（纯文本）、source_id（唯一标识符）、metadata（可选键值对，如author、date）。
3、设置HTTP头：Authorization: Bearer {access_token}，Content-Type: application/json。
4、向endpoint发送请求，响应状态码为201时表示成功入队。
5、登录控制台，在“任务日志”中确认该批次数据已进入“向量化中”队列。
6、等待日志显示“向量写入完成”，对应source_id的数据即可被问答模块调用。
