How bhanikki28/complaint-triage-copilot works
Complaint Triage Copilot accepts analyst complaints and returns a cited, confidence-scored recommendation, or abstains/escalates; high-risk cases pause for team-lead approval. The documented workflow passes through authenticated API handling, input guards, orchestration, classification and agent retrieval/forecast/risk work, then output validation and persistence. The README also documents MCP tool boundaries, A2A delegation, memory, and audit. Some subsystem details are documented but unsampled; their paths and links are included only where README or source-index references support them.
Main entry points: orchestrator.py Orchestrator · app.py FastAPI routes · db.py Postgres · server.py MCP tools
Components 24
API and access
- FastAPI routes
src/triage/api/app.py - JWT and RBAC
src/triage/api/rbac.py - Request controls
src/triage/api/middleware.py
Triage workflow
- Orchestrator
src/triage/agents/orchestrator.py - Input guards
src/triage/guards/injection.py - Pseudonymization
src/triage/guards/pseudonym.py - Complaint classifier
src/triage/agents/classifier.py - Output validation
src/triage/guards/output.py - PII redaction
src/triage/guards/redact.py - Runtime settings
src/triage/config.py
Agents and tools
- Retrieval agent
src/triage/agents/rag.py - Policy retriever
src/triage/agents/rag.py - Volume forecast
src/triage/agents/lstm.py - Forecast data
src/triage/timeseries.py - Risk assessment
src/triage/agents/risk.py - A2A client
src/triage/agents/a2a_client.py - A2A agent server
src/triage/agents/a2a_server.py - MCP client
src/triage/mcp_server/client.py - MCP tools
src/triage/mcp_server/server.py - LLM provider
src/triage/llm/factory.py
Persistence
- Memory and repositories
src/triage/memory/repositories.py - Data models
src/triage/memory/models.py - Postgres
src/triage/memory/db.py
Other components
- Analyst / lead
Connections 26
- Analyst / lead → FastAPI routes: submits case
README.md - FastAPI routes → Request controls: handles request
src/triage/api/app.py - FastAPI routes → JWT and RBAC: checks access
src/triage/api/app.py - FastAPI routes → Orchestrator: runs triage
src/triage/api/app.py - Orchestrator → Input guards: screens input
src/triage/agents/orchestrator.py - Orchestrator → Pseudonymization: pseudonymizes
src/triage/agents/orchestrator.py - Orchestrator → Complaint classifier: classifies case
src/triage/agents/orchestrator.py - Orchestrator → A2A client: delegates tasks
src/triage/agents/orchestrator.py - A2A client → A2A agent server: sends task
src/triage/agents/a2a_client.py - A2A agent server → MCP client: calls tools
src/triage/agents/services.py - Orchestrator → MCP client: accesses memory
src/triage/agents/orchestrator.py - MCP client → MCP tools: calls tools
src/triage/mcp_server/client.py - MCP tools → Policy retriever: searches policy
src/triage/mcp_server/server.py - Policy retriever → Postgres: reads chunks
- MCP tools → Volume forecast: gets forecast
src/triage/mcp_server/server.py - Volume forecast → Forecast data: uses series
src/triage/training.py - Orchestrator → Risk assessment: assesses risk
src/triage/agents/orchestrator.py - Orchestrator → Output validation: validates result
src/triage/agents/orchestrator.py - Output validation → PII redaction: redacts output
src/triage/guards/output.py - Orchestrator → LLM provider: builds agent
src/triage/agents/orchestrator.py - FastAPI routes → Memory and repositories: persists cases
src/triage/api/app.py - Memory and repositories → Data models: queries entities
src/triage/memory/repositories.py - FastAPI routes → Postgres: opens sessions
src/triage/api/app.py - Memory and repositories → Postgres: stores records
- Orchestrator → Postgres: checkpoints runs
README.md - Orchestrator → Runtime settings: reads settings
src/triage/agents/orchestrator.py