Harness 与 Agent 工程 · AI研发与测试工程 · 2025-07-31

手把手教你本地部署!京东JoyAgent全攻略:从零拥有一个企业级的AI Agent

京东开源企业级AI Agent平台JoyAgent-JDGenie,带你从零部署,轻松打造高效智能体应用!

核心内容:

  1. JoyAgent-JDGenie的核心优势与产品特性
  2. 本地部署JoyAgent的详细步骤指南
  3. 智能体应用开发实战案例与技巧

长期聚焦飞书开发套件开发、多维表格定制、prompt 定制、智能体设计与自动化工作流构建、ComfyUI 工作流定制,致力于打造真正可用、可复制、可变现的业务系统解决方案。

今年世界人工智能大会(WAIC 2025)最让人兴奋的,不是又多了几个参数惊人的大模型。当你看遍800家企业的展台、上百种机器人后,那个最强烈的感受会告诉你:AI,终于不“飘”在天上了。一股“深度应用”的浪潮,正让技术真正落地,创造价值。

它不再是隔空炫技,而是真的被用起来了,实实在在地解决着问题。

在加速产业走向AI深度应用这条道路上,国内巨头京东无疑按下了“加速键”。大会期间,京东不仅将其大模型品牌全面升级为JoyAI,更向全球开发者亮出了一张源自复杂业务场景的王牌——正式开源其企业级多智能体平台 JoyAgent-JDGenie。

它致力于解决开发者快速构建多智能体应用的“最后一公里”问题,其核心理念是提供一个端到端的、轻量化的完整产品,而非仅仅是一个SDK或框架。

本文将为你详细解读这款“开箱即用”的多智能体产品的核心能力,并提供完整的本地部署教学,带你全面拥抱这个强大的AI Agent工具👇


01 | JoyAgent-JDGenie:企业级多智能体“全能选手”


JoyAgent-JDGenie 是京东JoyAI大模型体系下的核心产品。不同于许多依赖特定云生态(如阿里云百炼、火山引擎)的工具,它是一个相对轻量且完整的解决方案。它不仅在GAIA等权威榜单上性能超越众多知名产品,更重要的是,它源自于京东在零售、物流、供应链等真实、严肃且复杂场景中的大规模实践。


✅ 端到端完整产品: 开箱即用,对于输入的任务(如“给我做一个最近美元和黄金的走势分析”),可以直接生成网页或PPT报告,而非仅提供开发框架。

✅ 100%全栈开源: 完整开源了前端、后端、框架、引擎及核心子智能体(报告生成、代码、PPT、文件处理等),赋予开发者极高的自由度和二次开发能力。

✅ 轻量化与高兼容性: 无需强制绑定特定云服务,可与多种模型(如DeepSeek)轻松集成,部署更灵活。

✅ 经过实战检验: 已在京东内部超过1.4万个智能体的庞大规模下得到验证,保证了其在复杂场景下的稳定性和可靠性。

✅ 其核心优势清单如下


02 | 上手实践:本地部署 JoyAgent-JDGenie


现在,让我们动手将JoyAgent-JDGenie完整部署到本地。


✅ 部署指南(一):Docker 一键启动 (推荐)


    1. 准备工作:
git clone https://github.com/jd-opensource/joyagent-jdgenie.gitcd joyagent-jdgenie
    1. 配置模型服务: - 后端配置: 手动更新 genie-backend/src/main/resources/application.yml 文件,填入你的大模型 base_url, apikey, 和 model 等信息。 - 工具配置: 手动更新 genie-tool/.env_template 文件,填入如 OPENAI_API_KEY, SERPER_SEARCH_API_KEY 等(如果使用DeepSeek,则配置 DEEPSEEK_API_KEY 等)。 - 4. 构建镜像:
docker build -t genie:latest .
    1. 启动与访问:
docker run -d -p 3000:3000 -p 8080:8080 -p 1601:1601 --name genie-app genie:latest
    1. 部署成功后,通过浏览器访问 http://localhost:3000/ 即可。 部署若遇问题,可参考官方视频:【5分钟使用deepseek启动开源智能体应用joyagent-genie-哔哩哔哩】 https://b23.tv/8VQDBOK

✅ 部署指南(二):手动启动服务

方案A:一键脚本启动 (推荐)

    1. 环境准备: 确保已安装 JDK 17 和 Python 3.11。
    1. 执行脚本: 在项目根目录下,依次执行:
## 1. 检查所有依赖和端口占用情况sh check_dep_port.sh# 2. 一键启动所有服务sh Genie_start.sh

提示: 这种方式最便捷。使用 control+c 可一键停止所有相关服务。

方案B:手动分步启动 (适用于问题排查) 此方案需要手动启动四个服务:前端、后端、Tools 和 MCP。

Step 1: 环境准备:


Step 2: 启动前端服务 (UI)

cd joyagent-jdgenie/uish start.sh

- 当看到 Local: http…

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/OpenSourceLLM/2025073172680.html