主体:组织、项目与角色
语义:业务域、概念与版本
数据:来源、范围与水位
运行:会话、检索与缓存
证据:解析路径与冲突状态
结论:同名术语只能在明确上下文中唯一
集团零售项目的“销售额”可能按支付金额,财务项目则按收入确认;海外事业部还涉及币种与税。若系统用全局同义词把它们合并,答案即使 SQL 正确,也会在业务上错误。语义层应把概念放进组织、项目和业务域命名空间。
解析结果至少包含 namespace_id、concept_id、definition_version、适用组织、数据范围与有效期。问题没有提供足够上下文时,应依据当前项目收窄候选;仍有冲突就展示差异并澄清,而不是选择历史命中率最高的定义。
先建立语义对象而不是关键词词典
一个指标对象要记录名称、同义词、公式、粒度、维度、时间角色、币种、过滤、负责人和版本。词典只知道“GMV 等于成交额”,却不知道退款是否扣除、订单状态、税费和跨日边界,无法支撑受治理的查询。
术语、指标、枚举、实体和关系应使用稳定 ID。显示名称可以变化,但引用不能依赖文本。业务文档进入检索前也要绑定 namespace 与访问范围,避免公共搜索把私密项目规则带到另一个部门。
命名空间键必须贯穿解析和执行
可将 scope_key 定义为 organization + project + domain + locale + policy_version。问题解析、候选检索、查询计划、缓存与审计都携带同一键。任何组件丢失范围后退到全局搜索,都可能形成语义越界。
共享集团指标可以由上层 namespace 发布,再由项目显式继承;项目覆盖必须记录覆盖关系和优先级。不能靠复制粘贴产生多个无血缘定义,否则集团口径更新后,各项目会悄悄分叉。
定义继承、覆盖和冲突规则
优先级可为项目显式定义、业务域定义、集团标准、受控默认值。覆盖需要审批、原因、生效期和影响分析;两个同级候选都匹配时状态应为 ambiguous。默认值只适合低风险条件,并应在答案中可见。
反例是“就近选表”:哪个表名与问题更相似就使用哪个指标。这绕过治理,也使新增表改变旧问题答案。选择逻辑应基于概念与范围契约,不基于数据库偶然命名。
会话上下文也要按项目隔离
用户从项目 A 切到项目 B 时,之前确认的地区、币种、客户范围和指标不能自动继承。会话状态保存 namespace、已确认槽位和来源消息;切换范围后只保留无业务敏感的交互偏好,并提示重新确认关键条件。
复制问题到新项目时应重新解析。旧答案中的图表、样本和引用可能受原权限保护,不能成为新会话检索材料。跨项目对比应作为显式任务,由用户同时拥有两个范围并采用可比指标映射。
缓存和向量检索必须包含范围
仅按问题文本缓存“本月销售额”会把 A 项目答案复用到 B 项目。缓存键至少包含规范化问题、namespace、身份范围、语义版本和数据水位;命中后仍要做当前授权检查。高敏感结果可禁用共享缓存。
向量库分区、元数据过滤和检索后授权缺一不可。仅在提示词里写“不要跨项目”不是访问控制。索引重建、文档删除和权限撤销也要传播到检索副本。
跨域分析要先做概念映射
集团分析可能确实需要合并销售、库存和财务域。先声明共享粒度、实体键、时间与币种映射,并决定使用集团指标还是保留并列口径。无法对齐时报告不可比项和残差。
不要为了得到一个总数强行把两个“收入”相加。跨域查询计划应展示各子结果的 namespace、转换和守恒检查,使复核者知道合并发生在哪里。
测试冲突、切换和越权反例
测试集包含同名不同义、同义不同名、项目覆盖、版本换期、无项目问题、跨项目切换、双权限用户、权限撤销和缓存命中。验收不仅看最终数字,还要检查解析路径和澄清是否符合策略。
注入一个更相似但无权限的文档,系统必须忽略;删除项目规则后,应按批准回退而非读取旧索引。记录跨 namespace 检索率、误继承、冲突澄清率和无范围请求。
运营责任与变更流程
集团数据负责人维护共享概念,业务域负责人管理本域语义,项目负责人批准覆盖,安全团队定义跨域访问。变更前做依赖分析和回归测试,发布后观察答案变化与冲突反馈。
不要追求“全公司只有一套词”。目标是让同义与差异都可解释:真正共同的定义复用,有合理差异的定义在边界内稳定存在,跨域时明确转换。
从清单盘点到灰度发布的实施工作包
第一阶段导出过去一个月高频问题,按项目识别同名不同义和跨域术语,建立概念清单与责任人;第二阶段只配置一组集团共享指标和两组项目覆盖,用离线查询回放验证解析优先级。
灰度时让新旧解析并行记录但只展示旧结果,比较候选、过滤、权限和金额差异。差异经过业务确认后再切换,并保留按 namespace 快速回退能力。任何覆盖都要附影响问题列表,不能只测试指标详情页。
上线清单与 AskTable.ai 边界
上线前确认稳定概念 ID、范围键、继承规则、会话切换、缓存隔离、检索授权、跨域映射和审计证据;用真实冲突样本回放。上线后监控无范围问题、错误继承、冲突处理时间和旧版本命中。
AskTable.ai 可作为带项目和业务语义的自然语言分析入口候选,但本文不证明当前版本已实现完整命名空间继承、跨项目索引隔离或所有冲突策略。组织、项目、语义配置、缓存与检索边界需在实际环境逐项核验。
