建立第一条知识工作流

建立第一条流程 · 从真实问题到可验收的回答路径

本页不是安装教程。lorebit 尚未发布 npm 包或稳定 API;现在最有价值的“第一次成功”是把一条以后能验证、能处理变化、能交付证据的知识路径定义清楚。

1. 从一个真实问题开始

选择一个需要持续引用资料的任务,例如“根据最新产品规则回答客户问题”。不要从“我想存向量”开始,因为那会过早决定实现,而不是决定用户需要得到什么。

写下三件事:

需要明确示例
用户要得到什么一段可执行的回答,并知道它引用了哪份规则
证据来自哪里已审核的帮助中心、政策页和版本化产品文档
什么算过期原文被替换、撤回,或新版本生效

2. 把问题写成一张工作流卡

不要把讨论留在会议纪要里。为每一条计划留下一张短卡,并让资料负责人、业务负责人和后续实现者都能回答同一组问题:

字段你要写下什么
问题边界哪些问题必须回答,哪些问题必须拒答或转人工?
允许资料哪些来源、栏目或版本可以支持答案?
证据要求回答至少要回到原文链接、段落位置和哪个版本?
更新信号谁发布变更、怎样识别替代或撤回?
失败边界找不到合格证据时,系统应如何表达不确定性?

这张卡是采用设计,不是当前 lorebit 的配置文件;不要把它写成尚未存在的字段名或 API。

让工作流卡成为实现的用户输入

一张完整工作流卡不只记录问题和资料,还要把未来实现无法自行猜出的用户结果写清:

合同面需要写下什么后续实现必须保持什么
范围谁问、问什么、何时拒答不能把超出地区、套餐、时间或权限的问题默默回答。
资料主证据、辅助资料、禁止资料和负责人未准入或不适用资料不能默认参与回答。
状态资料何时待审阅、处理中、可用或已替代“处理中”不能被伪装成“已经最新”。
回答结论、来源、版本、片段和适用范围回答与证据必须一起交付。
恢复更新、撤回、证据不足或能力缺失时的动作失败时保留事实边界,而非输出无依据文本。

3. 定义最小知识工作流

01资料

知道哪些来源可以进入知识库,以及谁负责它们。

02查询

定义用户会问的问题和答案必须满足的证据标准。

03引用

规定答案如何回到文档片段、版本和原始来源。

只要这三项没有说清,换任何向量库都不会让知识回答更可靠。

4. 把存储留在 adapter 边界

先列出你真正需要的能力:原文保存、语义检索、关键词检索、关系遍历或重建检查点。lorebit 的目标是协调这些能力,而不是替你实现数据库内核。

参见:数据库与索引适配器

5. 在进入实现前做一次桌面演练

以“根据最新产品规则回答客户问题”为例,随机挑一个常见问题,再故意选择一份已经替代的旧规则。若团队不能说明新旧规则分别由谁负责、旧规则为何不能继续支撑答案、以及回答会附上什么来源,那么计划还不够完整。回到工作流卡补齐,而不是提前挑选数据库。

什么算完成

完成不是把卡片归档,而是能让三种角色各自回答一个问题:业务使用者能判断答案是否解决了真实任务;资料负责人能说明哪一版资料当前有效;未来集成方能从卡片提取带证据回答和资料更新的验收条件。做不到其中任意一项,就回到问题、边界或资料阶段继续补齐。

6. 等待可验证的公开入口

公开 SDK 发布前,请不要把本文的术语当成可调用的类名或配置字段。届时本页会替换为一条可运行、带错误恢复说明的最小接入路径。

下一步:接入与审阅资料