一句需求 5 分钟出报告：JoyAgent-JDGenie 多格式报告生成智能体实战

【免费下载链接】joyagent-jdgenie开源的端到端产品级通用智能体项目地址: https://gitcode.com/gh_mirrors/jo/joyagent-jdgenie

周五下午五点，老板发话：“下班前把本周销售分析发我，明天早会用。”你手里是 40 多张 sheet 的销售 Excel，接下来要么是手动拉透视表、贴图表，要么是把数据丢给大模型让它吐一段 Markdown 总结——结果往往是一堆没有结构的数字，演示时还得自己重新排版成 PPT。多格式报告生成智能体就是为了干掉这段重复劳动：JoyAgent-JDGenie 让你把数据文件和分析需求丢进去，直接产出 HTML、PPT、Markdown 三种格式的成品报告。

它是什么：一个开箱即用的开源智能体产品

它本质上是一个端到端的开源多智能体产品：输入一句 query 或一个任务，直接给你回答或交付完整产物，而不是让你先搭一套 agent 框架再动手。和报告生成最相关的几项能力：

报告生成主界面，支持多格式输出

从一句话到一份报告：输入、处理、输出

输入侧：你只需要三样东西

一句自然语言需求、数据文件、期望的输出格式。比如“分析这份超市销售数据，出个报告，做成 PPT”。后端收到请求后，会先在 query 后面追加对应输出样式的约束提示，再去组装上下文，所以下游不需要你写任何提示词工程。

处理侧：先规划，再执行，报告交给工具服务

规划智能体 PlanningAgent 负责把模糊需求拆成可执行的步骤，执行智能体 ExecutorAgent 按计划逐步调工具。挑一个最典型的细节看：报告生成工具 ReportTool 自己不写报告内容，它把任务和文件内容打包传给 Python 侧的工具服务（genie-tool模块的 report.py），由那里按格式套用提示词模板、调大模型流式吐出版面。PPT 的提示词（report.yaml）管得很细：16:9 比例、扁平化卡片布局、按金字塔原理先提炼大纲再生成每页、数据必须来自文件禁止捏造，超出一页就强制拆分。

输出侧：三种格式，三种用途

PPT 格式报告，16:9 带播放控制

HTML 格式报告，图表与表格并列

架构一瞥：两个“脑子”加一组工具

它为什么能做到？一句话：规划脑拆任务，执行脑干活的脑子各管各的，工具负责具体动作，全程上下文共享、流式输出。

• PlanningAgent——把模糊需求拆成可执行步骤
• ExecutorAgent——按计划执行具体工具调用
• ReportTool——报告生成入口，把任务和文件交给工具服务
• DeepSearchTool/CodeInterpreterTool/FileTool——分别负责找素材、算数据、解析文件

想深入源码可以从报告工具的 Java 入口看起：ReportTool.java。

五分钟上手：从克隆到第一份报告

git clone https://gitcode.com/gh_mirrors/jo/joyagent-jdgenie cd joyagent-jdgenie sh Genie_start.sh

1. 配大模型：填genie-backend/src/main/resources/application.yml的 base_url、apikey、model，再填genie-tool/.env的密钥——启动脚本会检查占位符，没配好会直接拦住你并提示缺哪个。
2. 跑sh check_dep_port.sh，确认 JDK 17、Python 3.11 等依赖和端口都没被占用。
3. sh Genie_start.sh一键拉起前端、后端、工具服务三个进程，以后改配置重跑这个脚本即可。
4. 浏览器打开 localhost:3000，你会看到对话式主界面。
5. 上传一份 Excel，发一句“分析数据并生成 PPT 报告”，你会看到计划步骤逐条推进、报告内容流式吐出，最后拿到成品文件。

主界面：上传文件后直接对话生成报告

它适合谁，又不太适合谁

比较适合三类人：数据分析师，周报月报从“拉表贴图”变成“传文件出成品”；产品经理和运营，把调研结论、竞品材料整理成能直接上台演示的 PPT，不用求人排版；技术团队，项目连前端、后端、提示词一起开源，挂载自己的 MCP 工具或子 Agent 做二次开发成本很低。

边界也说清楚：它生成的 PPT 是 HTML 幻灯片页面而不是 .pptx 文件，需要逐像素控制模板的场合它还不擅长；另外它不是免部署的在线服务，你得有能跑 Java + Python 的环境和自己的大模型 key。

收尾

回到开头那个周五：现在你只需要上传 Excel、发一句话，下班前把演示用的 PPT 直接甩进群里就行。项目仓库地址：https://gitcode.com/gh_mirrors/jo/joyagent-jdgenie ，和上面克隆用的是同一个，动手试一下只需要 5 分钟。

【免费下载链接】joyagent-jdgenie开源的端到端产品级通用智能体项目地址: https://gitcode.com/gh_mirrors/jo/joyagent-jdgenie