读时间： 約 6 分钟 · 系列： 分析師实踐 · 上一步： Plan → Execute → Report · 下一步： 快取与 Source Run
为什麼取数用 SQL，而不是藏在对話里
很多「上传 CSV → AI 出图」工具，实际在背景跑 Python/pandas，你只看到图和摘要。分母怎麼濾、两表怎麼 join、会不会 fan-out——往往无法当正式證据保存。
Lantide 选 SQL-first：
- Plan 写「要算什麼、口徑是什麼」
- SQL 分页 写「怎麼从表里算出來」
- Report 写「结論与 limitations」
同事質疑数字时，你打开 SQL 分页或 Cached 的 查看 SQL，改的是同一段逻辑，不是重播一段聊天。
分析師的日常分工
| 层次 | 放什麼 | 例子 |
|---|---|---|
| Plan | 业务口徑、stage、checkpoint | 「活躍 = 90 天内至少一筆 paid order」 |
| SQL 分页 | @@PROTECT0@@ / @@PROTECT1@@ / @@PROTECT2@@ / @@PROTECT3@@ | 具体濾條件与 join key |
| Reference 檔 | 大型映射、字典（全文） | 狀态碼表、欄位 rename 对照——見 Reference docs |
| 对話 | 解读、追問、修 Plan | 「这段 NULL 比例偏高，要 exclude 嗎？」 |
| Report | 数字 + 限制 | 「转化率 12.3%；未含退款逆向調整」 |
Agent 会帮你建分页、写 SQL、執行；你的責任是 審 Plan、審 SQL、按 Execute——不是自己从零写 every query，而是確保 artifact 可審。
手動 SQL 与 Agent 可混用
Lantide 有两條路（見 USER_GUIDE §1.2）：
- 路徑 A： 你自己在编辑器写 SQL
- 路徑 B： Agent 協作 Plan → Execute → Report
同一工作区里，你可以：
- 先手動探表，再叫 Agent 写 Plan
- Agent 建的分页，你手改后再 Execute
- Quick 里驗 join，滿意后搬进專案 Plan
表名一致： Agent 与你共用 DuckDB 上的同一套表（本地檔案、連线、快取表）。
Execute 前 Agent 常先 @@PROTECT4@@ 列举工作区既有 persist SQL 分页（含 Label、專案歸属），避免重复建 pipeline tab。你可为分页设定 Metadata（Label / Project），見 USER_GUIDE §5.6。
統計工具放哪一层
对話里的 t 檢定、迴歸、聚類等（見 統計分析工具）建立在 Agent 先用 SQL 备好的乾淨表 上：
- 取数、清洗、聚合 → SQL 分页（可重跑、可查看）
- 檢定、建模 → 統計工具，结果主要在对話呈现
Planning 階段 Agent 不跑正式統計；Execute 后、跑檢定前 Agent 会問你確认参数。
与「隱藏资料分析」的差別（分析師视角）
| 聊天里出图的工具 | Lantide | |
|---|---|---|
| 口徑證据 | 多在摘要 | SQL 分页 + Plan |
| 重跑 | 難以復现 | 執行同一分页或 Source Run |
| 協作 | 转貼对話 | 批註 Plan / Report |
| 速度 | 往往更快上手 | 多几步審核，換可簽核 |
若你只需要一張图、永远不会被追問口徑，前者可能夠用。若这个数会进周会、合約或半年后的 audit，SQL-first 更对齊。
实务习慣（三條）
- 每个「会被引用的口徑」都应能在 SQL 或 Plan 找到——不要只存在口頭或聊天。
- 持久分页 + 執行 会产生快取，后續 SQL 可 @@PROTECT5@@ 引用（見 快取）。
- 懷疑数字时，Data → Cached → 查看 SQL，比翻聊天快。