How phucnguyenthanh04/telesale-sudocode2026 works
TeleSale combines a text sales-assistant workflow with voice access and a managed, reviewable knowledge base. A customer or operator reaches the backend, which forwards chat turns to the AI service; its harness runs an agent and invokes business capabilities through MCP. In parallel, knowledge evidence is ingested, reviewed and published for retrieval. The README documents four MCP services and speech capabilities, but excerpts do not expose every wiring detail, so uncertain runtime links are omitted. This map focuses on product runtime, not evaluation tooling.
Main entry points: gateway.py MCP gateway · runtime.py Agent harness · knowledge.py Policy retrieval · text.py Chat route
Components 24
User interaction
- Backend API
backend/app/main.py - Chat route
backend/app/api/text.py - Web client
frontend/chat.js - Voice gateway
backend/app/voice_main.py
AI conversation
- AI chat API
ai-services/app/api/chat.py - Chat turn
ai-services/app/agent/chat.py - Agent harness
ai-services/app/agent/harness/runtime.py - Guardrails
ai-services/app/agent/guardrails/checks.py - MCP gateway
ai-services/app/agent/mcp/gateway.py
Business MCP
- Catalog tools
ai-services/app/mcp_servers/mcp_catalog/tools/handlers.py - Order tools
ai-services/app/mcp_servers/mcp_order/tools/handlers.py - Memory service
ai-services/app/mcp_servers/mcp_memory/server.py
Knowledge lifecycle
- Knowledge API
ai-services/app/api/knowledge.py - Evidence events
ai-services/app/knowledge/events/ingest.py - Knowledge worker
ai-services/app/knowledge/events/worker.py - Review and release
ai-services/app/knowledge/services - Knowledge MCP
ai-services/app/mcp_servers/mcp_knowledge/server.py - Policy retrieval
ai-services/app/mcp_servers/mcp_knowledge/services/knowledge.py - Hybrid index
ai-services/app/mcp_servers/mcp_knowledge/repos/qdrant.py - Policy database
ai-services/app/knowledge/repos/postgres.py
Speech
- Speech API
speech/serving/app.py - Speech service
backend/app/services/voice_speech.py
Other components
- Customer / operator
- BTC source data
Connections 23
- Customer / operator → Web client: uses
README.md - Web client → Chat route: submits turns
- Backend API → Chat route: routes chat
backend/app/main.py - Chat route → AI chat API: forwards turns
README.md - AI chat API → Chat turn: calls
ai-services/app/api/chat.py - Chat turn → Agent harness: runs turn
ai-services/app/api/chat.py - Agent harness → Guardrails: checks
- Agent harness → MCP gateway: invokes tools
- MCP gateway → Catalog tools: dispatches
- MCP gateway → Order tools: dispatches
- MCP gateway → Memory service: dispatches
- MCP gateway → Knowledge MCP: dispatches
- Knowledge API → Evidence events: records evidence
- Evidence events → Knowledge worker: queues work
- Knowledge worker → Review and release: processes lifecycle
- Review and release → Policy database: persists releases
- Knowledge MCP → Policy retrieval: creates service
ai-services/app/mcp_servers/mcp_knowledge/server.py - Policy retrieval → Hybrid index: queries index
- Policy retrieval → Policy database: reads policy
- BTC source data → Evidence events: supplies evidence
- Customer / operator → Voice gateway: starts voice
- Voice gateway → Speech service: requests speech
- Speech service → Speech API: calls speech endpoint