Article body
正文
运营负责人问“本季度到期客户的续约率是多少，和去年同期差多少”时，团队很容易把它当作一次取数请求。它其实是一条待确认的业务定义：谁算到期客户，谁进入分母，续约以合同、回款还是服务开通为准，季度按自然月还是财年，合并账户怎样去重。定义没有落定，图表即使给出一个数，也难以供业务复核。
衡石 ChatBI 可以在对话中帮助用户分析数据，但问数质量仍取决于数据集、字段、指标和业务知识是否准备充分。本文以续约率为例，说明团队怎样把高频业务问题整理成可维护的语义准备，并用问题集在变更后做复验。文中的回归题集和验收步骤是团队治理做法，不是产品自带的自动化测试功能。
1. 先把“续约率”写成可审核的业务问题
业务负责人、数据负责人和指标维护人应先共同确认一个可复述的定义。假设团队约定：按客户统计，分母为第二季度合同到期的正式客户，排除试用、内部账户和测试合同；分子为其中在到期后 30 天内完成续约确认的客户，提前续约也计入；同一客户在季度内多次到期只计一次，以该客户本季首次到期日确定观察窗口。数据截至 7 月 31 日，让本季各批到期客户的宽限期都结束，再计算完整季度结果。分母为零时标记为无可计算样本，不能解读为续约率为零。这个约定只是示例，企业需要用自己的合同规则和客户主数据替换它。
| 需确认的语义 | 续约率中的具体判断 | 验收时保留的证据 |
|---|---|---|
| 统计对象 | 按客户、合同还是账户统计；集团客户的多个账户是否合并 | 客户主键、合并规则和去重键 |
| 分子与分母 | 分母是否限于到期客户；续约是否以签约、回款或开通日确认 | 业务制度、状态字段和宽限期 |
| 时间归属 | 按到期日、续约日还是财年归属；补录数据怎样处理 | 时间字段、财年日历和数据截至日 |
| 身份与范围 | 是否排除试用、内部账户、测试合同和无权限区域 | 过滤条件、用户属性和权限范围 |
团队可以把确认后的提问写成“按合同到期日归属，统计截至 2026 年 7 月 31 日、第二季度到期的华东正式客户续约率，沿用上述排除条件、客户去重和 30 天观察窗口”。这句话同时固定了指标、时间、范围和过滤条件。业务人员提出“续费比例”“老客留存”这类说法时，团队也能据此判断它们能否映射到同一指标；无法映射时，应请提问者选择口径。
2. 用指标与数据集知识承接已确认的口径
衡石的指标管理支持为数据集或模型定义聚合计算，并维护别名、描述、分组和展示格式。指标的计算值会随使用的维度和过滤条件变化。因此，“续约率”不能只有一个名称，指标描述还应写清分子、分母、时间归属、去重和排除条件，业务人员才能判断一张区域图和一张行业图为何数值不同。
Data Agent 的使用指南说明，团队可以在数据集知识管理中用自然语言描述数据集用途、隐含过滤规则、同义词及专有术语与字段、指标之间的对应关系。团队可以把“续费”“续签”“续约”与受控指标的关系写进知识管理，把“本财年”映射到约定的日历，并在字段或指标描述中保留业务解释。它们为模型提供检索和理解线索，业务负责人仍需确认规则本身。
团队可以先维护少量高频、争议大的指标，再扩大覆盖面。将“合同到期日”“续约确认日”“客户唯一标识”这类字段补充描述，隐藏不参与问答的临时字段，避免名称相近的字段同时暴露。若团队需要额外设置行业术语、资源搜索规则或同义词处理方式，可参考Data Agent 调优中的相关配置。配置前后都要保留题集复验记录，不能把提示词调整当成口径审批。
3. 让澄清和权限成为问数的一部分
“哪个区域的续约率更低”也可能缺少时间范围、客户分层或对比基准。团队可以为这类高频歧义准备澄清方式：询问本期与上期的具体时间，确认区域按客户归属地还是销售组织划分，确认比较对象是目标值、去年同期还是全公司。业务术语有多个被批准的定义时，提问界面或使用规范应让用户选择，不应由模型自行裁决。
权限会改变可见范围，也会影响数字。Data Agent 文档说明，Agent 会在用户有权限的数据范围内检索和分析。验收人员需要用具备不同区域、部门或角色权限的账号复核：同一受控指标在各自合法范围内能否计算，受限对象是否无法被汇总、明细或追问带出。团队应把权限核验和指标核验放在同一次发布检查中。
官方指南也提示，大模型的行为具有不确定性，相同输入不保证产生完全相同的响应。团队不能承诺每次对话的措辞、追问路径或呈现形式完全一致。验收应关注可审核的部分：模型是否命中批准的指标和范围，结果能否与人工复算或受控图表核对，歧义问题是否得到明确澄清。
4. 维护一份问题集，而非只收藏几条成功提问
把一次成功的对话截图留在群里，无法覆盖以后新增同义词、改动指标描述或替换上游字段的影响。团队可维护一份小型回归题集，并把每一题关联到指标版本、数据集版本、验收人和对照结果。团队可按自身工具和流程维护这份验收记录。
| 题目类型 | 示例问题 | 验收关注点 |
|---|---|---|
| 标准口径 | 2026 年第二季度华东正式客户续约率 | 命中批准指标、时间归属和客户去重规则 |
| 同义表达 | 华东老客续费比例 | 映射到同一受控指标，或要求用户确认差异 |
| 时间歧义 | 本财年续约情况 | 财年定义、截至日、观察窗口和同比基准清楚可见 |
| 权限边界 | 我的区域续约率 | 仅使用当前账号可见的区域与客户范围 |
| 信息不全 | 续约好不好 | 要求补充时间、比较基准或业务范围 |
每次复验时，验收人记录提问原文、账号角色、当前数据截至日、预期口径、实际命中的数据集或指标，以及人工对照结果。若输出无法复核，团队先区分是定义缺失、同义词映射不清、权限范围变化还是数据更新滞后，再由对应负责人处理。这样的问题记录也能把业务部门提出的新说法转成下一轮语义准备的候选项。
5. 在变更后复验，给业务一个可追溯的答案
指标定义、数据集知识、字段名称、上游 schema、刷新计划和角色权限发生变化时，都可能影响问数。衡石的数据集更新文档说明，源表定义变化后需要更新数据集配置；导入衡石引擎的数据发生变化时，也需要更新数据以保证分析时效。团队在完成这些操作后，应抽取受影响的问题集重新验收，而不是只检查页面是否能打开。
变更记录至少写明负责人、修改原因、生效时间、影响指标和复验结论。续约率从“按客户去重”调整为“按合同统计”时，业务负责人应批准新定义，数据负责人更新指标和知识说明，验收人用历史切片说明数字差异。对于无法回答的问题，团队应记录缺少的字段、未获批准的口径或权限限制，并把它交回业务确认。
ChatBI 的价值来自业务人员能够持续问到可复核的数据，而这需要团队维护指标定义、语义说明、权限范围和回归问题。先把续约率这类高频指标做实，再扩展到流失、复购和客户价值，问数体验才有稳定的业务基础。