Spaces:
Sleeping
Sleeping
| # IntegraChat - Current File Structure | |
| ``` | |
| IntegraChat/ | |
| ├── backend/ | |
| │ ├── api/ | |
| │ │ ├── main.py # FastAPI main application | |
| │ │ ├── mcp_clients/ | |
| │ │ │ ├── admin_client.py # Admin MCP client | |
| │ │ │ ├── mcp_client.py # Main MCP client wrapper | |
| │ │ │ ├── rag_client.py # RAG MCP client | |
| │ │ │ └── web_client.py # Web search MCP client | |
| │ │ ├── models/ | |
| │ │ │ ├── __init__.py | |
| │ │ │ ├── agent.py # Agent request/response models | |
| │ │ │ └── redflag.py # Red flag rule models | |
| │ │ ├── routes/ | |
| │ │ │ ├── admin.py # Admin routes | |
| │ │ │ ├── agent.py # Agent chat routes | |
| │ │ │ ├── analytics.py # Analytics routes | |
| │ │ │ ├── rag.py # RAG routes | |
| │ │ │ └── web.py # Web search routes | |
| │ │ ├── services/ | |
| │ │ │ ├── agent_orchestrator.py # Main orchestrator (multi-tool execution) | |
| │ │ │ ├── intent_classifier.py # Intent classification service | |
| │ │ │ ├── llm_client.py # LLM client (Ollama/Groq) | |
| │ │ │ ├── prompt_builder.py # Prompt building utilities | |
| │ │ │ ├── redflag_detector.py # Red flag detection service | |
| │ │ │ └── tool_selector.py # Multi-tool selection logic | |
| │ │ └── utils/ | |
| │ │ └── text_extractor.py # Text extraction utilities | |
| │ ├── mcp_server/ | |
| │ │ ├── server.py # Unified MCP entrypoint (rag/web/admin) | |
| │ │ ├── rag/ # RAG tool handlers (search/ingest/delete) | |
| │ │ ├── web/ # Web search tool handler | |
| │ │ ├── admin/ # Admin rules + violations tools | |
| │ │ └── common/ # Shared tenant/logging/utils helpers | |
| │ ├── tests/ | |
| │ │ ├── conftest.py # Pytest configuration | |
| │ │ ├── test_agent_orchestrator.py # Orchestrator tests | |
| │ │ └── test_intent.py # Intent classification tests | |
| │ └── workers/ # Background workers (empty) | |
| │ | |
| ├── venv/ # Python virtual environment | |
| ├── env.example # Environment variables template | |
| ├── pytest.ini # Pytest configuration | |
| ├── README.md # Project documentation | |
| ├── requirements.txt # Python dependencies | |
| └── start.bat # Windows startup script | |
| ``` | |
| ## Key Files Overview | |
| ### Core Services | |
| - **`agent_orchestrator.py`** - Main orchestrator handling multi-tool execution | |
| - **`tool_selector.py`** - Intelligent multi-tool selection (RAG + Web + LLM) | |
| - **`intent_classifier.py`** - Classifies user intent | |
| - **`redflag_detector.py`** - Detects policy violations | |
| ### MCP Servers | |
| - **`backend/mcp_server/server.py`** - Unified MCP entrypoint (rag/web/admin tools) | |
| - **`backend/mcp_server/rag/*.py`** - RAG tool handlers (search/ingest/delete) | |
| - **`backend/mcp_server/web/search.py`** - DuckDuckGo handler | |
| - **`backend/mcp_server/admin/*.py`** - Admin rules & violations tools | |
| ### API Routes | |
| - **`agent.py`** - Main chat/agent endpoint | |
| - **`rag.py`** - RAG operations | |
| - **`web.py`** - Web search operations | |
| - **`admin.py`** - Admin operations | |
| - **`analytics.py`** - Analytics endpoints | |
| ### Models | |
| - **`agent.py`** - AgentRequest, AgentDecision, AgentResponse | |
| - **`redflag.py`** - RedFlagRule, RedFlagMatch | |
| ### MCP Clients | |
| - **`mcp_client.py`** - Unified MCP client wrapper | |
| - **`rag_client.py`** - RAG client | |
| - **`web_client.py`** - Web search client | |
| - **`admin_client.py`** - Admin client | |