gateway/notes

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

1. Virtuelle Umgebung erstellen und aktivieren:

   python -m venv venv
   source venv/bin/activate  # Linux/Mac
   venv\Scripts\activate     # Windows
   

2. Abhängigkeiten installieren:

   pip install -r requirements.txt
   

3. Server starten:

   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

Lizenz

PRIVATE LICENSE PATRICK MOTSCH ValueOn AG

Für Fragen oder Unterstützung wenden Sie sich bitte an p.motsch@valueon.ch