“Make me the regional sales report from sales.csv” 是一个语言模型会愉快地通过输出 Markdown 表格、四舍五入几个数字并描述它无法绘制的图表来回答的请求。使用本地运行的 GroupDocs.Assembly.Mcp (dnx GroupDocs.Assembly.Mcp --yes),Claude Desktop、Cursor 或 Copilot 会把数据文件交给引擎处理:你的 Word 或 PowerPoint 模板中已经包含了表格、总计和真实的图表,服务器直接从 CSV 或电子表格中填充它们,数字根本不会经过模型:

使用 sales.xlsx 生成 sales-report.docx 的 PDF 区域销售报告,并使用 sales-chart.pptx 生成图表幻灯片。

带有配置和故障排除的逐步版本请参见文档:如何使用 AI 代理从 CSV 或电子表格构建带表格和图表的报告。

为什么要让数字跳过模型?

因为模型是文本生成器,而报告是算术加布局。当代理读取 CSV 并自行编写报告时,每个数值都是通过下一个 token 预测重新键入的。大多数是正确的,唯一出错的数字在有人将其与源文件对比检查之前是不可见的,而这正是报告本应节省的工作。图表更糟:模型可以描述图表,或输出绘制图表的代码,但你季度演示文稿中的图表是 PowerPoint 文件中的对象,由营销人员进行样式设置。

所以按各自擅长的方式分工。模板决定报告的外观。引擎读取文件并进行计算。代理选择模板和数据,并告诉你结果。

代理传递的内容,以及引擎看到的内容

下面是一张表格展示的划分:

代理决定的内容          引擎执行的操作            模板拥有的内容
-----------------------  -------------------------  -----------------------
使用哪个模板            读取 sales.xlsx/.csv      表格布局
使用哪个数据文件        列出列名                  图表及其样式
输出格式(pdf)          求和、排序、挑选最大值    标题、字体、徽标
                         填充表格行、图表          “total”的含义

在生成之前,代理可以先查看数据文件。对于我们的电子表格,服务器报告了一个包含三列的表格:

-> get_document_info {"file":{"filePath":"sales.xlsx"}}
<- { "dataKind": "table",
     "data": { "tableCount": 1, "tables": [ { "number": 1,
       "columns": [ "Region", "Quarter", "Revenue" ] } ] } }

表格报告

Word 模板在第一单元格中有 <<foreach [r in sales]>>,在最后一个单元格中有 <</foreach>>,并在其下方还有两行:<<[sales.Sum(r => r.Revenue)]>> 和 <<[sales.OrderByDescending(r => r.Revenue).First().Region]>>。一次调用:

-> assemble_document {"template":{"filePath":"sales-report.docx"},
     "data":{"filePath":"sales.xlsx"},"format":"pdf"}
<- Assembled 'sales-report.docx' with 'sales.xlsx' (table 1 (3
   column(s): Region, Quarter, Revenue) as 'sales') as PDF
   Saved to: .../sales-report_assembled.pdf

报告包含四行(North 182000、South 146500、East 98250、West 211900),“Total revenue: 638650 EUR” 和 “Best region: West”。服务器将数据命名为 sales,因为模板正是遍历该名称;无需额外声明。使用 sales.csv 的相同模板也得到相同的总计;对于 CSV,hasHeaders 和 csvDelimiter 可处理没有标题行或使用分号的文件。

图表

GroupDocs.Assembly 模板中的图表是普通图表,只是在两个位置放置了标签。图表标题为 Revenue by region<<foreach [r in sales]>><<x [r.Region]>>:遍历行,为每个地区生成一个类别。系列名称为 Revenue<<y [r.Revenue]>>:每行生成一个数值。图表内部的占位数据仅用于设计时预览。

-> assemble_document {"template":{"filePath":"sales-chart.pptx"},
     "data":{"filePath":"sales.xlsx"}}
<- Assembled 'sales-chart.pptx' with 'sales.xlsx' (table 1 (3
   column(s): Region, Quarter, Revenue) as 'sales') as PPTX
   Saved to: .../sales-chart_assembled.pptx

我们打开结果:一个标题为 Revenue by region 的柱状图,类别为 North、South、East、West,数值分别为 182000、146500、98250、211900,标签已被移除,模板的样式保持完整。Word 和 Excel 图表均由同一引擎填充;Excel 对系列名称有自己的规则,详见库的模板语法。

为什么不让代理直接生成图表图片?

可以,而且在聊天中一次性回答时这样做没问题。但在报告中有三个问题:图片是静态的,没人能点击进去核对数值;其样式是绘图代码的默认风格,而不是你的企业风格;而且图表上的数字已经通过模型传递。模板图表是原生图表对象,直接从文件填充,样式只需在模板中设定一次。

诚实的限制

  • 表格和图表标签必须已经写入模板;代理不会自行设计它们。get_template_fields 会显示模板读取了哪些数据。
  • 评估模式:每个输出都会以 “Evaluation Only. Created with GroupDocs.Assembly 26.7…” 开头,保存的工作簿会额外增加一个工作表。
  • 数据中为空的列表没有列类型,即使使用 allowMissingMembers,对其成员的算术运算也会失败;在表格外包裹 <<if>> 并不能避免此问题。请确保你请求的过滤条件会返回行。
  • 在 Linux 和 macOS 上运行的演示文稿模板(PPTX、PPT、ODP)需要 libgdiplus,通过 dnx 运行时必须安装;Word 和 Excel 模板不需要,Docker 镜像已包含所有依赖。
  • 数据文件中的日期:请保持为日期格式或完整的 ISO 带时间,并在模板中进行格式化。

FAQ

AI 代理能在不上传 CSV 的情况下生成图表吗?
可以。服务器本地运行,从你的存储文件夹读取 CSV 或电子表格并在本地生成报告;数字直接从文件流向文档,未经过模型。

模板可以读取哪些数据文件?
JSON、XML、CSV 和 TSV,以及电子表格、Word 或 PowerPoint 文档中的表格;当存在多个表格时,dataTable 用于指定要使用的表格。

报告可以是 Excel 文件而不是 PDF 吗?
可以,使用 XLSX 模板;标签写入工作表单元格。评估模式下保存的工作簿会额外增加一个工作表。

深入了解