返回正文目录

项目范围导读旧稿(写作素材)

原第六章范围导读,保留供写作参考。现第六章已合并环境接入,改为《认识 Foggy,准备第一个问数项目》;本稿仍用技术篇小销售库,不是 Chinook 实战正文,也不代表环境已搭建。

技术篇已经讲清问数系统怎样分工。应用篇从准备第一个项目开始:确定第一版为谁服务、回答哪些问题,以及结果怎样验收。

从一组能核对的问题开始

开发者自用、团队反复查指标、业务用户在线问数,可以从同一组问题起步。先选有人反复问、数据能够支持、结果能够独立核对的问题,再逐步扩大范围。

沿用前面的客户和发票,第一版先围绕有效开票销售额,完成月汇总、客户排名和月间变化。这样就能检验接入、业务定义和问数流程,不必一开始接入全部数据。

中小企业可以直接从现有业务库起步。日期、状态或客户标识对不齐时,先做必要的数据整理或 ETL;是否需要数仓,留给数据规模与分析需求决定。查询负载较大时,再评估只读副本或定期快照。

给第一版写一张范围卡

下面沿用技术篇的小销售库,写一版范围示例。单位和状态口径只适用于这份数据:

项目 第一版约定
使用者 开发者先验证,再交少量业务用户试用
数据 客户、发票;记录数据覆盖范围和刷新时点
可见范围 按实际用户身份确定可查询的数据,回答沿用同一范围
指标 有效开票销售额、有效发票张数、有有效发票的客户数
口径 按开票日期,只算 ISSUED 状态;金额从分转元;统一时区
首批问题 某月销售总额、客户前三名、月间金额变化、有有效发票的客户数
返回内容 查询条件、金额或计数、指标说明、可核对的执行依据
暂不回答 利润、回款、商品结构等当前数据或语义模型未覆盖的问题
维护责任 指定业务人员确认口径,技术人员维护语义模型并复核变更

“有有效发票的客户数”不等于客户档案总数,也不自动等于业务上所说的“活跃客户”。范围卡里的名称和定义要对应,避免从这里就埋下歧义。

怎样算第一版做完

把首批问题写成小题库,每题保留问题、业务定义、查询条件和预期结果或核对方法。验收分两步:

  1. 先核对查询。 确认语义模型和结构化查询符合业务定义,数值与原始记录或已确认报表一致。使用全部样例数据时,六月总额为 13600 元,客户前三名为 5500、4200、3000 元,有有效发票的客户数为 4。接入用户数据范围后,按相应范围重新核对。
  2. 再核对问答。 用不同说法和连续追问,检查 AI 是否选对语义模型、理解日期和指标。条件不明应澄清,超出数据或权限范围应说明限制。回答还要保留查询范围:前三名合计 12700 元,不能说成六月全部销售额。

保留语义模型版本、查询样例和数据时点。口径或数据范围变更时,重跑受影响的题目,并复核对应问答。

应用篇怎样推进

接下来先用现成样例体验 AI 配合 CLI,再用开放数据练习探查、建模、查询与核对。更换数据后,重新确认单位、状态和业务口径。

开发准备阶段,由人给出目标、确认口径,AI 配合 CLI 执行并保留结果;语义模型和查询验证通过后,再接入对话应用,检验用户在浏览器里的提问和追问。操作说明随搭建和测试结果写作。

本章小结

第一版先做到:范围清楚、口径确认、查询可核对、回答有依据。把这组问题跑稳,再逐步增加数据和分析能力。

下一章开始动手跑通第一个问数样例。