简体中文 | English Version

业界首个开源高完成度轻量化通用多智能体产品(JoyAgent-JDGenie)

解决快速构建多智能体产品的最后一公里问题

new release

企业内部知识主要包括结构化表格知识和非结构化知识。因此对于结构化表格知识建设了开箱即用的 DataAgent 能力，主要包括数据治理 DGP 协议、智能问数和智能诊断分析。 此外对于不同模态的非结构化知识提供多模态 RAG 能力。

JoyDataAgent：首个开源的包含数据治理 DGP 协议、智能问数和智能诊断分析的智能体 （注意使用 data_agent 分支）

多模态 RAG：敬请期待

简介

当前相关开源 agent 主要是 SDK 或者框架，用户还需基于此做进一步的开发，无法直接做到开箱即用。我们开源的 JoyAgent-JDGenie 是端到端的多 Agent 产品，对于输入的 query 或者任务，可以直接回答或者解决。例如用户 query"给我做一个最近美元和黄金的走势分析"，JoyAgent-Genie 可以直接给出网页版或者 PPT 版的报告文档。

JoyAgent-JDGenie 是一个通用的多智能体框架，对于用户需要定制的一些新场景功能，只需将相关的子智能体或者工具挂载到 JoyAgent-Genie 即可。为了验证 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 依赖火山引擎平台。

我们整体开源了智能体产品 JoyAgent-JDGenie，包括前端、后端、框架、引擎、核心子智能体（报告生成智能体、代码智能体、PPT 智能体、文件智能体等）、想用微调后效果更好的欢迎使用 JoyAgent。

案例展示

产品对比

分类	agent	是否开源	是否开源完整产品	是否依赖生态
SDK 类	SpringAI-Alibaba	部分	否，只开源 SDK（SDK）	是（阿里云百炼平台）
	Coze	部分	否，只开源部分 Nieo SDK（SDK）	是（火山引擎平台）
框架类	Fellow	是	否，只开源了 Eko 智能体框架（框架）	否
	Dify	是	否，只开源了智能体框架，且主要是 workflow（框架）	否
	SkyworkAI	是	否，只开源了智能体框架（框架）	否
	OpenManus	是	否，只开源了智能体框架（框架）	否
	Owl	是	否，只开源了智能体框架（框架）	否
	n8n	是	否，只开源了智能体框架，且主要是 workflow（框架）	否
协议类	MCP	是	否，只是开源协议	否
	A2A	是	否，只是开源协议	否
	AG-UI	是	否，只是开源协议	否
技术模块类	memory0	是	否，只是开源的技术模块	否
	LlamaIndex	是	否，只是开源的技术模块	否
产品类	Our	是	是，开源端到端完整的 Agent 产品（产品）	否

框架效果先进性

Test 集效果 65.12%

Validation 集效果 75.15%

Agent	Score	Score_level1	Score_level2	Score_level3	机构
Alita v2.1	0.8727	0.8868	0.8953	0.7692	Princeton
Skywork	0.8242	0.9245	0.8372	0.5769	天工
AWorld	0.7758	0.8868	0.7791	0.5385	Ant Group
Langfun	0.7697	0.8679	0.7674	0.5769	DeepMind
JoyAgent-JDGenie	0.7515	0.8679	0.7791	0.4230	JD
OWL	0.6909	0.8491	0.6744	0.4231	CAMEL
Smolagent	0.5515	0.6792	0.5349	0.3462	Huggingface
AutoAgent	0.5515	0.7170	0.5349	0.2692	HKU
Magentic	0.4606	0.5660	0.4651	0.2308	MSR AI Frontiers
LRC-Huawei	0.406	0.5283	0.4302	0.0769	Huawei
xManus	0.4061	0.8113	0.2791	0.0000	OpenManus

系统架构

本开源项目基于 JoyAgent-JDGenie 产品开源了整体的产品界面、智能体的多种核心模式（react 模式、plan and executor 模式等）、多个子智能体（report agent、search agent 等）以及多整体间交互协议。

主要特点和优势

• 端到端完整的多智能体产品，开箱即用，支持二次开发
• 智能体框架协议
  • 支持多种智能体设计模式
  • 多智能体上下文管理
  • 高并发 DAG 执行引擎，极致的执行效率
• 子智能体和工具
  • 子 Agent 和工具可插拔：预置多种子智能体和工具
  • 多种文件交付样式：html、ppt、markdown
  • plan 和工具调用 RL 优化迭代
  • 全链路流式输出

主要创新点

multi-level and multi-pattern thinking:结合多种智能体设计模式支持多层级的规划和思考

• multi-level：work level 和 task level
• multi-pattern：plan and executor 模式和 react 模式

cross task workflow memory:跨任务级别的相似任务 memory

tool evolution via auto-disassembly-and-reassembly of atom-tools

• 基于已有工具迭代产生新工具，而不是从 0-1 直接生成新工具（减少错误工具的生成）
• 基于已有工具隐性拆解为原子工具，并基于原子工具结合大模型自动组合成新工具（不需要花费人力预先定义和拆解原子工具）

快速开始

方式 1: docker 一键启动服务

1. git clone https://github.com/jd-opensource/joyagent-jdgenie.git

