How ageerle/ruoyi-ai works
RuoYi AI is an enterprise AI assistant platform. Its main user journey is submitting a request to an AI capability and receiving a streamed or ordinary result; documented branches include multi-agent/tool use, knowledge retrieval, and visual workflows. The backend also provides account access, knowledge administration, and shared platform services. The graph preserves README capabilities, but several implementation paths were not sampled, so those links are marked as unverified rather than asserted as source-level calls.
Main entry points: IChatService.java Chat and agents · KnowledgeFragmentController.java Knowledge fragments · SysLoginService.java Login service · WorkflowEngine.java Workflow engine
Components 23
Access and platform
- Login service
ruoyi-modules/ruoyi-system/src/main/java/org/ruoyi/system/service/SysLoginService.java - Registration service
ruoyi-modules/ruoyi-system/src/main/java/org/ruoyi/system/service/SysRegisterService.java - Authentication API
ruoyi-admin/src/main/java/org/ruoyi/controller/AuthController.java
AI assistant
- Chat and agents
ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/chat/IChatService.java - Model management
ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/chat/IChatModelService.java - Media generation
ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/service/image/IImageGenerationService.java - MCP tools
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/mcp/service/core/LangChain4jMcpToolProviderService.java - Skills
ruoyi-admin/src/main/resources/skills - Chat contracts
ruoyi-common/ruoyi-common-chat/src/main/java/org/ruoyi/common/chat/enums/ErrorEnum.java
Knowledge and retrieval
- Knowledge fragments
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Knowledge retrieval
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/service/retrieval/KnowledgeRetrievalService.java - Vector databases
Workflow orchestration
- Workflow management
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/service/WorkflowService.java - Node management
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/service/WorkflowNodeService.java - Workflow engine
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowEngine.java - Workflow runtime
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/service/WorkflowRuntimeService.java - SSE streaming
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowEngine.java
Shared services
- API response model
ruoyi-common/ruoyi-common-core/src/main/java/org/ruoyi/common/core/domain/R.java - Web base controller
ruoyi-common/ruoyi-common-web/src/main/java/org/ruoyi/common/web/core/BaseController.java - Tenant context
ruoyi-common/ruoyi-common-tenant/src/main/java/org/ruoyi/common/tenant/helper/TenantHelper.java - Pagination
ruoyi-common/ruoyi-common-mybatis/src/main/java/org/ruoyi/common/mybatis/core/page/PageQuery.java - Core utilities
ruoyi-common/ruoyi-common-core/src/main/java/org/ruoyi/common/core
Other components
- Platform user
Connections 22
- Platform user → Authentication API: authenticates
- Authentication API → Login service: delegates login
ruoyi-admin/src/main/java/org/ruoyi/controller/AuthController.java - Platform user → Registration service: registers
- Platform user → Chat and agents: sends request
- Chat and agents → Model management: selects model
- Chat and agents → MCP tools: uses tools
- Chat and agents → Skills: uses skills
- Chat and agents → Media generation: generates media
- Platform user → Knowledge fragments: manages knowledge
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Knowledge fragments → Knowledge retrieval: tests retrieval
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Knowledge retrieval → Vector databases: queries vectors
- Platform user → Workflow management: designs workflow
- Workflow management → Node management: configures nodes
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/service/WorkflowService.java - Platform user → Workflow engine: runs workflow
- Workflow engine → Workflow runtime: creates runtime
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowEngine.java - Workflow engine → SSE streaming: streams status
ruoyi-modules/ruoyi-aiflow/src/main/java/org/ruoyi/workflow/workflow/WorkflowEngine.java - Knowledge fragments → Web base controller: extends
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Knowledge fragments → Pagination: accepts paging
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Knowledge fragments → API response model: returns envelope
ruoyi-modules/ruoyi-chat/src/main/java/org/ruoyi/controller/knowledge/KnowledgeFragmentController.java - Registration service → Tenant context: checks tenant
ruoyi-modules/ruoyi-system/src/main/java/org/ruoyi/system/service/SysRegisterService.java - Login service → Tenant context: resolves tenant
ruoyi-modules/ruoyi-system/src/main/java/org/ruoyi/system/service/SysLoginService.java - Login service → Core utilities: uses utilities
ruoyi-modules/ruoyi-system/src/main/java/org/ruoyi/system/service/SysLoginService.java