How ram333n/uni-agent works
Uni Agent combines a Chainlit conversational assistant with a faculty-document MCP service and a Flask dataset-labeling utility. The principal workflow is a user message entering the chat application, being handled by the agent, and optionally invoking faculty semantic search through MCP before returning an answer. Separately, document uploads are parsed, split, embedded, and indexed; REST endpoints also support search and deletion. The README identifies labeling and evaluation datasets as supporting capabilities. Some subsystem links are documented rather than source-verified, so those links are dashed; unsampled implementation details are not inferred.
Main entry points: FacultyDocumentServiceImpl.java Document service · agent.py Agent orchestration · FacultyMcpController.java Faculty MCP server · DocumentController.java Document REST API
Components 23
Chat agent
- Chainlit app
agent/src/application/app.py - Agent orchestration
agent/src/agent/agent.py - System prompt
agent/src/agent/prompts.py - Host tools
agent/src/agent/tools.py
Faculty search API
- Faculty MCP server
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/mcp/FacultyMcpController.java - Document REST API
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/rest/DocumentController.java - Document service
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FacultyDocumentServiceImpl.java - Search request
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/common/dto/SemanticSearchRequest.java - Search results
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/common/dto/SemanticSearchResults.java - Result entry
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/common/dto/SemanticSearchResultEntry.java
Document indexing
- Document splitter
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/ingestion/splitter/OverlappingDocumentSplitter.java - Token estimator
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/ingestion/splitter/CL100KTokenEstimator.java - File storage service
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FileServiceImpl.java - Storage settings
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/config/properties/StorageProperties.java - Document repository
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/repository/FacultyDocumentRepository.java - Document metadata
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/domain/FacultyDocument.java
Labeling and evaluation
- Labeling web app
labeling-tool/app/app.py - Labeling UI
labeling-tool/app/static/app.js - Evaluation datasets
test-dataset - Search benchmarks
metrics
Other components
- User
- Groq LLM
- PostgreSQL pgvector
Connections 24
- User → Chainlit app: sends message
README.md - Chainlit app → Agent orchestration: initializes
agent/src/application/app.py - Agent orchestration → System prompt: uses prompt
agent/src/agent/agent.py - Agent orchestration → Host tools: registers tools
agent/src/agent/agent.py - Agent orchestration → Groq LLM: calls model
agent/src/agent/agent.py - Agent orchestration → Faculty MCP server: fetches MCP tools
agent/src/agent/agent.py - Faculty MCP server → Document service: searches via
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/mcp/FacultyMcpController.java - Faculty MCP server → Search request: accepts
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/mcp/FacultyMcpController.java - Faculty MCP server → Search results: returns
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/mcp/FacultyMcpController.java - Document REST API → Document service: delegates
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/rest/DocumentController.java - Document REST API → Search request: accepts
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/rest/DocumentController.java - Document REST API → Search results: returns
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/controller/rest/DocumentController.java - Document service → Document repository: reads and writes
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FacultyDocumentServiceImpl.java - Document repository → Document metadata: persists
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/repository/FacultyDocumentRepository.java - Document service → File storage service: stores files
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FacultyDocumentServiceImpl.java - File storage service → Storage settings: uses settings
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FileServiceImpl.java - Document service → PostgreSQL pgvector: adds and searches
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FacultyDocumentServiceImpl.java - Document service → Document splitter: transforms chunks
- Document splitter → Token estimator: estimates tokens
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/ingestion/splitter/OverlappingDocumentSplitter.java - Document service → Result entry: maps results
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/service/impl/FacultyDocumentServiceImpl.java - Search results → Result entry: contains
mcp-servers/faculty-mcp-server/src/main/java/org/prokopchuk/facultymcpserver/common/dto/SemanticSearchResults.java - Labeling web app → Labeling UI: serves UI
- User → Labeling web app: labels datasets
README.md - Evaluation datasets → Labeling web app: supports labeling
README.md