企业需构建结构化知识库提升员工效率：/knowledge/internal存原始文档，/knowledge/faq存.json格式问答；用hermes命令创建并导入internal-docs和customer-support两个向量库；配置飞书或企微接入，通过access_groups实现权限隔离；启动服务后curl验证rag检索准确率。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
企业需要让客服、销售、HR等岗位员工快速从内部制度、产品手册、FAQ中获取准确答案，避免翻文档、问同事、查邮件的低效重复劳动。
准备知识库文档结构
在项目根目录下创建 【/knowledge/】 文件夹，严格按用途分两个子目录：internal（内部文档）和faq（客服问答）。
internal目录下放产品手册.md、技术白皮书.pdf、人事制度.docx等原始材料；faq目录下只放结构化问答对，必须是.json格式，字段为{"question": "用户怎么重置密码？", "answer": "进入个人中心→安全设置→点击‘忘记密码’链接，按提示操作。"}。
不支持Excel或网页截图直接放入，PDF必须是文字可选中的版本，扫描件需先OCR识别再转成PDF。
创建并导入向量数据库
执行两条命令分别建立两个知识库：
hermes rag create --collection internal-docs --label "内部文档问答"
hermes rag create --collection customer-support --label "客服知识库"
确认collection名称拼写完全一致，后续导入和调用时大小写、连字符都不能错，否则报错后无法自动修复。
接着导入文档：
hermes rag import /knowledge/internal/ --collection internal-docs --recursive
hermes rag import /knowledge/faq/ --collection customer-support --recursive
导入过程会自动切片、向量化、去重，耗时取决于PDF页数和文件总大小，100MB以内通常在90秒内完成。
配置多平台接入与权限隔离
方法一：飞书机器人接入
在飞书管理后台创建自定义机器人，复制Webhook地址；运行 hermes platform add feishu --webhook https://open.feishu.cn/open-apis/bot/v2/hook/xxx
方法二：企业微信私有部署
编辑 config/platforms/wecom.yml，填入corpid、corpsecret、agentid；确保服务器能访问企业微信API域名，防火墙需放行443端口。
关键控制点：在 config/rag.yml 中为每个collection指定access_groups，例如 internal-docs 只允许 group:tech 和 group:hr 访问，customer-support 对所有成员开放。未配置的group默认无权查询任何知识库。
启动服务并验证首条问答
第一步：运行 hermes serve 启动核心服务，终端输出 “Agent server listening on :8080” 即表示就绪。
第二步：打开另一个终端，执行 curl -X POST http://localhost:8080/rag/query -H "Content-Type: application/json" -d '{"collection":"customer-support","query":"订单七天无理由退货怎么操作？"}'
第三步：观察返回JSON中的answer字段是否包含明确步骤和依据条款，若出现“根据公司制度第3.2条”之类溯源标记，说明RAG检索+生成链路已通。
