项目地址github：
https://github.com/jd-opensource/joyagent-jdgenie

JoyAgent-JDGenie 总体架构图

从代码分析该项目分为四大块

Genie Backend

Genie Backend 是一个基于 Java 和 Spring Boot 的后端服务，为 Genie 项目提供核心功能支持。该项目集成了多种智能代理（Agent），旨在提供高效的智能对话和任务处理能力。

技术栈：

• Java
• Spring Boot
• Maven
• SSE (Server-Sent Events)
• 多代理系统

Genie Client

python客户端

启动步骤：

这里我遇到.venv的虚拟环境异常   所以我直接删除了虚拟环境 重置
 #  Remove-Item -Recurse -Force .venv
 #  使用 uv 创建新的 venv    
 #  uv venv 
 #  .venvScriptsActivate.ps1   
 #  启动服务
 #  uv run python server.py

Genie Tool

python >= 3.11

 1.  uv sync --index-url https://pypi.tuna.tsinghua.edu.cn/simple --python=python
由于本地一直无法下载到它项目需要的3.11python 我直接使用了系统安装的3.13包 然后用国内镜像

2.  激活.venv虚拟环境，win直接执行script的active.bat

初始化数据库-仅一次
3. python -m genie_tool.db.db_engine    

注意将里面的大模型配置换成你可以用的，列如qweb，kimi等
4.  cp .env_template .env

启动服务
5.  uv run python server.py

Genie UI 快速开始

Genie UI 是一个基于 React、TypeScript 和 Vite 的现代化项目。

• 基于 React 19 和 TypeScript
• 使用 Vite 作为构建工具，提供快速的开发体验
• 集成 Ant Design 组件库
• 支持 Markdown 渲染
• 文件预览和处理功能
• 使用 ESLint 和 Prettier 进行代码规范化

我做的一些前置工作

本地没有pnpm需要先安装下，我本机先安装了一下nvm为了方便管理nodejs

1.安装nvm 

2.安装pnpm
npm install -g pnpm
corepack enable

3.使用国内淘宝镜像
pnpm config set registry https://registry.npmmirror.com


然后就可以愉快的用下方install啦

1. 安装依赖：

pnpm install

2. 启动开发服务器：

pnpm run dev

看看效果

首页

Genie智能体根据用户需求生成大盘分析

Genie智能体根据用户需求生成京东财报分析

优点：

实时预览跟随，让用户直观感受智能体工作的过程，不再是枯燥无味的几分钟等待！