# 指标报表：交付可重放的查询、图表与解释

工作单元：W-A01；版本：2026-10-21.workunits.2；复核：2026-10-20
将业务问题变成口径明确、数据可追溯、可重放的查询和分析包，能区分真实变化、数据缺失与口径误差。

## 当前用法
有数据语义、只读查询和独立控制时，可整包委派业务问题到可重放分析；关键口径与结果通过核对后固化刷新。
依据：OpenAI内部数据Agent是厂商自报工程案例；公开data analyst应用提供实现参考。它们展示组织与入口，不提供本例成功率。
来源状态：active
本站记录：本例尚未查询数据或运行Agent；运行数、通过率、费用和人工介入量均为null。

条件：
- 数据血缘/生成逻辑和权限可访问
- 比较窗口与指标语义可接收
- 关键结果有独立参考切片

## 请求与范围
运营问“本周付款用户是否下滑、变化集中在哪些渠道”，已授权查询交易/账号/渠道数据并提供可冻结快照。
业务问题澄清、数据发现、查询、质量诊断和可复算解释属于一次交付；描述性分解不自动提供因果归因。稳定指标在口径接收后固化查询刷新。

## 输入
- 业务问题与可比窗口：要回答付款人数变化及渠道贡献；上海时区、完整周/同比窗、付款状态、测试账号排除、未知渠道和退款处理；有争议时呈现选项和影响。
- 数据语义与访问：冻结数据快照/分区、schema及版本、主外键与粒度、数据生成代码/血缘、延迟/补发规则、脱敏只读查询入口与扫描预算。
- 独立控制：经认可的参考切片/总账控制或独立查询；指定周日16:00 UTC跨周边界、重复支付事件、多渠道映射和null账号记录。

## 交付物
- 问题与指标定义，列出原问题到查询定义的取舍及未决语义
- 参数化SQL/计算代码、引擎与快照版本、运行命令/查询ID、日志和底层结果表
- 可复算周环比与渠道分解、图表和一页解释；未知渠道单列，渠道人数不满足可加性时明确标注
- 对账/连接基数/新鲜度/缺失检查与未解决异常；固定查询刷新入口及schema变化失败信号

## 验收
1. 问题定义与数据口径一致
   方法：接收者核对用户/事件粒度、时区与完整比较窗；独立参考切片覆盖跨周、重复、测试账号、退款与未知账户；SQL语法可不同但结果应等价。
   拒收：按事件行数代替人数；不完整本周对整周；缺账号信息默认真实账号。
2. 连接与控制数不产生虚假变化
   方法：独立检查每次join前后主键数和行数；按接收规则处理渠道一对多；总人数对账，若渠道非互斥不把渠道人数和当总人数。
   拒收：维表多版本使用户翻倍；把未知渠道删去后解释为渠道下降。
3. 交付可重放
   方法：验收者在只读环境用冻结快照、参数、引擎重跑SQL/代码，并从结果重建图表；稳定报表刷新使用已接收程序。
   拒收：只交图片或查询文本而缺表版本；刷新时模型另写SQL导致口径漂移。
4. 解释不过度声称且缺数据可见
   方法：逐条把说明数字回指结果，核对完整性/延迟；制造缺分区或空结果，要求返回数据异常而非业务零值；描述性分解明确不证明原因。
   拒收：null变零；因营销上线时间重合直接声称其导致下降；文字使用不同期间数字。


## 具体例子
输入：设计例：上海时区上一完整周相对前一周付款去重用户变化及渠道贡献；只读payment_events/users/channel_map；测试账号排除，多付款去重，未知渠道保留；快照和真实schema待提供。
预期产物：参数化查询与快照记录、周人数/分解表、控制切片和连接诊断、对应图表/说明；如用户跨渠道，给非可加人数或按批准归属规则重算。没有本例真实结果。 跨渠道用户存在时，可展示非互斥人数，但不能称可相加贡献；要合计贡献应先约定互斥归属或可审计分解。
失败：周日16:00 UTC后的付款落错周；维表join重复用户；缺失分区写成0后宣布业务下滑。

## 工作重组
以前：找表、SQL、导出、作图和口径解释反复交接；执行者凭列名猜测语义。
现在：代理依据问题、语义和只读反馈自行选择数据与探索顺序；发现空结果或异常基数时诊断修订；已接收的稳定报表直接执行程序。无需规定每个问题统一查几张表。
保留：
- 指标用途和取舍确认
- 实际决策的接收责任
新增：
- 查询到数据生成代码的语义核对
- 查询与底层结果同时交付
- 保留口径修正版本且不自动把猜测变为长期事实

