# azure-samples/voicelive-api-salescoach architecture

> Architecture diagram of the GitHub repository azure-samples/voicelive-api-salescoach, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure-samples/voicelive-api-salescoach
- Repository: https://github.com/azure-samples/voicelive-api-salescoach

## Overview

Voice Live API Sales Coach is a browser-based sales-practice application. Users choose or create a scenario, start a voice conversation with an AI customer, and review performance and pronunciation feedback. The frontend manages scenario selection, audio capture, realtime messaging, and results; the Flask backend provides scenario and agent APIs, proxies voice sessions, and performs analysis. The README documents Azure AI and Speech integrations, including optional Foundry agents. Some backend route wiring and frontend audio internals were not sampled, so uncertain links are omitted.

Main entry points: [`frontend/src/app/App.tsx`](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/app/App.tsx) (Practice interface), [`backend/src/app.py`](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/app.py) (Flask API), [`backend/src/services/analyzers.py`](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/analyzers.py) (Conversation analysis), [`frontend/src/services/api.ts`](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/services/api.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Practice frontend"]
  node_app["Practice interface<br/>[App.tsx]"]
  node_scenario_ui["Scenario selection<br/>[ScenarioList.tsx]"]
  node_custom_editor["Scenario editor"]
  node_scenario_hook["Scenario state<br/>[useScenarios.ts]"]
  node_custom_storage[("Custom scenarios<br/>[customScenarios.ts]")]
  node_api["HTTP client<br/>[api.ts]"]
  node_recorder["Audio capture<br/>[useRecorder.ts]"]
  node_realtime["Realtime client<br/>[useRealtime.ts]"]
  node_chat["Conversation display<br/>[ChatPanel.tsx]"]
  node_video["Avatar display<br/>[VideoPanel.tsx]"]
  node_assessment_ui["Assessment panel"]
end

subgraph group_backend["Application backend"]
  node_flask["Flask API<br/>[app.py]"]
  node_config["Runtime configuration<br/>[config.py]"]
  node_managers["Scenario and agent management<br/>[managers.py]"]
  node_graph_generator["Graph scenario generation"]
  node_analyzers["Conversation analysis<br/>[analyzers.py]"]
  node_scenario_utils["Scenario utilities<br/>[scenario_utils.py]"]
  node_ws_handler["Voice session proxy"]
end

subgraph group_ai["AI services"]
  node_voice_live["Azure Voice Live"]
  node_azure_ai["Azure AI models"]
  node_speech["Azure Speech"]
end

node_trainee(("Sales trainee"))

node_trainee -->|"practices in"| node_app
node_app -->|"renders"| node_scenario_ui
node_app -->|"renders"| node_chat
node_app -->|"renders"| node_video
node_app -->|"starts session"| node_realtime
node_app -->|"shows feedback"| node_assessment_ui
node_scenario_ui -->|"opens"| node_custom_editor
node_app -->|"loads scenarios"| node_scenario_hook
node_scenario_hook -->|"fetches scenarios"| node_api
node_scenario_hook -->|"manages locally"| node_custom_storage
node_custom_editor -->|"edits scenarios"| node_custom_storage
node_scenario_ui -->|"requests scenarios"| node_api
node_api -->|"calls API"| node_flask
node_flask -->|"uses managers"| node_managers
node_flask -->|"runs analysis"| node_analyzers
node_flask -->|"routes voice socket"| node_ws_handler
node_managers -->|"uses generator"| node_graph_generator
node_analyzers -->|"uses utilities"| node_scenario_utils
node_ws_handler -->|"looks up agent"| node_managers
node_realtime -->|"streams messages"| node_ws_handler
node_recorder -.->|"provides audio"| node_realtime
node_ws_handler -->|"proxies session"| node_voice_live
node_analyzers -->|"scores conversation"| node_azure_ai
node_analyzers -->|"assesses pronunciation"| node_speech
node_managers -.->|"creates optional agents"| node_azure_ai
node_api -.->|"returns assessment"| node_assessment_ui

click node_app "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/app/App.tsx"
click node_scenario_ui "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/ScenarioList.tsx"
click node_custom_editor "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/CustomScenarioEditor.tsx"
click node_scenario_hook "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useScenarios.ts"
click node_custom_storage "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/services/customScenarios.ts"
click node_api "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/services/api.ts"
click node_recorder "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useRecorder.ts"
click node_realtime "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useRealtime.ts"
click node_chat "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/ChatPanel.tsx"
click node_video "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/VideoPanel.tsx"
click node_assessment_ui "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/AssessmentPanel.tsx"
click node_flask "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/app.py"
click node_config "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/config.py"
click node_managers "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/managers.py"
click node_graph_generator "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/graph_scenario_generator.py"
click node_analyzers "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/analyzers.py"
click node_scenario_utils "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/scenario_utils.py"
click node_ws_handler "https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/websocket_handler.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_scenario_ui,node_custom_editor,node_scenario_hook,node_custom_storage,node_api,node_recorder,node_realtime,node_chat,node_video,node_assessment_ui toneBlue
class node_flask,node_config,node_managers,node_graph_generator,node_analyzers,node_scenario_utils,node_ws_handler toneAmber
class node_voice_live,node_azure_ai,node_speech toneMint
class node_trainee toneIndigo
```

## Components

### Practice frontend

- [Practice interface](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/app/App.tsx): `frontend/src/app/App.tsx`
- [Scenario selection](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/ScenarioList.tsx): `frontend/src/components/ScenarioList.tsx`
- [Scenario editor](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/CustomScenarioEditor.tsx): `frontend/src/components/CustomScenarioEditor.tsx`
- [Scenario state](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useScenarios.ts): `frontend/src/hooks/useScenarios.ts`
- [Custom scenarios](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/services/customScenarios.ts): `frontend/src/services/customScenarios.ts`
- [HTTP client](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Audio capture](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useRecorder.ts): `frontend/src/hooks/useRecorder.ts`
- [Realtime client](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/hooks/useRealtime.ts): `frontend/src/hooks/useRealtime.ts`
- [Conversation display](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/ChatPanel.tsx): `frontend/src/components/ChatPanel.tsx`
- [Avatar display](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/VideoPanel.tsx): `frontend/src/components/VideoPanel.tsx`
- [Assessment panel](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/frontend/src/components/AssessmentPanel.tsx): `frontend/src/components/AssessmentPanel.tsx`

### Application backend

- [Flask API](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/app.py): `backend/src/app.py`
- [Runtime configuration](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/config.py): `backend/src/config.py`
- [Scenario and agent management](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/managers.py): `backend/src/services/managers.py`
- [Graph scenario generation](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/graph_scenario_generator.py): `backend/src/services/graph_scenario_generator.py`
- [Conversation analysis](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/analyzers.py): `backend/src/services/analyzers.py`
- [Scenario utilities](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/scenario_utils.py): `backend/src/services/scenario_utils.py`
- [Voice session proxy](https://github.com/azure-samples/voicelive-api-salescoach/blob/main/backend/src/services/websocket_handler.py): `backend/src/services/websocket_handler.py`

### AI services

- **Azure Voice Live**
- **Azure AI models**
- **Azure Speech**

### Other components

- **Sales trainee**

## Connections

- Sales trainee → Practice interface: practices in (evidence: `README.md`)
- Practice interface → Scenario selection: renders (evidence: `frontend/src/app/App.tsx`)
- Practice interface → Conversation display: renders (evidence: `frontend/src/app/App.tsx`)
- Practice interface → Avatar display: renders (evidence: `frontend/src/app/App.tsx`)
- Practice interface → Realtime client: starts session (evidence: `frontend/src/app/App.tsx`)
- Practice interface → Assessment panel: shows feedback (evidence: `README.md`)
- Scenario selection → Scenario editor: opens (evidence: `frontend/src/components/ScenarioList.tsx`)
- Practice interface → Scenario state: loads scenarios (evidence: `frontend/src/app/App.tsx`)
- Scenario state → HTTP client: fetches scenarios (evidence: `frontend/src/hooks/useScenarios.ts`)
- Scenario state → Custom scenarios: manages locally (evidence: `frontend/src/hooks/useScenarios.ts`)
- Scenario editor → Custom scenarios: edits scenarios (evidence: `frontend/src/components/CustomScenarioEditor.tsx`)
- Scenario selection → HTTP client: requests scenarios (evidence: `frontend/src/components/ScenarioList.tsx`)
- HTTP client → Flask API: calls API (evidence: `frontend/src/services/api.ts`)
- Flask API → Scenario and agent management: uses managers (evidence: `backend/src/app.py`)
- Flask API → Conversation analysis: runs analysis (evidence: `backend/src/app.py`)
- Flask API → Voice session proxy: routes voice socket (evidence: `backend/src/app.py`)
- Scenario and agent management → Graph scenario generation: uses generator (evidence: `backend/src/services/managers.py`)
- Conversation analysis → Scenario utilities: uses utilities (evidence: `backend/src/services/analyzers.py`)
- Voice session proxy → Scenario and agent management: looks up agent (evidence: `backend/src/services/websocket_handler.py`)
- Realtime client → Voice session proxy: streams messages (evidence: `README.md`)
- Audio capture → Realtime client: provides audio
- Voice session proxy → Azure Voice Live: proxies session (evidence: `README.md`)
- Conversation analysis → Azure AI models: scores conversation (evidence: `README.md`)
- Conversation analysis → Azure Speech: assesses pronunciation (evidence: `README.md`)
- Scenario and agent management → Azure AI models: creates optional agents (evidence: `README.md`)
- HTTP client → Assessment panel: returns assessment
