Modularized agents, added Streamlit UI, improved README for tutorial review

Author: cyberholics

a2a_customer_routing/README.md

@@ -2,25 +2,25 @@
 
 A customer support system built with distributed AI agents using the A2A (Agent-to-Agent) protocol and Google's Agent Development Kit (ADK). The system intelligently routes customer inquiries based on sentiment analysis and provides automated responses through knowledge base search or human escalation.
 
-##  System Architecture
+## System Architecture
 
 ```
 User Message → Coordinator Agent → Sentiment Analysis → Routing Decision
-                                                    ↓
-                                     ┌─────────────────────────────┐
-                                     │                             │
-                              Negative Sentiment            Positive/Neutral
-                                     │                             │
-                                     ↓                             ↓
-                            Escalation Agent                Resolution Agent
-                          (Human Handoff)                 (Knowledge Base Search)
-                                     │                             │
-                                     └─────────────────────────────┘
-                                                    ↓
-                                            Final Response to User
+                                                     ↓
+                                      ┌─────────────────────────────┐
+                                      │                             │
+                               Negative Sentiment            Positive/Neutral
+                                      │                             │
+                                      ↓                             ↓
+                             Escalation Agent                Resolution Agent
+                           (Human Handoff)                 (Knowledge Base Search)
+                                      │                             │
+                                      └─────────────────────────────┘
+                                                     ↓
+                                             Final Response to User
 ```
 
-##  Agent Overview
+## Agent Overview
 
 | Agent | Port | Purpose | Technology |
 |-------|------|---------|------------|
@@ -36,39 +36,60 @@ User Message → Coordinator Agent → Sentiment Analysis → Routing Decision
 - **Human Escalation**: Automatic escalation for negative sentiment cases
 - **Distributed Architecture**: Each agent runs independently via A2A protocol
 - **Scalable Design**: Easy to add new agents or modify existing ones
+- **Interactive UI**: Streamlit-based web interface for easy interaction
 
-##  Prerequisites
+## Prerequisites
 
 - Python 3.8+
 - API access to Nebius AI models
 - Required Python packages (see requirements.txt)
 
-##  How to Run
+## Project Structure
+
+```
+a2a_customer_routing/
+├── knowledge_base/
+│   └── swiftcart_kb.json
+├── multi_agent/
+│   ├── __init__.py
+│   ├── agent.py
+│   ├── run_agents.py
+│   └── tools.py
+├── README.md
+├── requirements.txt
+└── streamlit_app.py
+```
+
+## How to Run
 
 1. **Clone the repository**
-   ```
+   ```bash
    git clone https://github.com/Astrodevil/ADK-Agent-Examples.git
-   cd ADK-Agent-Examples/"A2A Customer Query Routing and Resolution"
+   cd ADK-Agent-Examples/a2a_customer_routing
    ```
 
 2. **Install dependencies**
-   ```
+   ```bash
    pip install -r requirements.txt
    ```
 
 3. **Set up environment variables**
-   ```
+   ```bash
    cp .env.example .env
    # Edit .env with your API credentials
    ```
 
 4. **Run the multi-agent system**
-   ```
-   python multi_agent/agent.py
+   ```bash
+   python -m a2a_customer_routing.multi_agent.run_agents
    ```
 
+5. **Launch the Streamlit interface** (in a separate terminal)
+   ```bash
+   streamlit run a2a_customer_routing/streamlit_app.py
+   ```
 
-##  Workflow Examples
+## Workflow Examples
 
 ### Positive/Neutral Sentiment Flow
 ```
@@ -78,7 +99,7 @@ Coordinator → Intake Agent → "neutral"
 ↓
 Coordinator → Resolution Agent → KB Search
 ↓
-Response: " "
+Response: "You can track your order by..."
 ```
 
 ### Negative Sentiment Flow
@@ -89,23 +110,26 @@ Coordinator → Intake Agent → "negative"
 ↓
 Coordinator → Escalation Agent → Human Escalation
 ↓
-Response: " "
+Response: "I understand your frustration. A human agent will contact you shortly..."
 ```
 
-##  System Components
+## System Components
 
 ### Core Classes
 
 - **`KB`**: Knowledge base management with LlamaIndex integration
 - **`ADKAgentExecutor`**: Wrapper for Google ADK agents to work with A2A protocol
 - **`A2AToolClient`**: Client for agent-to-agent communication
 
-
 ### Agent Tools
 
 - **`resolve_query_fn`**: Searches knowledge base for answers
 - **`classify_fn`**: Performs sentiment analysis
 - **`escalate_fn`**: Handles human escalation logging
 
+## Usage
 
-
+1. Start the multi-agent system using the run command
+2. Open the Streamlit interface in your browser
+3. Enter customer queries to see the intelligent routing in action
+4. Monitor the console output to see agent-to-agent communication