2. 手动更新 genie-backend/src/main/resources/application.yml 中 base_url、apikey、model、max_tokens、model_name 等配置
使用 DeepSeek 时: 注意 deepseek-chat 为 max_tokens: 8192

手动更新 genie-tool/.env_template 中的 OPENAI_API_KEY、OPENAI_BASE_URL、DEFAULT_MODEL、SERPER_SEARCH_API_KEY
使用 DeepSeek 时: 设置 DEEPSEEK_API_KEY、DEEPSEEK_API_BASE，DEFAULT_MODEL 设置为 deepseek/deepseek-chat，所有 ${DEFAULT_MODEL} 也都改成 deepseek/deepseek-chat

3. 编译 dockerfile
docker build -t genie:latest .

4. 启动 dockerfile
docker run -d -p 3000:3000 -p 8080:8080 -p 1601:1601 --name genie-app genie:latest

5. 浏览器输入 localhost:3000 访问 genie

如果部署遇到问题，可以参考视频:【5 分钟使用 deepseek 启动开源智能体应用 joyagent-genie-哔哩哔哩】 https://b23.tv/8VQDBOK

方式 2: 手动初始化环境，启动服务

环境准备

• jdk17
• python3.11
• python 环境准备
  • pip install uv
  • cd genie-tool
  • uv sync
  • source .venv/bin/activate

方案 1：手动 step by step 部署手册

手动超详细攻略参考 Step by Step

方案 2：手动一键启动部署（推荐）

直接通过 shell 启动所有服务

sh check_dep_port.sh # 检查所有依赖和端口占用情况
sh Genie_start.sh  # 直接启动，以后改动配置直接重启动脚本即可，control+c 一键 kill 所有服务

部署时可以参考视频:【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 中可以修改前端请求后端的路径

mcp_server_url: "http://ip1:port1/sse,http://ip2:port2/sse"

启动服务

sh start_genie.sh

开始对话

比如添加 12306 工具后，规划 7 月 7 天 2 人从北京出发去新疆旅行计划，并查询相关火车票信息， genie 会进行旅行计划设计，然后调用 mcp 工具查询车票信息，最终输出报告。

新增自定义子 Agent 到 JoyAgent-JDGenie 中

实现 BaseTool 接口，声明工具的名称、描述、参数、调用方法。

/**
 * 工具基接口
 */
public interface BaseTool {
    String getName(); // 工具名称
    String getDescription(); // 工具描述
    Map<String, Object> toParams(); // 工具参数
    Object execute(Object input); // 调用工具
}

// 天气智能体示例
public class WeatherTool implements BaseTool {
    @Override
    public String getName() {
        return "agent_weather";
    }

    @Override
    public String getDescription() {
        return "这是一个可以查询天气的智能体";
    }

    @Override
    public Map<String, Object> toParams() {
        return "{\"type\":\"object\",\"properties\":{\"location\":{\"description\":\"地点\",\"type\":\"string\"}},\"required\":[\"location\"]}";
    }

    @Override
    public Object execute(Object input) {
        return "今日天气晴朗";
    }
}

在com.jd.genie.controller.GenieController#buildToolCollection中添加如下代码，引入自定义 Agent

WeatherTool weatherTool = new WeatherTool();
toolCollection.addTool(weatherTool);

启动服务

sh start_genie.sh

项目共建者

贡献者：Liu Shangkun,Li Yang,Jia Shilin,Tian Shaohua,Wang Zhen,Yao Ting,Wang Hongtao,Zhou Xiaoqing,Liu min,Zhang Shuang,Liuwen,Yangdong,Xu Jialei,Zhou Meilei,Zhao Tingchong,Wu jiaxing, Wang Hanmin, Zhou Zhiyuan, Xu Shiyue,Liu Jiarun, Hou Kang, Jing Lingtuan, Guo Hongliang, Wang Zhijiang, Liu Yanchen, Chen Kun, Ke Huilin, Pan Zheyi, Duan Zhewen, Tu Shengkun, Zhang Haidong, Wang Heng, Wang Haofen, Zhang Junbo

所属机构:京东 CHO 企业信息化团队（EI）、京东科技协同办公团队、京东物流数据资产团队

贡献和合作

我们欢迎所有好想法和建议，如果您想成为项目的共建者，可随时向我们提 Pull Request。无论是完善产品和框架、修复 bug 还是添加新特性，您的贡献都非常宝贵。 在此之前需要您阅读并签署贡献者协议并发送到邮箱 org.developer3@jd.com，请阅读 贡献指南中文版，贡献指南英文版

引用

如需学术引用，请使用以下 BibTeX：

@software{JoyAgent-JDGenie,
  author = {Agent Team at JDCHO},
  title = {JoyAgent-JDGenie},
  year = {2025},
  url = {https://github.com/jd-opensource/joyagent-jdgenie},
  version = {0.1.0},
  publisher = {GitHub},
  email = {jiashilin1@jd.com;liyang.1236@jd.com;liushangkun@jd.com;tianshaohua.1@jd.com;wangzhen449@jd.com;yaoting.2@jd.com;houkang6@jd.com;jinglingtuan@jd.com;guohongliang@jd.com}
}

Contributors

Star History

欢迎沟通和联系我们