How abcliyew/agent-mesh works
Agent Mesh is a Spring Boot backend for configuring and running reusable AI agents. Its main user path is a chat request into the unified agent engine, which plans and executes work and returns a response; the README documents an OpenAI-compatible API with streaming and tool calls. Separate capabilities cover agent/tool networks, RAG document ingestion and retrieval, workflow execution, MCP integrations, skills, and cost monitoring. Source excerpts show engine planning and direct-response handling, workflow node dispatch, RAG vector-store access, and skill controller-to-service calls; links between unsampled subsystems are limited to documented product relationships.
Main entry points: UnifiedAgentEngineImpl.java Unified engine · WorkflowEngineImpl.java Workflow engine · mapper PostgreSQL data · UnifiedAgentController.java Unified agent API
Components 24
Agent runtime
- Unified agent API
src/main/java/com/esdllm/agentmesh/controller/UnifiedAgentController.java - Unified engine
src/main/java/com/esdllm/agentmesh/service/unified/impl/UnifiedAgentEngineImpl.java - Task planner
src/main/java/com/esdllm/agentmesh/service/unified/impl/TaskPlanner.java - Agent network
src/main/java/com/esdllm/agentmesh/service/impl/AgentNetworkServiceImpl.java - Tool invocation
src/main/java/com/esdllm/agentmesh/service/agent/ToolInvoker.java - Model selection
src/main/java/com/esdllm/agentmesh/service/model/impl/ModelSelectionServiceImpl.java - Model providers
src/main/java/com/esdllm/agentmesh/service/impl/ModelProviderServiceImpl.java - AI model services
src/main/java/com/esdllm/agentmesh/service/impl/AiModelServiceImpl.java
Knowledge and retrieval
- Knowledge base API
src/main/java/com/esdllm/agentmesh/controller/KnowledgeBaseDocumentController.java - Document processing
src/main/java/com/esdllm/agentmesh/service/DocumentProcessingService.java - RAG retrieval
src/main/java/com/esdllm/agentmesh/service/rag/impl/RagRetrievalServiceImpl.java - Vector search
src/main/java/com/esdllm/agentmesh/service/VectorSearchService.java
Extensions and workflows
- Workflow API
src/main/java/com/esdllm/agentmesh/controller/WorkflowController.java - Workflow engine
src/main/java/com/esdllm/agentmesh/service/workflow/impl/WorkflowEngineImpl.java - MCP services API
src/main/java/com/esdllm/agentmesh/controller/McpServerController.java - MCP integration
src/main/java/com/esdllm/agentmesh/service/impl/McpServerServiceImpl.java - Skill market API
src/main/java/com/esdllm/agentmesh/controller/SkillMarketController.java - Skill market
src/main/java/com/esdllm/agentmesh/service/unified/impl/SkillMarketServiceImpl.java
Management and monitoring
- Cost monitoring
src/main/java/com/esdllm/agentmesh/service/impl/CostMonitoringServiceImpl.java
Persistence
- PostgreSQL data
src/main/java/com/esdllm/agentmesh/repository/mapper
Other components
- API consumer
- LLM providers
- PostgreSQL pgvector
- MCP endpoints
Connections 27
- API consumer → Unified agent API: sends chat
- Unified agent API → Unified engine: invokes
- Unified engine → Task planner: plans tasks
- Unified engine → Model selection: selects model
- Unified engine → Tool invocation: executes tools
- Unified engine → Agent network: uses agents
- Model selection → AI model services: selects from
- AI model services → Model providers: uses provider
- Model providers → LLM providers: calls models
- API consumer → Knowledge base API: manages documents
- Knowledge base API → Document processing: processes
- Document processing → RAG retrieval: embeds chunks
- RAG retrieval → Vector search: searches and stores
- Vector search → PostgreSQL pgvector: reads and writes
- API consumer → Workflow API: submits workflow
- Workflow API → Workflow engine: executes
- Workflow engine → Tool invocation: dispatches tools
- API consumer → MCP services API: configures MCP
- MCP services API → MCP integration: manages servers
- MCP integration → MCP endpoints: connects
- API consumer → Skill market API: manages skills
- Skill market API → Skill market: invokes
- API consumer → Cost monitoring: reviews costs
- Unified engine → Cost monitoring: tracks usage
- Unified engine → PostgreSQL data: reads agent data
- Workflow engine → PostgreSQL data: loads tools
- Skill market → PostgreSQL data: stores skill data