How kakuibeyond/talent-eval-agents works
This is a multi-agent talent evaluation and recommendation system, with a document evidence library and evidence-search workbench as its current user-facing workflow. Users manage employee profiles and knowledge-base documents; uploaded files are stored, parsed, chunked and indexed, then retrieved under tenant and permission filters. Natural-language talent searches compile into controlled candidate filters and evidence retrieval. The README also describes evidence packs, citation display and talent-decision workflows. Some graph links are limited to README statements or source-index references because not all implementation excerpts were provided.
Main entry points: api.py FastAPI Routes · services.py Upload and Parse · worker.py Background Worker · talent_decision_engine.py Decision Orchestrator
Components 25
User Experience
- Application UI
frontend/src/main.tsx - Evidence Panel
frontend/src/EvidencePackPanel.tsx - FastAPI Routes
backend/app/api.py
Document Evidence
- Talent and Document Records
backend/app/models.py - Upload and Parse
backend/app/services.py - Document Parsers
backend/app/document_parsers.py - MinerU Parser
backend/app/mineru_client.py - Document Pipeline
backend/app/document_pipeline.py - Background Worker
backend/app/worker.py - Chunk Creation
backend/app/chunk_service.py - PostgreSQL
backend/app/database.py - File Object Store
backend/app/object_store.py
Search and Evidence
- Evidence Indexing
backend/app/evidence_index_service.py - Model Provider
backend/app/model_provider.py - Milvus Evidence Index
backend/app/milvus_store.py - Hybrid Evidence Search
backend/app/hybrid_search_service.py - Query Planning
backend/app/query_plan.py - Evidence Pack
backend/app/evidence_pack.py - Citation Resolution
backend/app/evidence_citations.py
Talent Decisions
- Decision Orchestrator
backend/app/talent_decision_engine.py - Talent Request Graph
backend/app/talent_request_graph.py - Evaluation Runtime
backend/app/talent_evaluation_runtime.py - Evaluation Dispatch
backend/app/talent_evaluation_dispatch.py - Evaluation Report
backend/app/talent_evaluation_report.py
Other components
- Talent User
Connections 25
- Talent User → Application UI: uses
README.md - Application UI → FastAPI Routes: requests
- Application UI → Evidence Panel: renders
frontend/src/main.tsx - FastAPI Routes → Talent and Document Records: reads and writes
backend/app/api.py - FastAPI Routes → Upload and Parse: uploads and parses
backend/app/api.py - Upload and Parse → File Object Store: stores files
backend/app/services.py - Upload and Parse → Document Parsers: parses documents
backend/app/services.py - Upload and Parse → MinerU Parser: fallback parses
backend/app/services.py - Background Worker → Document Pipeline: consumes jobs
backend/app/worker.py - Document Pipeline → Chunk Creation: creates chunks
backend/app/document_pipeline.py - Background Worker → Upload and Parse: runs parsing
backend/app/worker.py - Background Worker → Evidence Indexing: runs indexing
backend/app/worker.py - Chunk Creation → File Object Store: reads parse output
backend/app/chunk_service.py - Upload and Parse → PostgreSQL: persists records
- Evidence Indexing → Model Provider: embeds chunks
backend/app/evidence_index_service.py - Evidence Indexing → Milvus Evidence Index: writes vectors
backend/app/evidence_index_service.py - FastAPI Routes → Query Planning: plans searches
backend/app/api.py - FastAPI Routes → Hybrid Evidence Search: runs retrieval
backend/app/api.py - Hybrid Evidence Search → Milvus Evidence Index: hybrid searches
backend/app/hybrid_search_service.py - FastAPI Routes → Evidence Pack: builds evidence
backend/app/api.py - FastAPI Routes → Citation Resolution: resolves citations
backend/app/api.py - Decision Orchestrator → Talent Request Graph: dispatches request
backend/app/talent_decision_engine.py - Decision Orchestrator → Evaluation Runtime: dispatches evaluation
backend/app/talent_decision_engine.py - Decision Orchestrator → Evaluation Report: dispatches report
backend/app/talent_decision_engine.py - Evaluation Runtime → Evaluation Dispatch: uses dispatch
backend/app/talent_evaluation_runtime.py