本文介绍 VeryReport Vera 报告：一句话生成多章节经营分析报告，支持参考资料、提示词模板与在线编辑。路由为 /vera/workbench?cap=report。
范围说明：Vera 报告（cap=report）生成多章节可编辑长文档（Word 风格），适合月报、经营复盘、客户拜访报告。与问数「单次查数出图」不同；报告会异步规划章节、逐章取数/解读并组装成文档。能力依据《Vera 设计与实现》智能数据报告链路。1. 功能概述
报告模块由 ReportPlanner 规划章节结构，用户确认后异步逐章执行（NL2SQL + 出图 + 解读 / 归因），最终由 DocAssembler 套模板生成可编辑文档。文档存于 vera_doc_report，可在报告编辑器中修改文字、插入图表、导出 PDF/Word。
| 阶段 | 说明 | 入口 |
|---|---|---|
| 描述需求 | 说明报告主题与范围 | 工作台 → 报告 |
| 附加资料 | 绑定数据集/仪表板/文件 | 输入框「参考资料」 |
| 生成报告 | 异步规划并逐章执行 | 发送 → 阶段进度 |
| 编辑导出 | 富文本编辑、分享导出 | 报告编辑器 / 我的报告 |
2. 能达到的目标
- 经营月报 / 周报：自动汇总 KPI、同环比、异常与建议；
- 客户拜访报告：结合客户数据与上传材料生成拜访策略；
- 多源融合：同时引用数据集、仪表板与 Word/Excel/PDF 参考资料；
- 可编辑可追溯：生成后在编辑器继续修改，每章执行记录可追踪；
- 报告库管理：「我的报告」卡片网格，支持搜索与进入历史报告。
3. 操作步骤
3.1 进入报告模块
- 打开 Vera 智能体 → 工作台，顶部切换 报告。
- 下方「我的报告」展示最近报告卡片；完整管理见菜单 报告中心（
/vera/reports）。
3.2 描述报告需求
- 在输入框描述想生成的报告，例如：
- 「基于销售数据集，生成本月经营分析报告，含 KPI、渠道贡献、风险提示」
- 「为客户 A 生成拜访报告，含近 12 月成交趋势与高潜品类」
- 点击 使用模板 选择提示词骨架：
- 通用：核心结论 + 指标解读 + 趋势异常 + 建议；
- 客户拜访：客户画像 + 机会 + 风险 + 拜访清单；
- 经营分析：营收利润 + 渠道品类区域 + 归因；
- 周报/月报：周期 KPI + 事件里程碑 + 下周期重点。
3.3 添加参考资料（可选但推荐）
- 点击输入框旁的 参考资料（📎），可附加：
- 数据集：供报告章节自动取数；
- 仪表板：引用已有看板图表与解读；
- 上传文件：Word / Excel / CSV / PDF，单文件 ≤ 10MB，最多 5 个。
- 参考资料以 chip 形式显示在输入框上方，可逐个移除。
3.4 发送并跟踪生成进度
- 点击 发送，对话区展示生成阶段：加载资料 → 规划大纲 → 逐章生成 → 完成。
- 生成完毕后出现报告卡片（含缩略图），点击进入报告编辑器。
- 若提示「正在生成的报告需要进一步操作」，点 查看 进入编辑器确认章节。
3.5 编辑与导出
- 在报告编辑器（
/vera/report-doc/:id）中：- 修改章节标题与正文；
- 插入或替换图表块；
- 调整排版后保存。
- 支持导出图片 / PDF / Word，以及生成分享链接（若管理员已开启）。
- 也可在「我的报告」或报告中心打开历史报告继续编辑。
4. 提示词模板速查
| 模板 | 适用场景 | 典型结构 |
|---|---|---|
| 通用 | 多数业务报告 | 结论 → 指标 → 趋势异常 → 建议 |
| 客户拜访 | 销售/客户经理 | 画像 → 趋势 → 风险 → 拜访清单 |
| 经营分析 | 管理层复盘 | 总盘 → 多维贡献 → 归因 → 改善 |
| 周报/月报 | 周期性汇报 | KPI → 事件 → 问题 → 下周期重点 |