报表分析工具 (analyze)#

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

工具描述#

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

触发方式#

text

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

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

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

参数#

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

输出格式#

markdown

## 核心结论
[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 内嵌文件）：

json

{
  "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 限制，请拆分后上传"数据不足以回答"现有数据不足以回答此问题，请补充[具体缺失字段]"置信度过低"以下结论置信度较低，建议人工复核后使用"