KI-Assistent (ChatBot)

KI-Assistent (ChatBot)

Der KI-Assistent beantwortet Ihre Fragen zur Nutzung von Veasytor. Er basiert auf der offiziellen Dokumentation und hilft bei allen Themen rund um die Plattform.

Zugang

Der Assistent erscheint als schwebende Schaltfläche (Floating Action Button) in der unteren rechten Ecke, sofern er vom System-Administrator für die jeweilige Subdomain aktiviert wurde. Er kann auf folgenden Subdomains aktiviert werden:

• Portal — für Verwalter und Eigentümer
• Go App — für Bewohner und Besucher
• Website (www) — vorbereitet, Aktivierung in einer zukünftigen Version (erfordert öffentlichen Chat-Modus)
• Admin — für System-Administratoren und Support-Mitarbeiter

Funktionen

• Fragen stellen: Tippen Sie Ihre Frage in das Eingabefeld
• Formatierte Antworten: Der Assistent antwortet mit formatierten Texten — Fettschrift, Listen, Links und Code werden korrekt dargestellt
• Schnellaktionen: Häufige Fragen als vordefinierte Chips für schnellen Zugriff
• Chatverlauf: Innerhalb einer Sitzung wird der Verlauf beibehalten. Bei längeren Gesprächen werden ältere Nachrichten automatisch gekürzt, um die Antwortqualität sicherzustellen
• Mehrsprachig: Der Assistent antwortet in Ihrer eingestellten Sprache (DE, EN, FR, IT)

Häufige Fragen, die der Assistent beantworten kann

• Wie erstelle ich eine Liegenschaft?
• Wie lade ich Bewohner ein?
• Wie funktioniert die Parkplatzverwaltung?
• Wie ändere ich mein Abonnement?
• Wie richte ich die App ein?
• Wie registriere ich ein Besucherfahrzeug?

Einschränkungen

• Der Assistent kann nur Fragen zu Veasytor beantworten
• Pro Stunde gibt es ein Nachrichtenlimit (Standard: 50 Nachrichten/Stunde, vom System-Administrator konfigurierbar)
• Der Chatverlauf wird beim Neuladen der Seite zurückgesetzt
• Für komplexe oder dringende Anliegen nutzen Sie bitte den Support

Für System-Administratoren

Die Konfiguration des ChatBots erfolgt über die Admin-Oberfläche unter System → ChatBot. Diese Seite ist nur für SuperAdmins zugänglich.

Status & Sichtbarkeit

• Globaler Schalter (ChatBot aktiv): Aktiviert oder deaktiviert den ChatBot systemweit
• Subdomain-Toggles: Separat für Portal, Go-App, Website (www) und Admin aktivierbar — der Bot erscheint nur dort, wo er explizit aktiviert ist

Provider & Modell

Provider	Endpoint nötig?	Beispiel-Modelle
Anthropic (Claude)	Nein	claude-sonnet-4-5-20250929
OpenAI (GPT)	Nein	gpt-4o, gpt-4o-mini
Z.AI	Ja	—
Mistral	Ja	mistral-large-latest
Custom	Ja	Beliebig (OpenAI-kompatible API)

• Bot-Name: Frei wählbarer Anzeigename des Assistenten
• API-Key: Optional bei der Ersteinrichtung — kann nachträglich ergänzt werden. Wird AES-256-GCM verschlüsselt gespeichert und in der UI maskiert angezeigt (z.B. sk-a••••xyz9 — erste und letzte 4 Zeichen sichtbar). Ohne API-Key ist der Test-Chat nicht verfügbar.
• API-Endpoint: Nur bei Z.AI, Mistral und Custom erforderlich

Verhaltenseinstellungen

• System-Prompt: Definiert Persönlichkeit und Verhalten des Assistenten
• Temperature (0.0–1.0): Niedrig = präzise Antworten, hoch = kreativere Antworten
• Max Tokens: Maximale Länge der Antwort in Tokens. Niedrigere Werte (z.B. 512) beschleunigen die Antwortzeit und lassen mehr Platz für den Gesprächsverlauf
• Wissensbasis-URL: URL zur Dokumentation als Wissensbasis (Standard: docs.veasytor.app)
• Rate-Limit: Maximale Nachrichten pro Benutzer pro Stunde

Test-Chat

Testen Sie die Konfiguration direkt auf der Admin-Seite, bevor Sie den Bot für Benutzer freischalten. Der Test-Chat nutzt dieselbe Wissensbasis wie der Endbenutzer-Chat — so sehen Sie realistisch, wie der Bot antwortet. Die Antwort zeigt den verbrauchten Token-Count (Input/Output) an.

Verschlüsselung (Server-Setup)

Damit API-Keys sicher in der Datenbank gespeichert werden können, muss auf dem Server die Umgebungsvariable CHATBOT_ENCRYPTION_KEY gesetzt sein. Ohne diese Variable kann kein API-Key gespeichert werden.

Generierung des Schlüssels (im Terminal):

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Den generierten 64-stelligen Hex-String als CHATBOT_ENCRYPTION_KEY in die .env.local (Entwicklung) bzw. in die Vercel-Umgebungsvariablen (Produktion) eintragen. Danach den Server neu starten.

Audit-Logging

Jede Änderung an der ChatBot-Konfiguration (Erstellen, Ändern, Löschen) wird automatisch im Audit-Log protokolliert.