How shreyaskowshal/intelligent-support-ticket-resolution-assistant works
This is an agent-facing telecom support assistant. An agent submits a complaint in the React workspace; FastAPI analyzes it, checks actionability, retrieves approved ticket and KB evidence for actionable issues, drafts a cited resolution, validates its citations, and returns the result for agent review. The graph also includes evidence maintenance and readiness reporting. README statements support several runtime relationships; source excerpts and the SOURCE INDEX support the implementation links. Unsampled internals are not expanded beyond documented capabilities.
Main entry points: api_service.py API services · App.tsx Workspace app · storage.py Support repository · analysis.py Complaint analysis
Components 19
Agent workspace
- Workspace app
frontend-react/src/App.tsx - Complaint form
frontend-react/src/components/ComplaintForm.tsx - Frontend API client
frontend-react/src/services/api.ts - Resolution draft
frontend-react/src/components/ResolutionDraft.tsx - Evidence panel
frontend-react/src/components/EvidencePanel.tsx - Backend status
frontend-react/src/hooks/useBackendStatus.ts
API orchestration
- FastAPI routes
backend/app/main.py - API services
backend/app/api_service.py
Analysis and resolution
- Complaint analysis
backend/app/analysis.py - Actionability check
backend/app/actionability.py - Semantic retrieval
backend/app/search.py - Cited draft and validation
backend/app/rag.py - LLM interface
backend/app/llm.py
Evidence and updates
- Support repository
backend/app/storage.py - Support record models
backend/app/models.py - Reviewed data ingestion
backend/app/ingestion.py - Taxonomy values
backend/app/taxonomy.py
Other components
- Support agent
- Gemini
Connections 23
- Support agent → Workspace app: enters complaint
README.md - Workspace app → Complaint form: renders
frontend-react/src/App.tsx - Workspace app → Frontend API client: submits through
frontend-react/src/App.tsx - Workspace app → Resolution draft: renders result
frontend-react/src/App.tsx - Workspace app → Evidence panel: renders evidence
frontend-react/src/App.tsx - Workspace app → Backend status: checks status
frontend-react/src/App.tsx - Frontend API client → FastAPI routes: sends requests
README.md - FastAPI routes → API services: routes requests
backend/app/main.py - API services → Complaint analysis: analyzes complaint
backend/app/api_service.py - API services → Actionability check: checks issue
backend/app/api_service.py - API services → Semantic retrieval: searches evidence
backend/app/api_service.py - API services → Cited draft and validation: generates draft
backend/app/api_service.py - API services → Reviewed data ingestion: updates evidence
backend/app/api_service.py - API services → Support repository: uses repository
backend/app/api_service.py - Complaint analysis → LLM interface: requests analysis
backend/app/analysis.py - Cited draft and validation → LLM interface: requests resolution
backend/app/rag.py - Semantic retrieval → Support repository: reads approved records
backend/app/search.py - Support repository → Support record models: validates records
backend/app/storage.py - Complaint analysis → Support repository: loads taxonomy
backend/app/analysis.py - Reviewed data ingestion → Support repository: writes reviewed data
backend/app/ingestion.py - Reviewed data ingestion → Semantic retrieval: refreshes indexes
backend/app/ingestion.py - LLM interface → Gemini: uses provider
- API services → Support agent: returns result
README.md