## 人的责任与失败接管
明确业务决策及可接受口径，处理语义冲突并接收结论；发现表、写SQL、运行诊断可由代理承担。若要因果结论，另确定识别设计，不由报表验收冒充。
表语义不明时列出字段、候选解释和对结果的影响；连接后空集先检查授权、时窗和粒度；缺分区时标“不完整”，不造业务数值。预算用完保留查询与已知范围，未解决不写成下滑。

## 尚待补足
- 真实业务schema/生成逻辑未绑定
- 未知问题、schema变化与数据延迟条件尚未试验

## 职业与团队下一步
数据分析、分析工程、运营分析
提交指标契约、实际查询、参考切片及口径变化后的修正记录。
对照目标岗位的数据工具、业务和统计深度；区分能做报表、能解释变化与能设计实验。
/explore?purpose=career&domain=analysis
重复查询多，还是表定义和指标口径分散？
AI处理探索性查询，固定程序刷新稳定指标；分析人员维护语义与决策解释。
选一个每周报表，测准备、复核和刷新成本；优先修口径和接口，再选择工具、培养或招聘。
/explore?purpose=team&domain=analysis

## 证据与关系
- OpenAI内部分析Agent：从业务问题到查询与报告：https://openai.com/index/inside-our-in-house-data-agent/
  定位：How it works；Context；Evals；Guide the Goal, Not the Path；公开 2026-01-29；核查 2026-10-19；复查 2026-10-26
  支持：支持在语义上下文与结果反馈下组织完整分析任务；支持给目标、让代理自选路径并接入生成语义。
  未覆盖：无本企业题目通过率；不是可下载同配置产品；周付款/渠道规则与控制为本站任务设计，未实测。
- 数据分析应用参考：查询可见，修正明确保存：https://developers.openai.com/cookbook/examples/agents_api/apps/data_analyst/readme
  定位：目标、数据/工具、示例边界与记忆保存；公开 2026-09-10；核查 2026-10-19；复查 2026-10-26
  支持：提供将查询与结果交给使用者核对的实现方式；支持可追溯交付。
  未覆盖：未在本站安装，版本需固定，目标数据需另适配；不提供未知业务问题的稳定性证据。
- /tasks/DATA-02：沿用跨工具指标契约的口径与验收；新层承接完整报表交付。（partial；2026-10-02.2）

## 任务级判断与证据
采用方式：限定条件下整包委派
从证据到建议：内部案例展示从查表到分析的整包路径，公开应用支持可见查询；迁移成立的关键是能提供业务语义与真实只读反馈。因此建议委派完整候选分析，用独立控制验收，不能把内部案例直接写成企业即插即用。
当前可用性：mixed；内部Agent不可直接获取；公开示例提供自建入口。只读仓库/引擎、API账户和语义资产需使用方提供，本例未连库。
- 官方data analyst应用参考：https://developers.openai.com/cookbook/examples/agents_api/apps/data_analyst/readme
  2026-09-10发布页，2026-10-20读取；代码commit需执行时锁定；公开文档/示例，需模型服务及目标数据库适配；不可等同内部Agent。

### OpenAI公开的内部数据Agent案例描述了查表、SQL、结果修正到报告的闭环，但这是专用内部系统的厂商自报。
依据身份：外部报告结果；状态：active
- OpenAI内部分析Agent：从业务问题到查询与报告：https://openai.com/index/inside-our-in-house-data-agent/
  定位：How it works；Context is everything；Moving fast without breaking trust；关系：partial
  支持：支持在语义上下文与结果反馈下组织完整分析任务。
  限制：无本企业题目通过率；不是可下载同配置产品。
  核查：2026-10-19；来源状态：active
配置：2026-01-29工程案例；文中GPT-5.2，专用数据/权限/语义与记忆；评价使用人工golden SQL及结果比较，未公开本例样本/重试/成本分母。
适用限制：本站未进行该任务的模型运行，不能据此给出本地成功率。
相关进展（本条判断）：
- 业务问题到报告，数据Agent可以自己循环查数与修正：/explore?purpose=understand&domain=analysis&window=all#P-A-INTERNAL
  首次公开 2026-01-29

### 官方公开data analyst应用可作为查询和结果可见的工程入口，不能把应用参考当能力试验。
依据身份：工具与方法依据；状态：active
- 数据分析应用参考：查询可见，修正明确保存：https://developers.openai.com/cookbook/examples/agents_api/apps/data_analyst/readme
  定位：readme：data analyst app实现及SQL展示/记忆修正；关系：method
  支持：提供将查询与结果交给使用者核对的实现方式。
  限制：未在本站安装，版本需固定，目标数据需另适配。
  核查：2026-10-19；来源状态：active
