updated the readme files

README.md

@@ -16,13 +16,13 @@ This Hugging Face Space provides a Gradio interface to interact with the Integra
 
 ## Features
 
-- 🤖 **Autonomous MCP Agents** - Intelligent tool selection and execution
-- 📚 **Enterprise RAG System** - Multi-tenant knowledge base with semantic search
-- 🌐 **Live Web Search** - Real-time information retrieval
-- 🛡️ **Red-Flag Governance** - Automated safety monitoring and compliance
-- 🏢 **Multi-Tenant Isolation** - Strict tenant separation with secure access control
-- 📊 **Analytics Dashboard** - Comprehensive system insights and observability
-- 🔄 **Multi-Tool Selection** - Dynamic tool combinations (RAG + Web + LLM)
+- 🤖 **Autonomous MCP Agents** – Tool-aware FastAPI agent that plans across RAG, Web, Admin, and LLM actions
+- 📚 **Knowledge Base Ingestion** – Upload raw text, URLs, or documents (PDF/DOCX/TXT/MD) directly from the Gradio UI
+- 🛡️ **Admin Rules Management** – Dedicated tab to add/delete governance rules; all rules are persisted in SQLite for demo purposes
+- 📊 **Admin Analytics** – Snapshot of tenant activity, tool usage, red-flag triggers, and overall query volume
+- 🌐 **Live Web Search** – DuckDuckGo-based MCP server with English-biased results
+- 🏢 **Multi-Tenant Isolation** – Every request requires a tenant ID; backend enforces isolation for chat, ingestion, and admin ops
+- 🔄 **Multi-Tool Selection** – MCP agent orchestrator picks the right tool chain (RAG + Web + LLM, etc.)
 
 ---
 
@@ -30,11 +30,11 @@ This Hugging Face Space provides a Gradio interface to interact with the Integra
 
 ### Prerequisites
 
-1. **Backend Server Running**: The IntegraChat FastAPI backend must be running at `http://localhost:8000`
-   - See the [backend README](backend/README.md) for setup instructions
-   - The backend provides the MCP agent endpoint at `/agent/chat`
-
-2. **Python 3.10+** installed
+1. **Backend services running**:
+   - FastAPI API (`uvicorn backend.api.main:app --port 8000`)
+   - MCP servers (RAG 8001, Web 8002, Admin 8003) as described in `backend/README.md`
+   - Optional: Ollama / Groq credentials for the LLM client
+2. **Python 3.10+** with the dependencies in `requirements.txt`
 
 ### Installation
 
@@ -54,38 +54,28 @@ This Hugging Face Space provides a Gradio interface to interact with the Integra
 
 ### Usage
 
-1. Enter your **Tenant ID** in the textbox (e.g., `tenant123`)
-2. Type your message in the chat interface
-3. Click **Send** or press Enter
-4. The agent will process your message using MCP tools and respond
-
----
+The Gradio UI exposes four tabs once you launch `app.py`:
 
-## API Endpoint
+1. **Chat** – enter your Tenant ID, ask questions, and see multi-tool MCP responses.
+2. **Document Ingestion** – toggle between Raw Text, URL, or File Upload to populate the tenant RAG index.
+3. **Admin Analytics** – click “Fetch Analytics Snapshot” to view overview/tool-usage/red-flag/activity metrics.
+4. **Admin Rules & Compliance** – upload/delete governance rules that are stored via the backend `/admin/rules` API.
 
-The Gradio interface communicates with the backend MCP agent via:
+**Tip:** Every action requires a tenant ID, so fill that field before using any tab.
 
-**Endpoint:** `POST http://localhost:8000/agent/chat`
-
-**Headers:**
-- `Content-Type: application/json`
-- `x-tenant-id: <your-tenant-id>`
+---
 
-**Request Body:**
-```json
-{
-  "message": "Your message here"
-}
-```
+## API endpoints used by the Space
 
-**Response:**
-```json
-{
-  "response": "Agent's response text"
-}
-```
+| Purpose | Method & Path | Notes |
+| --- | --- | --- |
+| Chat with agent | `POST /agent/message` | Body includes `tenant_id`, `message`, optional history |
+| Ingest document (text/URL) | `POST /rag/ingest-document` | Accepts `source_type`, `content`, metadata |
+| Ingest file | `POST /rag/ingest-file` | Multipart upload with `x-tenant-id` header |
+| List analytics | `GET /analytics/overview` etc. | Used for Admin Analytics tab |
+| Manage rules | `GET/POST/DELETE /admin/rules` | Backend now persists rules in SQLite demo store |
 
-**Note:** The backend MCP system must be running separately. This Space provides only the frontend interface. See the [backend documentation](backend/README.md) for full setup instructions.
+All calls are proxied through the FastAPI backend running at `http://localhost:8000`. Ensure those services are online before launching the Space.
 
 ---