How bcefghj/ai-agent-interview-guide works
This repository combines AI Agent interview-preparation materials with three implementations of an enterprise customer-support and knowledge-assistant platform (Python, Java, and Go). The runtime workflow is user request → API → intent and agent orchestration → optional RAG and tool use → model response, supported by document ingestion, memory, model routing, and tracing. The graph uses Java for the best-evidenced request and ingestion flows, while retaining Python’s documented API and memory components; the README describes the three versions as parallel implementations. Unsampled subsystem links are documented at README level.
Main entry points: AgentOrchestrator.java Agent orchestrator · ETLPipeline.java Document ETL · ChatController.java Chat API · DocumentController.java Document API
Components 24
Request API
- Chat API
project-java/src/main/java/com/agent/platform/controller/ChatController.java - Document API
project-java/src/main/java/com/agent/platform/controller/DocumentController.java - Python API routes
project-python/app/api/routes/chat.py
Agent execution
- Intent recognition
project-java/src/main/java/com/agent/platform/service/intent/IntentRecognizer.java - Agent orchestrator
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - ReAct agent
project-java/src/main/java/com/agent/platform/service/agent/ReActAgent.java - Planner agent
project-java/src/main/java/com/agent/platform/service/agent/PlannerAgent.java - Reflection agent
project-java/src/main/java/com/agent/platform/service/agent/ReflectionAgent.java
Knowledge and tools
- Multi-retrieval
project-java/src/main/java/com/agent/platform/service/rag/MultiRetriever.java - Result reranking
project-java/src/main/java/com/agent/platform/service/rag/Reranker.java - RAG generation
project-java/src/main/java/com/agent/platform/service/rag/RAGGenerator.java - Document ETL
project-java/src/main/java/com/agent/platform/etl/ETLPipeline.java - Document parser
project-java/src/main/java/com/agent/platform/etl/DocumentParser.java - Document chunker
project-java/src/main/java/com/agent/platform/etl/DocumentChunker.java - Tool system
project-java/src/main/java/com/agent/platform/service/tool/ToolRouter.java
Runtime support
- Vector database
project-java/src/main/java/com/agent/platform/infrastructure/vectordb/MilvusService.java - Memory manager
project-java/src/main/java/com/agent/platform/service/memory/MemoryManager.java - Python memory manager
project-python/app/core/memory/manager.py - Redis cache
project-java/src/main/java/com/agent/platform/infrastructure/cache/RedisCacheService.java - Model routing
project-java/src/main/java/com/agent/platform/infrastructure/llm/ModelRouter.java - Request tracing
project-java/src/main/java/com/agent/platform/infrastructure/trace/TraceService.java
Other components
- User
- LLM provider
- Search tools
Connections 24
- User → Chat API: sends chat
README.md - Chat API → Agent orchestrator: calls chat
project-java/src/main/java/com/agent/platform/controller/ChatController.java - User → Document API: uploads document
README.md - Document API → Document ETL: processes upload
project-java/src/main/java/com/agent/platform/controller/DocumentController.java - Document ETL → Document parser: parses text
project-java/src/main/java/com/agent/platform/etl/ETLPipeline.java - Document ETL → Document chunker: chunks text
project-java/src/main/java/com/agent/platform/etl/ETLPipeline.java - Document ETL → Vector database: writes vectors
project-java/src/main/java/com/agent/platform/etl/ETLPipeline.java - Agent orchestrator → Intent recognition: recognizes intent
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Agent orchestrator → ReAct agent: dispatches mode
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Agent orchestrator → Planner agent: dispatches mode
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Agent orchestrator → Reflection agent: dispatches mode
README.md - Agent orchestrator → Multi-retrieval: retrieves context
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Agent orchestrator → Result reranking: reranks results
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Agent orchestrator → RAG generation: generates answer
README.md - Multi-retrieval → Vector database: searches vectors
README.md - Agent orchestrator → Tool system: routes tools
README.md - Tool system → Search tools: invokes search
README.md - Agent orchestrator → Memory manager: loads context
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Memory manager → Redis cache: stores history
README.md - Python memory manager → Redis cache: uses short memory
README.md - Agent orchestrator → Model routing: calls model
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Model routing → LLM provider: routes request
README.md - Agent orchestrator → Request tracing: records spans
project-java/src/main/java/com/agent/platform/service/agent/AgentOrchestrator.java - Python API routes → User: serves chat
README.md