适用限制：本站未进行该任务的模型运行，不能据此给出本地成功率。
相关进展（本条判断）：
- 分析应用有了可见查询与可保存修正的参考实现：/explore?purpose=understand&domain=analysis&window=all#P-A-APP
  首次公开 2026-09-10

### 本例可在独立口径/结果控制下整包委派；稳定接收后转为参数化刷新，异常才重新探索。
依据身份：有条件的编辑推断；状态：active
- OpenAI内部分析Agent：从业务问题到查询与报告：https://openai.com/index/inside-our-in-house-data-agent/
  定位：Lessons #2 Guide the Goal, Not the Path；#3 Meaning Lives in Code；关系：adjacent
  支持：支持给目标、让代理自选路径并接入生成语义。
  限制：周付款/渠道规则与控制为本站任务设计，未实测。
  核查：2026-10-19；来源状态：active
- 数据分析应用参考：查询可见，修正明确保存：https://developers.openai.com/cookbook/examples/agents_api/apps/data_analyst/readme
  定位：SQL query/result visibility；关系：method
  支持：支持可追溯交付。
  限制：不提供未知业务问题的稳定性证据。
  核查：2026-10-19；来源状态：active
适用限制：本站未进行该任务的模型运行，不能据此给出本地成功率。

## 情境变化
### 指标定义含混
输入变化：只问“用户有没有变少”，未说明活跃/付款/账号粒度。
判断变化：先委派问题澄清与几种可比定义的影响分析；避免静默固定最方便的定义。
验收变化：接收者确认用途与口径后，才按该定义验收数字。
### 新鲜度或schema变化
输入变化：最新分区迟到、事件字段改名或生成逻辑已改。
判断变化：先委派数据诊断，报表可交不完整范围，不能完整接收。
验收变化：以版本/新鲜度控制识别故障；修复后重跑原比较窗。
### 要解释活动的因果效果
输入变化：要求回答渠道活动是否导致付款下滑。
判断变化：原报表只接收描述；另需实验/准实验识别任务及假设。
验收变化：增加对照、混杂与识别假设检查，不能由相关性图替代。

研究前沿：外部内部工程案例已把动态数据发现、查询修正、报告与上下文组合；公开参考实现不等于原公司专用Agent可下载。
下一项验证：构造授权数据的小快照，先用独立控制检验跨周/重复/缺分区等验收；再给代理原业务问题且隐藏参考SQL，核对结果并保存澄清、重试、查询扫描量和人工时间。
未来改判信号：
- 扩大：新问题与schema/埋点变化下，代理能识别粒度差异、修正连接并在未知数据时正确返回未解决。
- 收缩：依靠历史固定SQL才对，或语义层过期导致稳定错数；缩到已认可报表刷新并修复语义资产。

## 与本单元直接关联的进展
### 分析应用有了可见查询与可保存修正的参考实现
公开 2026-09-10
公开数据分析应用示例把数据发现、只读查询、结果解释与修正保存连接起来。
支持范围：工程参考需适配数据库和权限，不证明任意分析都正确。
来源状态：active
/explore?purpose=understand&domain=analysis&window=all&kind=all#P-A-APP

### 业务问题到报告，数据Agent可以自己循环查数与修正
公开 2026-01-29
OpenAI内部数据Agent展示从发现数据、运行查询到发布报告的闭环，并强调表的生成逻辑与业务语义。
支持范围：案例不提供通用正确率，也不能从观察数据自动创造因果识别。
来源状态：active
/explore?purpose=understand&domain=analysis&window=all&kind=all#P-A-INTERNAL

领域背景与未来情景：/explore?purpose=understand&domain=analysis


## 工具与采用佐证
### RD-Agent：研究、实现与反馈可以形成循环
来源状态：active
核查层级：implementation_inspected；日期：2026-10-19；版本：484776c211e4fbbeef03e0ec00d6bbee7362a4f4
原始主张：项目声明自动开展量化因子/模型研究，并提供数据科学场景。
已检查：固定commit的README、许可证、factor.py和model.py已读；可见研发循环、执行结果和失败反馈的实现入口。
支持：对金融研究备忘录和可重放分析包提供相邻运行方法：把假设、代码、结果与反馈一并保存。
限制：量化因子回测不等于财务对账或投资收益；本轮未复现其模型/回测，不采用README收益数字作本站能力结论。
下一步：选择截止时间锁定的公开数据，保留训练/验证/测试分隔、交易成本和全部候选，独立复算结果；与固定脚本比较人工复核时间。
https://github.com/microsoft/RD-Agent/blob/484776c211e4fbbeef03e0ec00d6bbee7362a4f4/README.md