How fangyaocneu/ai-job-agent works
AI Job Agent combines automated job discovery and multi-stage candidate matching with application tracking, resume-grounded chat, and an agent activity dashboard. The primary workflow collects and stores jobs, evaluates fit through filtering, analysis, matching, and strategy, then exposes results for candidate review. Chat separately routes a user request, selects tools, retrieves relevant profile or resume data, and returns a response. The README documents several workflows whose implementation files were not sampled; those links are marked unverified rather than inferred as source-level calls.
Main entry points: AgentCoordinator.java Agent coordinator · ChatService.java Chat orchestration · JobRepository.java Job repository · App.jsx Dashboard
Components 31
Job discovery
- Job ingestion
src/main/java/com.fangyao.agent/JobIngestionService.java - Source adapters
src/main/java/com.fangyao.agent
Matching workflow
- Agent coordinator
src/main/java/com.fangyao.agent/AgentCoordinator.java - Pre-filter
src/main/java/com.fangyao.agent/PreFilterAgent.java - Job analysis
src/main/java/com.fangyao.agent/JobAnalysisAgent.java - Candidate match
src/main/java/com.fangyao.agent/MatchAgent.java - Application strategy
src/main/java/com.fangyao.agent/StrategyAgent.java
Candidate services
- Candidate profile
src/main/java/com.fangyao.agent/CandidateProfile.java - Resume processing
src/main/java/com.fangyao.agent/ResumeService.java - Resume chunks
src/main/java/com.fangyao.agent/ResumeChunkService.java - Embedding service
src/main/java/com.fangyao.agent/EmbeddingService.java - Resume retrieval
src/main/java/com.fangyao.agent/ResumeRagService.java - Chat orchestration
src/main/java/com.fangyao.agent/ChatService.java - Intent router
src/main/java/com.fangyao.agent/JevIntentRouter.java - Chat tools
src/main/java/com.fangyao.agent/ChatToolService.java - Email delivery
src/main/java/com.fangyao.agent/EmailService.java
API and persistence
- Job records
src/main/java/com.fangyao.agent/Job.java - Job repository
src/main/java/com.fangyao.agent/JobRepository.java - Agent results
src/main/java/com.fangyao.agent/JobAgentResultRepository.java - Profile repository
src/main/java/com.fangyao.agent/CandidateProfileRepository.java - Resume chunk store
src/main/java/com.fangyao.agent/ResumeChunkRepository.java - Chat endpoint
src/main/java/com.fangyao.agent/ChatController.java - Conversation store
src/main/java/com.fangyao.agent/ChatConversationRepository.java - Message and trace store
src/main/java/com.fangyao.agent/ChatMessageRepository.java - Job API
src/main/java/com.fangyao.agent/JobController.java
Candidate interface
- Chat interface
frontend/src/components/Chat.jsx - Dashboard
frontend/src/App.jsx - Agent insights
frontend/src/components/AgentInsights.jsx
Other components
- Candidate
- Job sources
- OpenAI
Connections 36
- Candidate → Chat interface: asks
README.md - Chat interface → Chat endpoint: sends chat
- Chat endpoint → Chat orchestration: delegates to
src/main/java/com.fangyao.agent/ChatController.java - Chat orchestration → Intent router: routes intent
src/main/java/com.fangyao.agent/ChatService.java - Chat orchestration → Chat tools: executes tools
src/main/java/com.fangyao.agent/ChatService.java - Chat orchestration → Resume retrieval: retrieves resume
src/main/java/com.fangyao.agent/ChatService.java - Chat orchestration → Conversation store: loads conversations
src/main/java/com.fangyao.agent/ChatService.java - Chat orchestration → Message and trace store: persists messages
src/main/java/com.fangyao.agent/ChatService.java - Chat orchestration → OpenAI: reasons with
- Chat tools → Job repository: reads jobs
src/main/java/com.fangyao.agent/ChatToolService.java - Chat tools → Profile repository: reads profile
src/main/java/com.fangyao.agent/ChatToolService.java - Candidate → Dashboard: reviews results
README.md - Dashboard → Chat interface: renders
frontend/src/App.jsx - Dashboard → Agent insights: renders
frontend/src/App.jsx - Dashboard → Job API: loads job data
- Agent insights → Candidate: shows activity
- Job sources → Source adapters: provides postings
- Source adapters → Job ingestion: supplies jobs
src/main/java/com.fangyao.agent/JobIngestionService.java - Job ingestion → Job repository: stores postings
- Job repository → Job records: maps records
src/main/java/com.fangyao.agent/JobRepository.java - Job repository → Agent coordinator: provides jobs
- Agent coordinator → Pre-filter: filters jobs
- Agent coordinator → Job analysis: analyzes jobs
- Agent coordinator → Candidate match: scores fit
- Agent coordinator → Application strategy: plans applications
- Agent coordinator → Agent results: persists results
- Profile repository → Candidate profile: maps profile
src/main/java/com.fangyao.agent/CandidateProfileRepository.java - Candidate → Resume processing: uploads resume
- Resume processing → Resume chunks: chunks text
src/main/java/com.fangyao.agent/ResumeService.java - Resume chunks → Embedding service: embeds chunks
src/main/java/com.fangyao.agent/ResumeChunkService.java - Resume chunks → Resume chunk store: stores chunks
src/main/java/com.fangyao.agent/ResumeChunkService.java - Resume retrieval → Embedding service: embeds query
src/main/java/com.fangyao.agent/ResumeRagService.java - Resume retrieval → Resume chunk store: searches vectors
src/main/java/com.fangyao.agent/ResumeRagService.java - Embedding service → OpenAI: requests embeddings
src/main/java/com.fangyao.agent/EmbeddingService.java - Job API → Job repository: reads jobs
src/main/java/com.fangyao.agent/JobController.java - Agent coordinator → Email delivery: sends updates