How 522blackcat/knowledgeops-console works
KnowledgeOps Console is a web console and backend for configuring Agents, managing knowledge bases, running conversations, approving risky actions, and evaluating retrieval. A user works through the Vue console and FastAPI routes; Agent and RAG workers perform long-running tasks separately. PostgreSQL holds durable business state, Redis coordinates notifications and queues, and Qdrant stores vectors. The graph preserves the documented evaluation and administration branches. Some route and worker internals were not excerpted, so connections without direct evidence are omitted.
Main entry points: main.py FastAPI app · agent/worker.py Agent worker · retrieval.py Hybrid retrieval · rag/worker.py Ingest worker
Components 34
Console and API
- Vue console
frontend/src/App.vue - FastAPI app
app/main.py - Authentication
app/auth_api.py - Admin APIs
app/admin_api.py - Agent APIs
app/agent_api.py - Run APIs
app/run_api.py - Approval APIs
app/approval_api.py - Run event stream
app/sse_api.py
Agent runtime
- Agent worker
agent/worker.py - Agent graph
agent/graph.py - Run completion
agent/completion.py - Approval logic
agent/approval.py
Knowledge and RAG
- Knowledge APIs
app/knowledge_api.py - RAG eval API
app/rag_eval_api.py - Eval runner
evaluation/rag_eval_runner.py - Ingest worker
rag/worker.py - Document parser
rag/parser.py - Upload storage
rag/storage.py - Chunking
rag/chunking.py - Hybrid retrieval
rag/retrieval.py - BM25 search
rag/bm25.py - Qdrant vector store
rag/vector_store.py - Embeddings
rag/embedding.py - Reranker
rag/reranker.py
State and memory
- PostgreSQL
infrastructure/database.py - Domain records
infrastructure/models.py - Redis coordination
infrastructure/redis_client.py - Conversation memory
memory/context.py - Incremental summaries
memory/summary.py
Tools and models
- Tool execution
tools/execution.py - Tool registry
tools/registry.py - Built-in tools
tools/builtin.py - MCP tools
tools/mcp_registry.py
Other components
- Console user
Connections 39
- Console user → Vue console: uses
README.md - Vue console → FastAPI app: accesses
README.md - FastAPI app → Authentication: registers
app/main.py - FastAPI app → Admin APIs: registers
app/main.py - FastAPI app → Agent APIs: registers
app/main.py - FastAPI app → Run APIs: registers
app/main.py - FastAPI app → Approval APIs: registers
app/main.py - FastAPI app → Run event stream: registers
app/main.py - FastAPI app → Knowledge APIs: registers
app/main.py - FastAPI app → RAG eval API: registers
app/main.py - Agent worker → Agent graph: invokes
agent/worker.py - Agent worker → Run completion: uses
agent/worker.py - Agent worker → Approval logic: uses
agent/worker.py - Agent worker → Conversation memory: builds context
agent/worker.py - Agent worker → Hybrid retrieval: retrieves evidence
agent/worker.py - Agent graph → Tool execution: executes tools
agent/graph.py - Agent graph → Tool registry: loads tools
agent/graph.py - Agent worker → Redis coordination: checks cancellation
agent/worker.py - Agent worker → PostgreSQL: claims tasks
agent/worker.py - Ingest worker → Document parser: parses documents
rag/worker.py - Ingest worker → Chunking: prepares chunks
rag/worker.py - Ingest worker → Upload storage: uses upload storage
rag/worker.py - Ingest worker → Qdrant vector store: indexes vectors
rag/worker.py - RAG eval API → Hybrid retrieval: runs hybrid search
app/rag_eval_api.py - RAG eval API → BM25 search: runs lexical search
app/rag_eval_api.py - Hybrid retrieval → BM25 search: searches chunks
rag/retrieval.py - Hybrid retrieval → Embeddings: embeds query
rag/retrieval.py - Hybrid retrieval → Qdrant vector store: searches vectors
rag/retrieval.py - Hybrid retrieval → Reranker: reranks hits
rag/retrieval.py - Conversation memory → Incremental summaries: loads summaries
memory/context.py - Conversation memory → PostgreSQL: reads memory
memory/context.py - Incremental summaries → PostgreSQL: stores versions
memory/summary.py - Incremental summaries → Domain records: uses records
memory/summary.py - Tool execution → Tool registry: validates tools
tools/execution.py - Built-in tools → Hybrid retrieval: searches knowledge
tools/builtin.py - Agent graph → MCP tools: loads MCP tools
agent/worker.py - Eval runner → Hybrid retrieval: evaluates retrieval
README.md - PostgreSQL → Domain records: maps records
infrastructure/models.py - Agent worker → Redis coordination: coordinates work
README.md