How ananya-0607/telecom-support-assistant works
This is a local telecom-support resolution workspace: an agent submits a complaint, the backend classifies it, retrieves evidence, and drafts cited actions and questions for agent review. A separate knowledge-update path accepts tickets or PDFs and publishes searchable updates. The graph preserves documented evaluation and monitoring capabilities. Some subsystem links rely on the README or SOURCE INDEX; unsampled implementation details and unshown runtime wiring are not inferred.
Main entry points: additions.py Knowledge update jobs · api.py FastAPI backend · pipeline.py Resolution pipeline · service.py Evidence retrieval
Components 26
Agent workspace
- Streamlit workspace
app.py - FastAPI backend
src/telecom_support/api.py
Resolution workflow
- Resolution pipeline
src/telecom_support/pipeline.py - Label taxonomy
src/telecom_support/taxonomy.py - Complaint classification
src/telecom_support/classification/service.py - Classification schema
src/telecom_support/classification/schemas.py - Evidence retrieval
src/telecom_support/retrieval/service.py - Semantic search
src/telecom_support/retrieval/semantic.py - Keyword ranking
src/telecom_support/retrieval/keyword.py - Rank fusion
src/telecom_support/retrieval/ranking.py - Grounded generation
src/telecom_support/generation/service.py - Citation validation
src/telecom_support/generation/validation.py
Knowledge and indexing
- Knowledge update jobs
src/telecom_support/ingestion/additions.py - PDF extraction
src/telecom_support/ingestion/pdf.py - Passage chunking
src/telecom_support/ingestion/chunking.py - Passage labeling
src/telecom_support/ingestion/metadata.py - Evidence records
src/telecom_support/ingestion/schemas.py - Text embeddings
src/telecom_support/indexing/embeddings.py - Qdrant vectors
src/telecom_support/indexing/vectors.py - Index records
src/telecom_support/indexing/records.py - SQLite evidence store
src/telecom_support/indexing/storage.py
Operations and evaluation
- Metrics and safe logs
src/telecom_support/monitoring.py - RAG evaluation
src/telecom_support/evaluation/rag.py - Classification evaluation
src/telecom_support/evaluation/classification.py
Other components
- Support agent
- Groq inference
src/telecom_support/llm.py
Connections 31
- Support agent → Streamlit workspace: submits complaint
- Streamlit workspace → FastAPI backend: sends requests
- FastAPI backend → Resolution pipeline: invokes
src/telecom_support/api.py - Resolution pipeline → Complaint classification: classifies
src/telecom_support/pipeline.py - Resolution pipeline → Evidence retrieval: retrieves evidence
src/telecom_support/pipeline.py - Resolution pipeline → Grounded generation: drafts resolution
src/telecom_support/pipeline.py - Resolution pipeline → Passage chunking: checks token count
src/telecom_support/pipeline.py - Resolution pipeline → Label taxonomy: reads taxonomy
src/telecom_support/pipeline.py - Complaint classification → Classification schema: validates output
src/telecom_support/classification/service.py - Complaint classification → Label taxonomy: uses labels
src/telecom_support/classification/service.py - Complaint classification → Groq inference: requests structured output
src/telecom_support/pipeline.py - Evidence retrieval → Semantic search: searches semantically
src/telecom_support/retrieval/service.py - Evidence retrieval → Keyword ranking: ranks keywords
src/telecom_support/retrieval/service.py - Evidence retrieval → Rank fusion: combines ranks
src/telecom_support/retrieval/service.py - Evidence retrieval → SQLite evidence store: fetches evidence
src/telecom_support/retrieval/service.py - Semantic search → Qdrant vectors: queries vectors
src/telecom_support/retrieval/semantic.py - Grounded generation → Citation validation: checks citations
src/telecom_support/generation/service.py - Grounded generation → Groq inference: requests grounded draft
src/telecom_support/generation/service.py - FastAPI backend → Knowledge update jobs: submits updates
src/telecom_support/api.py - Knowledge update jobs → PDF extraction: extracts PDF text
src/telecom_support/ingestion/additions.py - Knowledge update jobs → Passage chunking: chunks passages
src/telecom_support/ingestion/additions.py - Knowledge update jobs → Passage labeling: labels passages
src/telecom_support/ingestion/additions.py - Knowledge update jobs → Index records: builds records
src/telecom_support/ingestion/additions.py - Knowledge update jobs → SQLite evidence store: publishes records
src/telecom_support/ingestion/additions.py - Knowledge update jobs → Qdrant vectors: publishes vectors
src/telecom_support/ingestion/additions.py - Knowledge update jobs → Label taxonomy: updates labels
src/telecom_support/ingestion/additions.py - Index records → Evidence records: validates records
src/telecom_support/indexing/records.py - FastAPI backend → Metrics and safe logs: records metrics
src/telecom_support/api.py - FastAPI backend → RAG evaluation: supports evaluation runs
- FastAPI backend → Classification evaluation: supports evaluation runs
- Support agent → RAG evaluation: reviews quality reports