报表分析工具 (analyze)

上传业务报表 + 提业务问题 → 获得「结论 + 数据归因 + 决策建议 + 图表规格」

工具描述

接受用户上传的 1-6 份 xlsx/csv 文件和一个自然语言业务问题，调用后端 RAG API 进行智能分析，返回四段式结构化输出。

触发方式

/analyze [上传文件] [业务问题]

或自然语言触发（OpenClaw 路由识别）：

• 上传文件后问"为什么..."
• "分析一下..."
• "对比..."
• "本季度..."

参数

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | files | file[] | 是 | xlsx/xls/et/csv，每个 ≤ 10MB | | question | string | 是 | 自然语言业务问题，≤ 500 字 | | business_context | string | 否 | 补充业务背景（行业/规模/时期等），≤ 200 字 | | target_tool | enum | 否 | excel/wps/dingtalk/tencent-docs（影响图表代码生成） |

输出格式

## 核心结论
[1-3 句直接回答业务问题]

## 关键数据与归因
| 指标 | 数值 | 变化趋势 |
|------|------|---------|
| ...  | ...  | ...     |

> 分析框架：[框架名称] | 数据来源：[列名] | 置信度：高/中/低

## 决策建议
1. [Next-step 1]
2. [Next-step 2]
3. [Next-step 3（可选）]

## 可视化建议
> 以下图表代码可直接贴入 [目标工具]

[图表代码]

---
*AI 辅助生成，仅供参考。数据来源：用户上传文件。重要决策请结合实际情况判断。*

约束与限制（v1.5.2）

• 单文件 ≤ 10MB / 总 ≤ 30MB / 最多 6 个文件
• 单 Sheet ≤ 5 万行；合并单元格自动拆解
• 不支持 .pptx / .pdf / 图片格式
• 不跨企业数据（每次会话独立）
• 数据零落盘（v1.5.2 PIPL 合规）：SCF 内存推理后立即销毁，不持久化用户业务数据

后端调用（v1.5.2 极简）

单次调用 — POST /api/analyze（无需 upload，直接 base64 内嵌文件）：

{
  "openclaw_token": "用户 OpenClaw token",
  "files": [
    {
      "filename": "Q1-销售.xlsx",
      "buffer_b64": "<base64 编码 xlsx>",
      "source_tool": "excel"
    }
  ],
  "question": "为什么华北区本季度利润下降了 15%？",
  "business_context": "（可选）",
  "target_tool": "excel"
}

若用户要求图表 → POST /api/visualize（传 analyze 返回的 viz_specs）

错误处理

| 错误 | 用户提示 | |------|---------| | 文件格式不支持 | "请上传 xlsx/xls/et/csv 格式文件" | | 文件超大 | "文件超过 10MB 限制，请拆分后上传" | | 数据不足以回答 | "现有数据不足以回答此问题，请补充[具体缺失字段]" | | 置信度过低 | "以下结论置信度较低，建议人工复核后使用" |