京东开源王炸！JoyAgent-JDGenie 通用智能体一键部署指南，DeepSeek 大模型完美适配

京东技术团队重磅开源 JoyAgent-JDGenie ------一款颠覆性的通用智能体框架！只需 5 分钟 完成 Docker 一键部署，即可拥有媲美 Claude/GPT-4 的 AI 智能体。支持无缝接入 DeepSeek 大模型（免费开放！），实现 128K 超长上下文推理、多工具协同和自动化任务处理。无论开发者还是企业，都能通过这份保姆级指南，快速搭建专属 AI 助手，开启智能交互新时代！

🔥 核心亮点：

京东工业级开源：电商巨头技术沉淀，企业级稳定性保障

零门槛部署：Docker 全自动构建，支持 DeepSeek 免翻墙直连

多模态扩展：自由接入工具链，实现代码执行/数据分析/自动化办公

开源即用：完整项目 GitHub 开放，视频教程+双部署方案护航

系统架构

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

主要特点和优势

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

环境准备

docker 方式：

docker

本地：

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

部署

方式1:🐳 Docker 一键部署流程（推荐方案）

克隆项目

shell 复制代码

git clone https://github.com/jd-opensource/joyagent-jdgenie.git
# 没有git 可以使用wget
wget https://github.com/jd-opensource/joyagent-jdgenie/archive/refs/heads/main.zip
# 连接不上github.com 可以使用其他可以连接的网络下载

下载地址

修改配置

注：以下配置需根据您的 DeepSeek API 密钥调整（获取 DeepSeek API Key）官网使用的DeepSeek-V3 ，我是用的DeepSeek-R1 ，也能用，配置DeepSeek-R1 模型参考配置DeepSeek-R1模型

genie-backend/src/main/resources/application.yml

修改base_url、apikey、model、max_tokens、model_name等配置使用DeepSeek时: 注意deepseek-chat 为max_tokens: 8192

shell 复制代码

cd joyagent-jdgenie-main
#修改genie-backend/src/main/resources/application.yml
#使用DeepSeek时: 注意deepseek-chat 为max_tokens: 8192
llm:
  default:
    base_url: 'https://api.deepseek.com'
    apikey: 'sk-bed****bce0'
    interface_url: '/chat/completions'
    model: deepseek-reasoner
    max_tokens: 8192
  settings: '{"claude-3-7-sonnet-v1": {
        "model": "claude-3-7-sonnet-v1",
        "max_tokens": 8192,
        "temperature": 0,
        "base_url": "https://api.deepseek.com",
        "apikey": "sk-bed2****bce0",
        "interface_url": "/chat/completions",
        "max_input_tokens": 128000
    }}'
#使用vim :%/deepseek-reasoner/deepseek-reasoner/g修改model_name

genie-tool/.env_template

使用DeepSeek时: 设置DEEPSEEK_API_KEY、DEEPSEEK_API_BASE，DEFAULT_MODEL 设置为 deepseek/deepseek-chat，所有 ${DEFAULT_MODEL} 也都改成deepseek/deepseek-chat

shell 复制代码

#注释掉OPENAI_API_KEY OPENAI_BASE_URL
#OPENAI_API_KEY=
#OPENAI_BASE_URL=<your base url>

# 如果使用deepseek，请使用如下变量
 DEEPSEEK_API_KEY=sk-****bce0
 DEFAULT_MODEL=deepseek/deepseek-reasoner

ui/.env

shell 复制代码

# 后端的基础路径,默认是127.0.0.1，会导致其他主机无访问web/api/v1/gpt/queryAgentStreamIncr接口
SERVICE_BASE_URL="http://ip:8080"

编译dockerfile

shell 复制代码

docker build -t genie:latest .

启动docker

shell 复制代码

docker run -d -p 3000:3000 -p 8080:8080 -p 1601:1601 --name genie-app genie:latest

浏览器输入 ip:3000 访问genie

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

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

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

方案2：💻 本地部署方案（备选）手动一键启动部署

直接通过shell启动所有服务

bash 复制代码

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

部署时可以参考视频:【joyagent-jdgenie部署演示】 www.bilibili.com/video/BV1Py...

关键注意事项

网络访问：
- 确保 SERVICE_BASE_URL 使用公网 IP（非 127.0.0.1）
- 开放防火墙端口：3000（前端）、8080（API）
API Key 安全：
- 配置文件中的 API Key 需替换为您自己的密钥
- 禁止将含密钥的配置文件提交到 Git

参考

Agent开源git开源文档

DeepSeek API 文档