JoyAgent-JDGenie 是业界首个开源的高完成度、轻量化通用多智能体产品，由京东相关团队开源，目标是解决快速构建多智能体产品的“最后一公里”问题。
【用途】 当前相关开源 agent 主要是 SDK 或者框架，用户还需基于此做进一步开发，无法直接做到开箱即用。JoyAgent-JDGenie 是端到端的多 Agent 产品，对于输入的 query 或者任务，可以直接回答或者解决。例如用户 query“给我做一个最近美元和黄金的走势分析”，JoyAgent-Genie 可以直接给出网页版或者 PPT 版的报告文档。
【主要能力】
- 端到端完整的多智能体产品，开箱即用，支持二次开发。
- 智能体框架协议，支持多种智能体设计模式（react 模式、plan and executor 模式等）。
- 多智能体上下文管理。
- 高并发 DAG 执行引擎，追求极致的执行效率。
- 子 Agent 和工具可插拔：预置多种子智能体和工具。
- 多种文件交付样式：html、ppt、markdown。
- plan 和工具调用，RL 优化迭代。
- 全链路流式输出。
- multi-level：work level 和 task level。
- multi-pattern：plan and executor 模式和 react 模式。
- 基于已有工具迭代产生新工具，而不是从 0-1 直接生成新工具（减少错误工具的生成）。
- 基于已有工具隐性拆解为原子工具，并基于原子工具结合大模型自动组合成新工具（不需要花费人力预先定义和拆解原子工具）。
- 整体开源了智能体产品 JoyAgent-JDGenie，包括前端、后端、框架、引擎、核心子智能体（报告生成智能体、代码智能体、PPT 智能体、文件智能体等）。
【通用性验证】 为了验证 JoyAgent-JDGenie 的通用性，在 GAIA 榜单 Validation 集准确率 75.15%、Test 集 65.12%，已超越 OWL（CAMEL）、Smolagent（Huggingface）、LRC-Huawei（Huawei）、xManus（OpenManus）、AutoAgent（香港大学）等行业知名产品。
【轻量化特点】 JoyAgent-JDGenie 相对比较轻量，不像阿里的 SpringAI-Alibaba 需要依赖阿里云百炼平台相关功能（基于百炼平台调用 LLM），Coze 依赖火山引擎平台。
【相关组件】
- 多模态知识管理平台：一款面向多模态非结构化知识的 RAG 解决方案，集成解析、检索与生成能力，能够高效处理复杂文档，为智能问答与内容生成提供一站式支持。面向多模态文档的综合性 RAG 平台，为复杂文档的智能问答与内容生成提供一站式解决方案（注意使用 mrag 分支）。
- JoyDataAgent：企业内部知识主要包括结构化表格知识和非结构化知识。因此对于结构化表格知识建设了开箱即用的 DataAgent 能力，主要包括数据治理 DGP 协议、智能问数和智能诊断分析。JoyDataAgent 是首个开源的包含数据治理 DGP 协议、智能问数和智能诊断分析的智能体（注意使用 data_agent 分支）。
【使用方式】 方式1：docker 一键启动服务。如果部署遇到问题，可以参考视频：【5分钟使用 deepseek 启动开源智能体应用 joyagent-genie-哔哩哔哩】 https://b23.tv/8VQDBOK 方式2：手动初始化环境，启动服务。 python 环境准备： pip install uv cd genie-tool uv sync source .venv/bin/activate 手动超详细攻略参考 Step by Step。 直接通过 shell 启动所有服务。 部署时可以参考视频：【joyagent-jdgenie 部署演示】 https://www.bilibili.com/video/BV1Py8Yz4ELK/?vd_source=a5601a346d433a490c55293e76180c9d
【如何添加自己的 MCP 工具到 JoyAgent-JDGenie 中】
- 在 genie-backend/src/main/resources/application.yml 添加 mcp_server 服务，多个 server 逗号分隔。
- 在 ui/.env 中可以修改前端请求后端的路径。
- 比如添加 12306 工具后，规划 7 月 7 天 2 人从北京出发去新疆旅行计划，并查询相关火车票信息，genie 会进行旅行计划设计，然后调用 mcp 工具查询车票信息，最终输出报告。
【新增自定义子 Agent 到 JoyAgent-JDGenie 中】
- 实现 BaseTool 接口，声明工具的名称、描述、参数、调用方法。
- 在 com.jd.genie.controller.GenieController#buildToolCollection 中添加如下代码，引入自定义 Agent。
【适用场景】 适用于需要快速构建和部署通用多智能体产品的场景，例如自动生成分析报告（网页版或 PPT 版）、旅行计划设计与车票查询、企业内部结构化与非结构化知识的智能问答与内容生成等。对于用户需要定制的新场景功能，只需将相关的子智能体或者工具挂载到 JoyAgent-Genie 即可。
【限制】 资料中未明确列出使用限制。项目欢迎所有好想法和建议，若想成为项目的共建者，可随时提 Pull Request。在此之前需要阅读并签署贡献者协议并发送到邮箱 org.developer3@jd.com，请阅读贡献指南中文版、贡献指南英文版。如需学术引用，请使用项目提供的 BibTeX。
