98 lines
No EOL
3 KiB
Markdown
98 lines
No EOL
3 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 Lokal
|
|
0. lokal dev: (anaconda environment) conda activate poweron
|
|
|
|
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`
|
|
|
|
### Installation inazure WEBAPP
|
|
Configuration:
|
|
- Python version <= 3.11
|
|
- Startup command: cd gwserver && uvicorn app:app --host 0.0.0.0 --port 8000
|
|
Environment varibales:
|
|
- Neue Variable PORT=8000
|
|
|
|
### DEV TOOLS
|
|
Kill all processes on port 8000
|
|
netsh advfirewall firewall add rule name="Close_Port_8000" dir=in action=block protocol=TCP localport=8000
|
|
netsh advfirewall firewall delete rule name="Close_Port_8000"
|
|
|
|
|
|
### 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
|
|
|
|
### git permanent login with vs code
|
|
git remote set-url origin https://valueon@github.com/valueonag/gateway
|
|
git remote set-url origin https://valueon@github.com/valueonag/frontend_agents
|
|
|
|
## Lizenz
|
|
|
|
PRIVATE LICENSE PATRICK MOTSCH ValueOn AG
|
|
---
|
|
Für Fragen oder Unterstützung wenden Sie sich bitte an p.motsch@valueon.ch |