hermes agent知识库构建有五种方法：一、命令行批量导入；二、webui拖拽上传；三、配置自动监听目录增量同步；四、手动注入文本至memory.md；五、挂载外部只读目录作为知识源。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署Hermes Agent但AI无法准确回答基于您个人文档的问题，则可能是知识库未正确建立或私有数据未完成向量化投喂。以下是构建HermesAgent知识库并完整投喂私有数据的多种进阶方法：
一、使用 hermes rag import 命令批量导入
该方法适用于结构清晰的本地文档目录，通过命令行直接触发向量化索引构建，是RAG知识库最标准的初始化方式，支持递归扫描与多格式解析。
1、确保知识文档已按分类存放于统一路径，例如/home/user/knowledge/internal/；
2、执行创建知识库集合命令：hermes rag create --collection internal-docs --label "内部文档问答"；
3、运行导入指令并启用递归扫描：hermes rag import /home/user/knowledge/internal/ --collection internal-docs --recursive；
4、等待终端输出"Indexing completed. X chunks embedded."类似提示，表示向量索引已生成。
二、通过 WebUI 拖拽上传单文件
该方法适合临时添加少量高优先级文档，无需命令行操作，所有处理在浏览器中完成，且支持即时预览解析效果与分块质量反馈。
1、启动Web界面：hermes webui，在终端查看输出的访问地址（如 http://localhost:8000）；
2、用浏览器打开该地址，点击左侧导航栏的"Knowledge"选项卡；
3、在右侧区域找到"Upload Document"区域，将PDF或Markdown文件直接拖入虚线框内；
4、上传完成后，页面显示"Processing → Ready"状态，此时该文档已进入向量数据库并可被检索。
三、配置自动监听目录实现增量同步
该方法用于长期维护场景，使Hermes Agent持续监控指定文件夹，一旦新增或修改文档即自动触发解析与索引更新，无需人工干预，保障知识库实时性。
1、编辑配置文件：nano ~/.hermes/config.yaml；
2、在rag:节点下添加监听配置段落：watch_paths: ["/home/user/knowledge/auto-import"]；
3、确保目标路径存在且已放入至少一个测试文档，例如/home/user/knowledge/auto-import/合同模板_v2.md；
4、重启服务使监听生效：hermes stop && hermes start；
5、观察终端日志中是否出现"Detected new file: 合同模板_v2.md → indexing"字样。
四、手动注入纯文本片段至 MEMORY.md
该方法适用于非结构化关键信息，如会议结论、临时决策、口头约定等无法归档为正式文档的内容，直接写入记忆层，绕过向量索引流程，实现即时生效。
1、定位记忆文件路径：~/.hermes/MEMORY.md；
2、使用编辑器打开该文件：nano ~/.hermes/MEMORY.md；
3、在文件末尾新增段落，格式为：### [2026-05-15] 项目启动会结论\n- 客户确认UI稿终版交付时间为5月28日\n- 后端接口文档需同步更新至Confluence /api/v2/路径下；
4、保存退出后，无需重启服务，Hermes Agent将在下一次查询时自动加载该条目。
五、挂载外部只读目录作为知识源
该方法适用于企业级合规场景或跨设备共享知识库，将NAS、加密U盘或网络存储中的只读文档目录挂载为知识源，避免本地复制与权限冲突。
1、挂载外部存储（以NFS为例）：sudo mount -t nfs 192.168.1.100:/data/kb-readonly /mnt/kb-readonly；
2、验证挂载权限：ls -l /mnt/kb-readonly | head -n 3，确认显示read-only标识；
3、在config.yaml中配置：directories: ["/mnt/kb-readonly"]，并设置read_only: true；
4、执行索引重建：hermes rag rebuild --all；
5、检查日志中是否出现"Mounted read-only source: /mnt/kb-readonly"及对应chunk计数。
