WeKnora 实战将《智能家居中控 Pro 产品手册》构建为可检索知识库与 FAQ 问答【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora导读《智能家居中控 Pro 产品手册》是 WeKnora 仓库 website-docs/sample-data 中提供的示例语料之一与《Q1 产品会议纪要》《员工手册》《售后知识库 POC 技术方案》和《FAQ 导入样例》共同构成一套完整的演示数据集。本文以这份产品手册为骨架完整梳理其技术规格、首次配置、场景联动与常见问题并在此基础上讲解如何利用 WeKnora 的文档入库管线、FAQ 知识库与混合检索能力把一份静态 Markdown 手册升级为可供一线工程师和客服直接查询、带出处的智能问答系统。读完本文你将掌握文档型知识库 FAQ 标准问答库双轨建库的完整路径。一、示例语料定位产品手册在 RAG 系统中的角色在 WeKnora 的文档体系里sample-data目录是一套刻意设计的仿真语料五个文件相互呼应文件语料类型在知识库中的用途01-产品手册-智能家居中控.md产品手册回答规格、配置、场景、保修类问题02-会议纪要-Q1产品规划.md会议纪要回答里程碑、谁负责何时交付类问题03-员工手册-报销与休假.md制度文档回答差旅、报销、年假类问题04-技术方案-售后知识库POC.md技术方案说明 POC 的架构、语料清单与验收标准05-常见问题-FAQ导入样例.jsonFAQ 条目演示 FAQ 知识库的标准问 / 相似问 / 答案结构其中产品手册是这套语料的核心FAQ 导入样例中约一半条目保修时长、断网语音、账号绑定中控数量、支持协议、Matter 认证计划等都直接源自手册正文。这意味着一份产品手册既可以作为文档型知识库的原始语料也可以被二次提炼成 FAQ 标准问答库两者互补正是 WeKnora 多知识库设计的典型用法。二、语料全解析智能家居中控 Pro 产品手册该文档是一份完整的产品手册包含型号版本信息、产品概述、技术规格、首次配置、场景联动和 FAQ 六个部分下面逐节继承并展开。2.1 产品概述产品型号HUB-Pro-2024文档版本v2.1适用固件≥ 3.4.0。智能家居中控 Pro 是星云科技NovaTech推出的家庭物联网中枢负责统一管理灯光、空调、窗帘、安防传感器等设备用户可通过手机 App、语音助手或本地触摸屏完成场景联动。核心卖点本地离线可用断网后局域网内仍可执行已配置场景多协议兼容同时支持 Matter、Zigbee 3.0、Wi-Fi 与蓝牙 Mesh边缘 AI内置轻量模型可识别「我回家了」「准备观影」等口语化指令。从 RAG 语料的角度看这些概述性文字中包含了本地离线多协议边缘 AI等高价值关键词是回答这产品有什么能力类问题的检索入口。2.2 技术规格项目参数处理器四核 ARM Cortex-A551.8 GHz内存 / 存储4 GB RAM / 32 GB eMMC无线协议Wi-Fi 6、Zigbee 3.0、蓝牙 5.2、Thread有线接口千兆以太网 ×1、USB-C调试×1供电DC 12V / 2A典型功耗 8W工作温度0℃ ~ 40℃最大接入设备数256推荐 ≤ 120 以保证响应速度这是整份手册中结构化程度最高的内容。在 04-技术方案-售后知识库POC.md 的验收用例里中控 Pro 最多能接多少设备这一题的标准答案正是从本表提取的256推荐 ≤ 120。表格类内容在分块时尤其需要注意上下文保留——这正是 WeKnora 分块参数中chunk_overlap与父子分块要解决的场景详见第三节。2.3 首次配置手册给出四条配网步骤将设备接通电源指示灯呈蓝色慢闪表示等待配网。打开 NovaHome App选择「添加中控」扫描机身二维码。按向导连接家庭 Wi-Fi若使用有线网络可跳过 Wi-Fi 步骤。完成固件检查如有更新建议先升级再添加子设备。注意首次配网时手机需与中控处于同一 2.4 GHz 频段。5 GHz-only 路由器需先开启 2.4 GHz 兼容模式。这类步骤 注意事项的流程型内容是售后工单的高频查询主题。在 WeKnora 中它们最适合以父子分块方式入库检索命中细节子块生成回答时使用包含完整流程的父块避免上下文被切断。2.4 场景联动示例「回家模式」——触发条件满足任一即可手机 GPS 进入家庭地理围栏大门指纹锁解锁语音说「我回来了」。执行动作客厅主灯调至 70% 暖白光空调设为 26℃ 制冷仅夏季模板生效关闭安防布防。「离家模式」——触发条件所有家庭成员手机离开地理围栏超过 5 分钟。执行动作关闭全屋灯光、关闭空调、启动安防布防、关闭燃气机械手如已接入。场景联动内容体现了条件 → 动作的语义结构属于典型的多条件段落验证分块策略时可以用它来观察模型是否能把触发条件和执行动作完整关联起来。2.5 手册内 FAQ问题答案要点中控离线后语音还能用吗云端识别模式断外网后仅支持 App 与本地触摸屏配置本地语音包后可继续使用基础指令一个账号能绑定几台中控个人版最多 3 台企业版按合同授权默认 50 台保修政策整机保修 24 个月电池类配件 12 个月人为拆解、进水不在保修范围这三组问答与 05-常见问题-FAQ导入样例.json 中standard_question为智能家居中控保修多久断网后语音还能用吗一个账号能绑几台中控的条目一一对应是手册向 FAQ 库转化的直接素材第四节将展开讲解这一转化。三、文档入库把 Markdown 手册变成可检索的知识产品手册要能被检索和回答先要经过 WeKnora 的文档入库管线。整个链路为上传 → 存储 → 解析 → 分块 → 向量化 → 索引详见 文档入库流程。3.1 建库与上传在 Web 前端创建类型为document的知识库将本手册的 Markdown 文件上传即可完整路径参考 快速上手。Markdown 由独立的 Python 微服务 docreader 解析其解析器矩阵覆盖 Markdown / HTML / PDF / Office 等多种格式见 文档解析服务。3.2 分块参数从 POC 方案继承的实践值04-技术方案-售后知识库POC.md 针对这套语料给出了可直接落地的分块建议参数值说明chunk_size512与手册段落长度匹配chunk_overlap64保留表格上下文父子分块开启检索命中子块、生成用父块这组数值的设计意图值得展开手册正文段落平均长度与 512 字符的切分窗口大致吻合overlap64用于把最大接入设备数这类紧贴表格下方的结论行与规格表本体关联起来父子分块则保证回答生成时能拿到完整段落而非被截断的子块。WeKnora 的分块机制本身是自适应的heading / heuristic / recursive 三种策略详见 分块机制。3.3 检索策略混合检索 RRF 可选 RerankPOC 方案的检索策略同样是现成的实践模板默认向量 BM25 混合检索RRF 融合Top-5 送入 LLM可选开启 Rerankbge-reranker-v2-m3提升多义词场景准确率暂不启用知识图谱Neo4j与 Wiki 自动生成。混合检索解决了产品手册中规格数字靠关键词精确命中、场景描述靠语义召回的两种需求差异各检索引擎的能力对比见 检索引擎与向量存储。四、FAQ 化从手册问答到标准问答库产品手册中的 FAQ 是零散排布的回答质量依赖检索命中。WeKnora 的 FAQ 知识库KB 类型为faq把它们转化为结构化条目检索时直接匹配问题并按策略返回标准答案详见 FAQ 能力。4.1 样例 JSON 的结构解析05-常见问题-FAQ导入样例.json 中的每个条目包含五个字段与 WeKnora 的 FAQ 条目模型一一对应{ tag_name: 售后, standard_question: 智能家居中控保修多久, similar_questions: [保修期几年, 质保多长时间], negative_questions: [], answers: [整机保修 24 个月电池类配件 12 个月。人为拆解、进水不在保修范围。] }JSON 字段对应 FAQ 条目概念说明tag_name分类标签FAQ 分类为单标签默认未分类standard_question标准问必填条目的规范表述similar_questions相似问覆盖不同口语表达多值用##分隔negative_questions反例问命中即过滤该条目用于排除误匹配answers答案必填可多条按answer_strategy全部返回或随机返回注意样例中保修多久这条的similar_questions覆盖了保修期几年质保多长时间两种说法这正是 FAQ 知识库相对纯文档检索的优势把不同问法收敛到同一标准答案。而negative_questions字段样例中为空数组对应检索时的负例过滤机制——例如问不支持 X 吗就不会错误命中支持 X的条目。4.2 数据模型一个 FAQ 条目 一个 Chunk在 internal/types/faq.go 中每个 FAQ 条目对应一条ChunkType faq的 Chunk结构化内容存放在FAQChunkMetadata中type FAQChunkMetadata struct { StandardQuestion string json:standard_question SimilarQuestions []string json:similar_questions,omitempty NegativeQuestions []string json:negative_questions,omitempty // 反例问命中即过滤 Answers []string json:answers,omitempty AnswerStrategy AnswerStrategy json:answer_strategy,omitempty // all | random Version int json:version,omitempty // 每次更新自增 Source string json:source,omitempty }其中AnswerStrategy取值为all返回全部答案或random随机返回一个默认all。条目的分类、启停、推荐位则复用 Chunk 通用字段TagID、IsEnabled、Flags中的ChunkFlagRecommended。4.3 批量导入append / replace 与 dry_runFAQ 条目通过POST /knowledge-bases/:id/faq/entries批量导入实现见 internal/application/service/knowledge_faq_import.go核心参数type FAQBatchUpsertPayload struct { Entries []FAQEntryPayload json:entries binding:required Mode string json:mode binding:oneofappend replace KnowledgeID string json:knowledge_id TaskID string json:task_id // 可选不传自动生成 UUID DryRun bool json:dry_run // 仅验证不落库 }append按内容哈希匹配已有条目命中则合并保留标准问、追加去重后的相似问、覆盖答案未命中则新增replace删除全部旧条目仅保留本批导入内容dry_run仅运行格式校验、批内去重、DB 查重与内容安全检查不落库适合先验证样例 JSON 再正式导入。导入是异步任务可通过GET /faq/import/progress/:task_id轮询进度返回success_count/failed_count/partial_failed_count/skipped_count/merged_count/added_count等统计以及失败条目明细 CSV。4.4 检索命中策略负例过滤与迭代召回FAQ 检索internal/handler/faq.go 的SearchFAQ internal/application/service/knowledgebase_search_faq.go的命中流程为混合召回查询文本归一化后做向量检索 BM25 关键词检索融合去重两级标签优先FirstPriorityTagIDs命中的条目排最前其次SecondPriorityTagIDs负例过滤查询文本与某条目的任一反例问完全匹配小写比较→ 剔除该条目迭代召回过滤后结果不足match_count且向量结果打满时最多迭代 5 次、每次 TopK 翻倍带去重与负例过滤缓存无新结果提前终止结果附带score、match_type、matched_question实际命中的是标准问还是哪个相似问答案按answer_strategy返回。FAQSearchRequest的关键参数VectorThreshold默认 0.7、MatchCount默认 10上限 50、OnlyRecommended。请求参数可通过 FAQ 检索 API 直接调试。五、端到端演练从语料到验收的 POC 路径04-技术方案-售后知识库POC.md 给出了这套语料的完整落地模板核心要素架构链路Confluence 导出 / Markdown / PDF 手册 → WeKnoradocreader 解析 → 分块 → 向量 BM25 混合检索→ 模型层本地 bge-m3 Embedding 公司 API 网关的 DeepSeek-V3→ 售后工单系统 iframe 嵌入二期。首批语料清单与预估分块数文档格式预估分块智能家居中控 Pro 产品手册Markdown / PDF40Q1 产品会议纪要Markdown25员工手册 · 报销与休假Markdown30Top 50 工单 FAQExcel 导入50验收用例节选问题期望答案要点期望出处中控 Pro 最多能接多少设备256推荐 ≤ 120产品手册 · 技术规格Q1 知识库 POC 什么时候验收2024-03-01 内网上线Q1 会议纪要一线城市住宿报销上限600 元 / 晚员工手册 · 差旅报销Matter 认证目标版本固件 3.53 月底灰度Q1 会议纪要谁负责售后知识库 POC张明会议纪要 / 本方案这套验收表的设计值得借鉴每道题同时校验答案要点与期望出处与 WeKnora回答必须带出处链接的要求一致——FAQ 库返回matched_question文档库通过引用面板给出可追溯的原始段落二者都能满足可追溯这一验收底线。六、实践要点与注意事项结合手册内容与 WeKnora 实现梳理几条落地要点文档库与 FAQ 库各司其职开放式的怎么配置支持什么问题交给文档库混合检索高频、答案固定的标准问答保修、限购、报销上限沉淀为 FAQ 条目。FAQ 库可与文档库一起供 Agent 检索启用 FAQ 优先并满足直接回答阈值时可直接返回标准答案。语料过期管理POC 方案明确列出语料过期为首要风险——手册 v2.1 与即将发布的 v2.2 冲突时需要建立语料 Owner机制定期核对这正是 02-会议纪要-Q1产品规划.md 中提到的售后语料质量参差风险的缓解手段。幻觉抑制强制 Prompt 要求仅根据引用回答无依据则回复不知道避免模型在手册范围外自由发挥。权限边界POC 阶段单租户即可生产环境按区域售后组拆分知识库 ACL对应 WeKnora 的多租户与知识库访问控制能力见 租户、用户与认证授权。实现参考以下路径均相对仓库根目录可按需深入主题文件示例语料产品手册website-docs/sample-data/01-产品手册-智能家居中控.md示例语料FAQ 导入样例website-docs/sample-data/05-常见问题-FAQ导入样例.json示例语料POC 技术方案website-docs/sample-data/04-技术方案-售后知识库POC.mdFAQ 功能文档website-docs/03-features/17-faq.mdFAQ 类型与归一化哈希internal/types/faq.goFAQ Handler 与 APIinternal/handler/faq.goFAQ 批量导入服务internal/application/service/knowledge_faq_import.goFAQ 检索后处理internal/application/service/knowledgebase_search_faq.go文档入库管线website-docs/02-architecture/03-document-pipeline.md快速上手website-docs/01-getting-started/03-quickstart.md【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WeKnora 实战：将《智能家居中控 Pro 产品手册》构建为可检索知识库与 FAQ 问答
WeKnora 实战将《智能家居中控 Pro 产品手册》构建为可检索知识库与 FAQ 问答【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora导读《智能家居中控 Pro 产品手册》是 WeKnora 仓库 website-docs/sample-data 中提供的示例语料之一与《Q1 产品会议纪要》《员工手册》《售后知识库 POC 技术方案》和《FAQ 导入样例》共同构成一套完整的演示数据集。本文以这份产品手册为骨架完整梳理其技术规格、首次配置、场景联动与常见问题并在此基础上讲解如何利用 WeKnora 的文档入库管线、FAQ 知识库与混合检索能力把一份静态 Markdown 手册升级为可供一线工程师和客服直接查询、带出处的智能问答系统。读完本文你将掌握文档型知识库 FAQ 标准问答库双轨建库的完整路径。一、示例语料定位产品手册在 RAG 系统中的角色在 WeKnora 的文档体系里sample-data目录是一套刻意设计的仿真语料五个文件相互呼应文件语料类型在知识库中的用途01-产品手册-智能家居中控.md产品手册回答规格、配置、场景、保修类问题02-会议纪要-Q1产品规划.md会议纪要回答里程碑、谁负责何时交付类问题03-员工手册-报销与休假.md制度文档回答差旅、报销、年假类问题04-技术方案-售后知识库POC.md技术方案说明 POC 的架构、语料清单与验收标准05-常见问题-FAQ导入样例.jsonFAQ 条目演示 FAQ 知识库的标准问 / 相似问 / 答案结构其中产品手册是这套语料的核心FAQ 导入样例中约一半条目保修时长、断网语音、账号绑定中控数量、支持协议、Matter 认证计划等都直接源自手册正文。这意味着一份产品手册既可以作为文档型知识库的原始语料也可以被二次提炼成 FAQ 标准问答库两者互补正是 WeKnora 多知识库设计的典型用法。二、语料全解析智能家居中控 Pro 产品手册该文档是一份完整的产品手册包含型号版本信息、产品概述、技术规格、首次配置、场景联动和 FAQ 六个部分下面逐节继承并展开。2.1 产品概述产品型号HUB-Pro-2024文档版本v2.1适用固件≥ 3.4.0。智能家居中控 Pro 是星云科技NovaTech推出的家庭物联网中枢负责统一管理灯光、空调、窗帘、安防传感器等设备用户可通过手机 App、语音助手或本地触摸屏完成场景联动。核心卖点本地离线可用断网后局域网内仍可执行已配置场景多协议兼容同时支持 Matter、Zigbee 3.0、Wi-Fi 与蓝牙 Mesh边缘 AI内置轻量模型可识别「我回家了」「准备观影」等口语化指令。从 RAG 语料的角度看这些概述性文字中包含了本地离线多协议边缘 AI等高价值关键词是回答这产品有什么能力类问题的检索入口。2.2 技术规格项目参数处理器四核 ARM Cortex-A551.8 GHz内存 / 存储4 GB RAM / 32 GB eMMC无线协议Wi-Fi 6、Zigbee 3.0、蓝牙 5.2、Thread有线接口千兆以太网 ×1、USB-C调试×1供电DC 12V / 2A典型功耗 8W工作温度0℃ ~ 40℃最大接入设备数256推荐 ≤ 120 以保证响应速度这是整份手册中结构化程度最高的内容。在 04-技术方案-售后知识库POC.md 的验收用例里中控 Pro 最多能接多少设备这一题的标准答案正是从本表提取的256推荐 ≤ 120。表格类内容在分块时尤其需要注意上下文保留——这正是 WeKnora 分块参数中chunk_overlap与父子分块要解决的场景详见第三节。2.3 首次配置手册给出四条配网步骤将设备接通电源指示灯呈蓝色慢闪表示等待配网。打开 NovaHome App选择「添加中控」扫描机身二维码。按向导连接家庭 Wi-Fi若使用有线网络可跳过 Wi-Fi 步骤。完成固件检查如有更新建议先升级再添加子设备。注意首次配网时手机需与中控处于同一 2.4 GHz 频段。5 GHz-only 路由器需先开启 2.4 GHz 兼容模式。这类步骤 注意事项的流程型内容是售后工单的高频查询主题。在 WeKnora 中它们最适合以父子分块方式入库检索命中细节子块生成回答时使用包含完整流程的父块避免上下文被切断。2.4 场景联动示例「回家模式」——触发条件满足任一即可手机 GPS 进入家庭地理围栏大门指纹锁解锁语音说「我回来了」。执行动作客厅主灯调至 70% 暖白光空调设为 26℃ 制冷仅夏季模板生效关闭安防布防。「离家模式」——触发条件所有家庭成员手机离开地理围栏超过 5 分钟。执行动作关闭全屋灯光、关闭空调、启动安防布防、关闭燃气机械手如已接入。场景联动内容体现了条件 → 动作的语义结构属于典型的多条件段落验证分块策略时可以用它来观察模型是否能把触发条件和执行动作完整关联起来。2.5 手册内 FAQ问题答案要点中控离线后语音还能用吗云端识别模式断外网后仅支持 App 与本地触摸屏配置本地语音包后可继续使用基础指令一个账号能绑定几台中控个人版最多 3 台企业版按合同授权默认 50 台保修政策整机保修 24 个月电池类配件 12 个月人为拆解、进水不在保修范围这三组问答与 05-常见问题-FAQ导入样例.json 中standard_question为智能家居中控保修多久断网后语音还能用吗一个账号能绑几台中控的条目一一对应是手册向 FAQ 库转化的直接素材第四节将展开讲解这一转化。三、文档入库把 Markdown 手册变成可检索的知识产品手册要能被检索和回答先要经过 WeKnora 的文档入库管线。整个链路为上传 → 存储 → 解析 → 分块 → 向量化 → 索引详见 文档入库流程。3.1 建库与上传在 Web 前端创建类型为document的知识库将本手册的 Markdown 文件上传即可完整路径参考 快速上手。Markdown 由独立的 Python 微服务 docreader 解析其解析器矩阵覆盖 Markdown / HTML / PDF / Office 等多种格式见 文档解析服务。3.2 分块参数从 POC 方案继承的实践值04-技术方案-售后知识库POC.md 针对这套语料给出了可直接落地的分块建议参数值说明chunk_size512与手册段落长度匹配chunk_overlap64保留表格上下文父子分块开启检索命中子块、生成用父块这组数值的设计意图值得展开手册正文段落平均长度与 512 字符的切分窗口大致吻合overlap64用于把最大接入设备数这类紧贴表格下方的结论行与规格表本体关联起来父子分块则保证回答生成时能拿到完整段落而非被截断的子块。WeKnora 的分块机制本身是自适应的heading / heuristic / recursive 三种策略详见 分块机制。3.3 检索策略混合检索 RRF 可选 RerankPOC 方案的检索策略同样是现成的实践模板默认向量 BM25 混合检索RRF 融合Top-5 送入 LLM可选开启 Rerankbge-reranker-v2-m3提升多义词场景准确率暂不启用知识图谱Neo4j与 Wiki 自动生成。混合检索解决了产品手册中规格数字靠关键词精确命中、场景描述靠语义召回的两种需求差异各检索引擎的能力对比见 检索引擎与向量存储。四、FAQ 化从手册问答到标准问答库产品手册中的 FAQ 是零散排布的回答质量依赖检索命中。WeKnora 的 FAQ 知识库KB 类型为faq把它们转化为结构化条目检索时直接匹配问题并按策略返回标准答案详见 FAQ 能力。4.1 样例 JSON 的结构解析05-常见问题-FAQ导入样例.json 中的每个条目包含五个字段与 WeKnora 的 FAQ 条目模型一一对应{ tag_name: 售后, standard_question: 智能家居中控保修多久, similar_questions: [保修期几年, 质保多长时间], negative_questions: [], answers: [整机保修 24 个月电池类配件 12 个月。人为拆解、进水不在保修范围。] }JSON 字段对应 FAQ 条目概念说明tag_name分类标签FAQ 分类为单标签默认未分类standard_question标准问必填条目的规范表述similar_questions相似问覆盖不同口语表达多值用##分隔negative_questions反例问命中即过滤该条目用于排除误匹配answers答案必填可多条按answer_strategy全部返回或随机返回注意样例中保修多久这条的similar_questions覆盖了保修期几年质保多长时间两种说法这正是 FAQ 知识库相对纯文档检索的优势把不同问法收敛到同一标准答案。而negative_questions字段样例中为空数组对应检索时的负例过滤机制——例如问不支持 X 吗就不会错误命中支持 X的条目。4.2 数据模型一个 FAQ 条目 一个 Chunk在 internal/types/faq.go 中每个 FAQ 条目对应一条ChunkType faq的 Chunk结构化内容存放在FAQChunkMetadata中type FAQChunkMetadata struct { StandardQuestion string json:standard_question SimilarQuestions []string json:similar_questions,omitempty NegativeQuestions []string json:negative_questions,omitempty // 反例问命中即过滤 Answers []string json:answers,omitempty AnswerStrategy AnswerStrategy json:answer_strategy,omitempty // all | random Version int json:version,omitempty // 每次更新自增 Source string json:source,omitempty }其中AnswerStrategy取值为all返回全部答案或random随机返回一个默认all。条目的分类、启停、推荐位则复用 Chunk 通用字段TagID、IsEnabled、Flags中的ChunkFlagRecommended。4.3 批量导入append / replace 与 dry_runFAQ 条目通过POST /knowledge-bases/:id/faq/entries批量导入实现见 internal/application/service/knowledge_faq_import.go核心参数type FAQBatchUpsertPayload struct { Entries []FAQEntryPayload json:entries binding:required Mode string json:mode binding:oneofappend replace KnowledgeID string json:knowledge_id TaskID string json:task_id // 可选不传自动生成 UUID DryRun bool json:dry_run // 仅验证不落库 }append按内容哈希匹配已有条目命中则合并保留标准问、追加去重后的相似问、覆盖答案未命中则新增replace删除全部旧条目仅保留本批导入内容dry_run仅运行格式校验、批内去重、DB 查重与内容安全检查不落库适合先验证样例 JSON 再正式导入。导入是异步任务可通过GET /faq/import/progress/:task_id轮询进度返回success_count/failed_count/partial_failed_count/skipped_count/merged_count/added_count等统计以及失败条目明细 CSV。4.4 检索命中策略负例过滤与迭代召回FAQ 检索internal/handler/faq.go 的SearchFAQ internal/application/service/knowledgebase_search_faq.go的命中流程为混合召回查询文本归一化后做向量检索 BM25 关键词检索融合去重两级标签优先FirstPriorityTagIDs命中的条目排最前其次SecondPriorityTagIDs负例过滤查询文本与某条目的任一反例问完全匹配小写比较→ 剔除该条目迭代召回过滤后结果不足match_count且向量结果打满时最多迭代 5 次、每次 TopK 翻倍带去重与负例过滤缓存无新结果提前终止结果附带score、match_type、matched_question实际命中的是标准问还是哪个相似问答案按answer_strategy返回。FAQSearchRequest的关键参数VectorThreshold默认 0.7、MatchCount默认 10上限 50、OnlyRecommended。请求参数可通过 FAQ 检索 API 直接调试。五、端到端演练从语料到验收的 POC 路径04-技术方案-售后知识库POC.md 给出了这套语料的完整落地模板核心要素架构链路Confluence 导出 / Markdown / PDF 手册 → WeKnoradocreader 解析 → 分块 → 向量 BM25 混合检索→ 模型层本地 bge-m3 Embedding 公司 API 网关的 DeepSeek-V3→ 售后工单系统 iframe 嵌入二期。首批语料清单与预估分块数文档格式预估分块智能家居中控 Pro 产品手册Markdown / PDF40Q1 产品会议纪要Markdown25员工手册 · 报销与休假Markdown30Top 50 工单 FAQExcel 导入50验收用例节选问题期望答案要点期望出处中控 Pro 最多能接多少设备256推荐 ≤ 120产品手册 · 技术规格Q1 知识库 POC 什么时候验收2024-03-01 内网上线Q1 会议纪要一线城市住宿报销上限600 元 / 晚员工手册 · 差旅报销Matter 认证目标版本固件 3.53 月底灰度Q1 会议纪要谁负责售后知识库 POC张明会议纪要 / 本方案这套验收表的设计值得借鉴每道题同时校验答案要点与期望出处与 WeKnora回答必须带出处链接的要求一致——FAQ 库返回matched_question文档库通过引用面板给出可追溯的原始段落二者都能满足可追溯这一验收底线。六、实践要点与注意事项结合手册内容与 WeKnora 实现梳理几条落地要点文档库与 FAQ 库各司其职开放式的怎么配置支持什么问题交给文档库混合检索高频、答案固定的标准问答保修、限购、报销上限沉淀为 FAQ 条目。FAQ 库可与文档库一起供 Agent 检索启用 FAQ 优先并满足直接回答阈值时可直接返回标准答案。语料过期管理POC 方案明确列出语料过期为首要风险——手册 v2.1 与即将发布的 v2.2 冲突时需要建立语料 Owner机制定期核对这正是 02-会议纪要-Q1产品规划.md 中提到的售后语料质量参差风险的缓解手段。幻觉抑制强制 Prompt 要求仅根据引用回答无依据则回复不知道避免模型在手册范围外自由发挥。权限边界POC 阶段单租户即可生产环境按区域售后组拆分知识库 ACL对应 WeKnora 的多租户与知识库访问控制能力见 租户、用户与认证授权。实现参考以下路径均相对仓库根目录可按需深入主题文件示例语料产品手册website-docs/sample-data/01-产品手册-智能家居中控.md示例语料FAQ 导入样例website-docs/sample-data/05-常见问题-FAQ导入样例.json示例语料POC 技术方案website-docs/sample-data/04-技术方案-售后知识库POC.mdFAQ 功能文档website-docs/03-features/17-faq.mdFAQ 类型与归一化哈希internal/types/faq.goFAQ Handler 与 APIinternal/handler/faq.goFAQ 批量导入服务internal/application/service/knowledge_faq_import.goFAQ 检索后处理internal/application/service/knowledgebase_search_faq.go文档入库管线website-docs/02-architecture/03-document-pipeline.md快速上手website-docs/01-getting-started/03-quickstart.md【免费下载链接】WeKnoraOpen-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.项目地址: https://gitcode.com/GitHub_Trending/we/WeKnora创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考