实践 SheetBot

SheetBot 自然语言报表入门：30 分钟跑通第一张经营周报

面向数据分析师与 FP&A：约 30–60 分钟在 SheetBot 跑通首张经营周报。涵盖 Excel 或 database 连接器接入、指标口径表、自然语言智能分析与我要报表、底稿校验及 Skill 复用，附 5 项量化验收与口径/权限/大文件 FAQ。

适用场景

你已有一份或多份 Excel 经营数据（或能只读访问 MySQL/PostgreSQL），需要在一次会话内用自然语言生成第一张「可发给管理层」的经营周报——含汇总表、图表与简要解读。本指南以单业务域、单工作簿为试点，不覆盖全厂数据治理。

难度
入门
预期见效
首次会话 30–60 分钟出首份可校验报表
适用角色
数据分析师、FP&A、运营分析

前置条件

  • SheetBot 账号与至少 1 张可编辑工作簿（或只读数据库账号）
  • 试点业务域已列出 ≤10 个核心指标及口径说明（Word/Excel 均可）
  • 一份「人工底稿」用于对账（上周周报或 Excel 透视即可）
  • 明确表头行与数据区（无合并单元格污染列标题为佳）

实施步骤

  1. 步骤 1：接入首个数据源

    路径 A — 上传 Excel：工作台导入 .xlsx，确认列标题行正确（含合并标题时检查表头检测是否落在真实列名行）。路径 B — 数据库：打开我要连接，选择 database 类型，填写 MySQL 或 PostgreSQL 只读连接串，配置字段映射并手动同步到指定工作表。

    连接器类型（产品现网）：shopify | dingtalk | wecom | database | webhook | custom_api
试点推荐：database（MySQL 业务库）或 Excel 上传

  2. 步骤 2：定义指标口径与元数据

    新建工作表「口径说明」，两列：指标名、定义/公式。例如「本周产值 = SUM(报工合格量 × 标准单价)」。发送 AI 指令前，SheetBot 会将 excel_state（表头、样本行、行数）注入 Agent，口径表在同一工作簿可显著提高解析准确度。

  3. 步骤 3：自然语言生成第一张分析表

    在 AI 助手输入经营分析问题，触发智能分析（Agent 走 submit_analysis_plan → 确定性编译器输出操作序列）。示例问句：

    按产线汇总本周产值和订单履约率，每个维度给出汇总表和一张柱状图，结果放到新工作表「综合分析」

    执行完成后检查：汇总表行数是否合理、图表是否落在数据区右侧而非覆盖原始表。

  4. 步骤 4：校验结果与人工底稿

    任选 1 个维度，用只读查询核对总数。在 AI 对话中可触发全表扫描类工具（如按列聚合），与底稿透视表对比，偏差应 <1%（四舍五入与日期切分差异除外）。若偏差大，先查口径表与表头行，再调整问句中的维度/指标名。

  5. 步骤 5：生成管理层报表快照

    切换至我要报表，选择当前工作簿与模板（销售/经营类），启动生成。流水线将完成结构分析 → SQL 计划 → 图表 → 洞察文案。完成后保存分享链接或导出快照 JSON，供周会只读展示。

  6. 步骤 6：保存 Skill 与下周复用

    将「同步后格式化 + 导出 xlsx」等重复操作保存为Skill 技能。下一周期只需：连接器同步（或重新上传）→ rerun 分析问句 → 执行 Skill → 发布报表。

验收检查清单

  • [ ] 至少 1 个数据源已接入且同步成功（连接器 job 成功或 Excel 导入无表头错位）
  • [ ] 「综合分析」或等价汇总表含 ≥2 个业务维度、≥3 个指标，且与底稿误差 <1%
  • [ ] 生成 ≥1 张图表，类别轴与系列名来自表头而非默认「系列1」
  • [ ] 我要报表产出含 KPI 卡片与 ≥1 段文字洞察，分享链接可打开
  • [ ] 全流程耗时 ≤60 分钟（含一次口径修正）

常见问题

问句正确但数字与财务不一致？

多为口径或表头行问题。检查「口径说明」是否与问句指标名一致；确认 headerRow 未落在装饰性标题行；MES/ERP 混表时先用单源试点。参考制造案例 口径冻结做法。

数据库连接成功但同步为空？

检查字段映射、SQL/分页配置与只读账号权限。database 适配器支持 MySQL、PostgreSQL；先用「测试连接」再小批量同步 100 行验证。

大表卡顿或浏览器无响应？

超过约 50MB 或百万行级文件应走大文件模式（服务端 DuckDB），前端 Canvas 只读预览；普通模式适合 <50MB 的编辑与分析。

图表未生成或提示数据源过大？

智能分析会对高基数维度先汇总再出图。问句中增加「先按产线/品类汇总再出图」，避免直接对万行明细制图。

下一步

跑通单域周报后，可阅读 制造业报表自动化案例 了解多连接器与治理 SOP，或阅读 数据执行层架构解读 理解各模块边界与演进路线。