跳到正文

00 - 企业知识底座生产总纲 ​

一句话:知识底座的生产形态就是四件事——文档进得来、检索查得准、越权查不到、删了真没有;引擎可以换,但这四件事的责任必须有人唯一持有,代价是每一件事都要留一条能复现的证据,否则“上线”只是把不确定搬到了生产。

本栏按生产交付口径写企业知识底座:不再回答“能不能跑起来”,而是回答“谁负责、怎么判、拿什么证明”。员工问一句,系统给出带页码且经权限复核的答案;管理员上一份制度文档,通过就绪判定后生效;法务删一份文档,秒级停止新可见、分钟级清完索引与缓存、备份里的副本按保留期处理——三段各有各的口径,不合并成一句“已经删了”。每条交付断言的归档状态集中在 06 的证据表,未跑完的一律标未覆盖。

3.2 专栏的第 10、11 两篇记录的是这件事的起点:选型论证与单机 Docker 起栈、一份 Markdown 小样本跑通建库到问答。那一栏把当时的边界写得很清楚,那些边界照旧成立,本栏不改写它们;本栏负责的是把每条边界从“待补”推到“怎么做、做没做成”的路径与判定。

一、闭环的四件事 ​

读图要点:左半是“把知识变成可检索资产”,右半是“把检索能力交出去”,中间两根竖线是生产与演示的分水岭——权限在检索之前发生,删除必须追上检索。演示链路通常只有上排三格,缺了 C 和 E,于是一份私有制度会在别人的答案里出现,删掉的文档还在被引用。

四件事各对应一栏:

闭环环节由谁负责详见
进得来RAGFlow 引擎 + 解析 worker01 文档接入与解析
查得准、可溯源RAGFlow 检索面 + 引用02 检索与引用溯源
越权查不到、删了真没有Knowledge Broker03 权限隔离与删除传播
交出去MCP 工具面 + Higress + HiMarket04 能力供给与调用闭环
跑得久、花多少K8s 部署 + 容量测算 + 成本判定05 部署运维、容量与成本
谁负责、谁在用内容治理与组织维度08 内容治理与冷启动、09 用户与组织维度
为什么这么做机制推导07 原理备忘
算不算成负向用例与验收06 生产验收与已知边界

另有三篇不讲链路、讲前提与理由:原理为什么是这些做法(07 原理备忘)、内容从哪来谁负责(08 内容治理与冷启动)、组织谁能用谁付钱谁背锅(09 用户与组织维度)。技术链路只决定这套系统能不能跑起来,后三篇决定它能不能在企业里活过第一个季度。

二、组件分工:一句话一个 ​

组件只负责明确不负责
RAGFlow解析、切片、向量与混合检索、问答生成、引用坐标企业身份、租户授权、对外凭证
Knowledge BrokerACL 决策、过滤条件注入、引用复核、MCP 工具面存原文、算计费
Higress身份换取、路由、限流、超时、计量事件、密钥注入判断“这份文档你能不能看”
HiMarket知识产品的目录、发布、订阅关系承载业务流量
Nacos工具元数据与配置的注册事实授权
Vault上游密钥的权威请求路径上的决策

一句话记法:引擎管内容,Broker 管许可,网关管放行与事实,市场管关系。 四者各有唯一权威,任何一处把职责复制一份,就有了对不上的可能。

三、跟相邻两栏怎么分 ​

  • 3.2 讲选型与市场语义:为什么是 RAGFlow、五类资产的 Product 模型、订阅与凭证链路。本栏直接引用其结论,不重开选型讨论。
  • 3.1 讲平台通用能力面:网关三语义、预算不变量、四类权威各存一处。本栏只写知识检索场景下的取值与验证方式。
  • 3.3 讲员工实例的生命周期:一人一实例、渠道、HITL。本栏与它共用同一套网关与身份口径,不重复讲实例。
  • Higress 在三栏里只出现一次职责视角:3.1 是能力面,3.2 是需求面,本栏是运维面——副本、反亲和、配置发布与回滚、告警阈值,以及 SLO 口径与实测计划(实绩待 06 第 10 组归档)。

四、边界(不做宣称的部分) ​

生产闭环不等于全部能力都已具备,以下四项本栏按缺口处理,不写成已完成:

  1. 多模态一期不做:音视频解析、图文混排理解、多模态重排都不在本期范围;遇到时转人工或单独能力接入,对标的多模态能力差距按“不做”记账,不计为交付缺口。
  2. 记忆层:归 3.2 的记忆底座方案,本栏只保证知识检索不越权,不代答记忆隔离。
  3. 计费:网关记录的是调用事实与用量,价格与结算在企业计费系统;本栏做到“可对账”,不做“已结算”。
  4. 国内系统开箱连接器:托管平台自带的成百上千类连接器我们没有等价物,靠社区 Server 自补;这一条不只是功能缺口,它是删除传播的前置(拿不到上游变更与删除事件,就只能每日全量比对兜底),单列在 06。
  5. 多库路由与库级权重:不做产品化开关,范围由授权与场景配置派生,属显式取舍而非漏做(见 02、06)。
  6. 容量结论:所有 SLO 数值在无压测数据前一律标为经验值,不给“已与商用平台对齐”这类说法。

版本边界一条:引擎镜像与依赖组件必须锁 digest,换版本必跑七项回归(见 05 部署运维、容量与成本)。

另一处对照评审结论先放在这里:与托管平台相比,本栏真正站得住的优势只有三条——片段级前置过滤加渲染时引用复核、引用绑定版本与内容哈希、把相似度阈值当分布资产管(换模型即广播失效)。其余多为同级能力,不宣称领先,逐项对照见 10 对标百炼与业内实践。

五、术语 ​

术语指什么
ACL epoch权限快照的版本号,缓存与调用都带它,旧版本结果一律不认
过滤条件注入Broker 把租户、项目、文档、密级四项条件写进检索请求,客户端传的同名字段不生效
引用复核返回答案前,按当前权限再判一次被引用片段是否仍可见
tombstone删除墓碑:先标记不可召回,再异步物理清理
fail-closed权限快照过期或拿不到时直接拒绝,不放行
拒答证据不足时明确回答“查不到”,而不是给一个像样的答案

把 AI 工程讲到既懂也会用