gateway/readme.md
2025-03-15 21:27:59 +01:00

79 lines
No EOL
2.4 KiB
Markdown

# Data Platform - Multi-Agent Service
Eine Full-Stack-Webapplikation für die Ausführung von Multi-Agent-Workflows zur Verarbeitung und Analyse von Daten basierend auf natürlichsprachlichen Benutzeranfragen.
Hier: http://localhost:8000/docs
## Übersicht
Das System ermöglicht Benutzern:
- Hochladen und Verwalten verschiedener Datendateien
- Definieren von Prompts/Anweisungen für KI-Agenten
- Auswählen und Kombinieren spezialisierter Agenten
- Ausführen von Workflows mit Echtzeit-Protokollierung
- Visualisieren und Verwalten der Ergebnisse
## Projektstruktur
Das Projekt besteht aus zwei Hauptkomponenten:
### Frontend (HTML/CSS/JavaScript)
- `index.html` - Hauptstruktur der Benutzeroberfläche
- `styles.css` - Umfangreiches CSS für das responsive Design
- `script.js` - Client-seitige Logik für Interaktionen
### Backend (Python/FastAPI)
- `app.py` - Hauptanwendung mit API-Endpunkten
- `models.py` - Datenmodelle und Validierungsschemas
- `database.py` - Datenpersistenz (JSON-basiert für Demo)
- `agent_service.py` - Multi-Agent-Orchestrierung
- `requirements.txt` - Python-Abhängigkeiten
### Backend-Installation
1. Virtuelle Umgebung erstellen und aktivieren:
```bash
python -m venv venv
source venv/bin/activate # Linux/Mac
venv\Scripts\activate # Windows
```
2. Abhängigkeiten installieren:
```bash
pip install -r requirements.txt
```
3. Server starten:
```bash
uvicorn app:app --reload --host 0.0.0.0 --port 8000
```
4. Zugangspunkte:
- Frontend: `http://localhost:8080`
- Backend API: `http://localhost:8000`
- API-Dokumentation: `http://localhost:8000/docs`
### Datenbank-Migration
Für größere Installationen die JSON-basierte Datenbank ersetzen durch:
- PostgreSQL für relationale Daten
- MongoDB für Dokumente und unstrukturierte Daten
- Redis für Caching und Workflow-Status
## Technische Details
### Frontend-Architektur
- Vanilla JavaScript ohne Framework-Abhängigkeiten
- Modularer CSS-Ansatz für einfache Anpassungen
- Responsive Design für Desktop und mobile Nutzung
### Backend-Architektur
- FastAPI für hohe Performance und automatische API-Dokumentation
- Asynchrone Verarbeitung für parallele Agent-Ausführung
- Erweiterbare Service-Struktur für einfache Integration neuer Agententypen
## Lizenz
PRIVATE LICENSE PATRICK MOTSCH ValueOn AG
---
Für Fragen oder Unterstützung wenden Sie sich bitte an p.motsch@valueon.ch