Data Analysis
把可信数据转成验证后的发现、报告、仪表板和 Notebook 交付。
Data Analysis 适合“要结论、要验证、要交付”的数据工作，而不是单纯把表整理好。它会更强调数据质量、方法、发现和可复用交付物。
功能状态：预览
数据分析工作流已经可运行，但目前更适合有边界的描述性分析。某些高级方法和更广的分析模板仍在持续补齐。
入口
在对话中使用 /analyze。
适合的任务
- 销售、运营、投放、用户行为等结构化数据分析；
- 要生成报告、dashboard 或 notebook 的任务；
- 需要保留方法、发现、质量状态和不确定性的分析工作。
不适合的任务
- 只是做格式清洗和导出；
- 数据来源不可信、字段意义不明确，却要求直接给结论；
- 需要复杂因果、回归或实验推断，但当前数据并不支持。
基本流程
输入
/analyze，说明业务问题、数据来源、时间范围和目标输出。明确哪些字段最重要，哪些口径必须遵守。
等待 Raydo 做数据检查、分析计划、执行、验证和交付编译。
检查发现、图表、限制条件和数据质量状态。
将结果作为报告、dashboard、Notebook 或项目结论继续使用。
常见交付
- 分析结果；
- HTML 报告；
- Dashboard；
- Notebook；
- 继续交给 PPT、文档或项目交付的分析结论。
成功标志
- 结论和图表能对应到数据问题；
- 质量状态、方法名和限制被明确写出；
- 结果进入项目，而不是只停留在一次回复里。
更好的使用方法
- 先写业务问题，再给数据，不要只上传表格后说“帮我分析一下”；
- 明确时间范围、关键字段和必须遵守的统计口径；
- 一次先回答一个核心问题，例如“近 3 个月哪个渠道退货率升得最快”；
- 如果只是整理工作簿、补格式或导出，不要误用
/analyze，改用/spreadsheet； - 先接受描述性分析和可验证发现，再决定是否需要更复杂的方法。
常见报错会出现在哪
| 位置 | 你会看到什么 | 代表什么 |
|---|---|---|
/analyze 当前任务 | question required、dataset required、plan blocked | 当前分析问题或数据输入不满足运行前提 |
| 数据检查阶段 | columns required、rows required、bounded table invalid | 数据表结构不完整，或不是可分析的有界表格 |
| 方法执行阶段 | numeric column required、numeric values required | 你要做的分析需要数值列，但当前数据不支持 |
| 结果交付阶段 | artifact create failed、dashboard write failed、spreadsheet render failed | 分析可能已经做完，但交付物生成或写入阶段失败 |
常见报错与含义
| 常见提示或错误方向 | 用户应如何理解 | 建议先做什么 |
|---|---|---|
| analysis question required | 没有明确分析问题，系统不知道要回答什么 | 把任务改写成一个具体业务判断 |
| analysis dataset required | 当前没有可分析的数据集或有界表格 | 先补表格、数据集引用或可读数据文件 |
| analysis columns required / rows required | 表头或数据行不完整，当前表不能直接分析 | 先确认数据不是空表，也不是只有截图或说明 |
| analysis bounded table invalid | 数据结构不符合当前分析入口的要求 | 先整理成清楚的列和行，再重新分析 |
| analysis numeric column required / numeric values required | 这类分析需要数值字段，但当前没有有效数值列 | 指明金额、数量、转化率等可计算字段 |
| analysis spreadsheet source invalid | 作为分析来源的工作簿本身没有通过校验 | 先回到 /spreadsheet 修表，再回来分析 |
| analysis spreadsheet render failed | 数据有效，但工作簿渲染交付阶段失败 | 先保留分析结果，再单独重试交付层 |
| analysis delivery spreadsheet persist failed | 交付物写入或保存阶段失败 | 不一定是分析错了，优先检查交付写入状态 |
建议用户怎么排查
先判断你缺的是“问题定义”还是“数据结构”，这两个问题最常见。
如果任务太宽，先改成一个时间范围明确、口径明确的问题。
如果报的是数据结构错误，先回到表格层把列名、数据类型和空值整理好。
如果分析结果出来了，但 dashboard 或报告没写成功，不要先重做分析，先看交付层失败点。
如果你真正需要的是因果、回归或实验推断，先确认当前数据和方法前提是否足够，否则系统应当保留限制。
截图占位
后续建议补 4 张图：
/analyze输入示例、分析结果摘要、图表 / dashboard 预览、交付物中的报告或 notebook。
录屏占位
后续建议补 1 段短录屏：从选择数据集和问题，到查看分析结果和 dashboard。