How jd-opensource/joyagent-jdgenie works
Project type and purpose
• This is a full-stack, end-to-end “product”-class multi-agent framework (JoyAgent-JDGenie) that includes:
• A web UI (React/TypeScript)
• A Java Spring-Boot backend hosting a multi-agent orchestration engine
• A Python microservice (genie-tool) implementing MCP tool APIs and a file-based DB
• A Python CLI client (genie-client) for testing/automation
• Purpose: take an incoming user query/task, orchestrate multiple intelligent agents (planning, execution, react modes), invoke tools (code interpreter, search, report generator, MCP calls), manage context/memory, and stream a rich response (HTML/PPT/markdown) back to UI or CLI.
High-level file-structure breakdown
• Top-level scripts & Dockerfile: one‐click builds and orchestrates all components
• genie-backend:
• Spring Boot app (GenieApplication, GenieController)
• Agent framework packages (agent, handler, service, tool, llm, prompt, printer, model)
• Multi-agent engine with patterns: ‘plan-and-executor’, ‘react’
• ToolCollection registering BaseTool implementations (CodeInterpreterTool, DeepSearchTool, FileTool, etc.)
• SSEPrinter for streaming responses, SpringContextHolder, OkHttpUtil for HTTP/LLM calls
• genie-tool:
• Python FastAPI (server.py) exposing MCP endpoints for file management & custom tools
• Local SQLite or file-table DB engine under genie_tool/db
• Prompt YAMLs, LLM util wrappers
• genie-client: Python CLI to invoke backend APIs, manage headers, config, SSE client
• ui: React/Vite SPA, components for ChatView, ActionPanel, Plans, SSE streaming, services/agent.ts to hit backend
Key insights from README
• Multi-agent protocol supporting multi-level (work vs. task) and multi-pattern (planning vs. react) thinking
• Plug-and-play sub-agents and tools, cross-task memory, high-concurrency DAG execution engine
• Outbound LLM calls to OpenAI/GPT or custom LLM via REST (configured in application.yml)
• External MCP servers (genie-tool) configured via mcp_server_url for specialized tool invocation