📚 Vollständiges Tutorial: Konfiguration eines medizinischen Chatbots mit AI Engine

*Dies ist der dritte Teil des vollständigen Konfigurationsleitfadens. Falls Sie die ersten beiden Teile verpasst haben, finden Sie sie [hier]** und [hier]**.*

In den ersten beiden Teilen haben wir behandelt:
✅ **Technische Grundlage** – Token-System, Kostenoptimierung, Dashboard-Module
✅ **Chatbot-Konfiguration** – KI-Modell, Embeddings, Grenzwerte, Wissensbasis
✅ **Benutzeroberfläche** – Erscheinungsbild, Popup, UI Builder, Erweitert
✅ **Erweiterte Integrationen** – Cross-Site, Shortcodes, Aktionen

## 📊 JETZT AKTIVIEREN WIR DAS KOMPLETTE KONTROLLPANEL:

In diesem Teil werden wir sowohl das Monitoring als auch die anfänglichen globalen Einstellungen erkunden:

🔹 **Discussions** – Analysieren von Benutzerkonversationen
🔹 **Insights** – Überwachung von Kosten und Leistungskennzahlen
🔹 **Settings – AI** – Konfigurieren von Umgebungen und KI-Anbietern


📊MONITORING UND ANALYSE – “Discussions”

📍 AI Engine → Discussions


🔹 HAUPTFUNKTIONALITÄT

Funktion: Anzeigen aller Konversationen
Nutzen: Überwachung der Chatbot-Leistung
Zugriff: Vollständiger Interaktionsverlauf

📈 ÜBERWACHUNG DER KONVERSATIONEN

🔍 WAS WIR IM PANEL SEHEN:

- Alle Benutzerdiskussionen
- Datum und Uhrzeit jeder Konversation
- Beteiligte Benutzer
- Besprochene Themen

💬 PRAKTISCHES BEISPIEL AUS DEM SYSTEM

📋 BESTEHENDE KONVERSATIONEN:

Benutzer #3: "Blasenentzündung"
Benutzer #3: "Harnwegsinfektion"

🔧 WIE MAN DISCUSSIONS ZUR OPTIMIERUNG NUTZT

✅ LEISTUNGSÜBERPRÜFUNG

Verifikationsprotokoll:
  1. Bestätigen Sie, dass die Antworten den Einstellungen entsprechen
  2. Überprüfen Sie die Konsistenz der Antworten
  3. Überwachen Sie die Interaktionsqualität

🚨 PROBLEMERKENNUNG

Worauf in Konversationen zu achten ist:
  - Antworten, die nicht den Einstellungen entsprechen
  - Fehler in den Konversationen
  - Technische Probleme

📋 VORTEILE FÜR DIE ADMINISTRATION

⚡ KONVERSATIONSVERWALTUNG

✅ Vollständige Transparenz über die Nutzung
✅ Schnelle Problemerkennung
✅ Kontinuierliche Serviceverbesserung

🔧 WARTUNG UND SUPPORT

✅ Verfolgung von Benutzerproblemen
✅ Effizienter technischer Support
✅ Optimierung des Benutzererlebnisses


🎯 KONFIGURATION DER GRENZWERTE – “INSIGHTS”

📍 AI Engine → Insights


🔹 FESTLEGUNG FINANZIELLER GRENZWERTE

🔧 KONFIGURIEREN VON GRENZWERTEN FÜR BENUTZER:

1. "Limits aktivieren" ankreuzen
2. Unter "Users" festlegen:
   - Credits: 10 (maximaler Betrag pro Benutzer)
   Type: Dollars (oder Questions/Tokens)
3. Unter "Guests" einen niedrigeren Grenzwert festlegen (z.B.: 5$)
4. Unter "System" den globalen Grenzwert festlegen (z.B.: 100$)

💡 BEDEUTUNG JEDER OPTION:

Dollars: Begrenzung nach ausgegebenem Betrag ($)
Questions: Begrenzung nach Anzahl der Fragen
Tokens: Begrenzung nach Anzahl der Tokens

👥 UNTERSCHEIDEN VON GRENZWERTEN NACH BENUTZERTYP

🎯 EMPFOHLENE KONFIGURATIONSSTRATEGIE:

REGISTRIERTE BENUTZER (USERS):

Credits: 10$ (mehr für loyale Benutzer)
Grund: Sie können komplexe Bedürfnisse und lange Konsultationen haben

BESUCHER (GUESTS):

Credits: 2-3$ (konservativer Grenzwert)
Grund: Verhindert Missbrauch durch anonyme Benutzer

SYSTEM (SYSTEM):

Credits: 100$ (globaler Sicherheitsgrenzwert)
Grund: Blockiert das gesamte System bei Überschreitung

⚠️ ÜBERWACHUNG UND ANPASSUNG DER GRENZWERTE

📊 INTERPRETATION DER NUTZUNGSDATEN:

Wenn Benutzer den Grenzwert schnell erreichen:
- Erhöhen Sie den Grenzwert von 10$ auf 15$
- Oder ändern Sie von $ auf Fragen

Wenn niemand den Grenzwert erreicht:
- Verringern Sie den Grenzwert zur Einsparung
- Oder behalten Sie ihn für den Benutzerkomfort bei

🔄 ZEITPUNKTE FÜR DIE ANPASSUNG:

Nach 1 Woche: Beobachten Sie reale Muster
Nach 1 Monat: Passen Sie basierend auf vollständigen Daten an
Bei Nutzungsanstieg: Überprüfen Sie die Grenzwerte

🛡️ SYSTEMSCHUTZ DURCH GRENZWERTE

🚨 KONFIGURIEREN VON SICHERHEITSMASSNAHMEN:

Timeframe: "Month" (setzt monatlich zurück)
Absolute: "Yes" (stoppt am Limit, warnt nicht nur)

🎯 KONFIGURATIONSRESULTAT:

- Jeder Benutzer erhält monatlich 10$
- Bei Überschreitung können sie den Chatbot nicht mehr nutzen
- Zu Monatsbeginn setzt sich der Zähler zurück

✅ TESTEN UND ÜBERPRÜFEN DER GRENZWERTE

🧪 TESTPROZESS:

1. Legen Sie einen kleinen Testgrenzwert fest (1$)
2. Nutzen Sie den Chatbot, bis der Grenzwert überschritten ist
3. Überprüfen Sie, ob das System korrekt blockiert
4. Passen Sie auf den endgültigen Wert an

Diese Konfiguration bietet vollständige Kontrolle über die Kosten und verhindert Budgetüberschreitungen.




⚙️ “SETTINGS” – GLOBALE KONFIGURATIONEN

1. “AI”-TAB – KONFIGURIEREN VON KI-ANBIETERN

📍 AI Engine → Settings → “AI”-Tab


🔹 ABSCHNITT “ENVIRONMENTS FOR AI” – KONFIGURIEREN VON VERBINDUNGEN

🌐 HAUPTKONFIGURATIONSPANEL:

Zweck: Konfigurieren von Verbindungen mit KI-Anbietern
Status: Liste der konfigurierten Umgebungen + Aktionsschaltflächen

🔧 SCHNITTSTELLENELEMENTE:

📋 LISTE DER UMGEBUNGEN:
OpenAI: ✅ Konfigurationsschaltfläche (Hauptanbieter)
OpenRouter: ✅ Konfigurationsschaltfläche (kosteneffiziente Alternative)
➕ Schaltfläche zum Hinzufügen benutzerdefinierter Anbieter

🏗️ KONFIGURATIONSARCHITEKTUR:

Jede Umgebung repräsentiert:
- Eine Verbindung zu einem KI-Anbieter
- Einen authentifizierten API-Schlüssel
- Eine Reihe spezifischer Fähigkeiten
- Eine eindeutige Environment ID

⚙️ KONFIGURIEREN DER OPENAI-UMGEBUNG:

📝 AUSFÜLLFORMULAR:

Name: "OpenAI" - Umgebungsbezeichner
Type: "OpenAI" - aus der Dropdown-Liste ausgewählt
API Key: [API-Schlüssel] - Feld zur Authentifizierung
Organization ID: optional - für Geschäftskonten

🎪 LISTE DER VERFÜGBAREN TYPEN:

Dropdown-Typ enthält:
├─ OpenAI (GPT-4, GPT-3.5 Turbo)
├─ Anthropic (Claude-Modelle)
├─ Azure (OpenAI auf Azure)
├─ Google (Gemini, PaLM)
├─ OpenRouter (Multi-Anbieter-Aggregator)
├─ Replicate (Open-Source-Modelle)
├─ Perplexity (Suche + KI)
└─ Mistral (Europäische Modelle)

🔑 API-SCHLÜSSEL-VERWALTUNG:

Quelle: platform.openai.com/api-keys
Sicherheit: 
  - Schlüssel ist in der Schnittstelle maskiert
  - Verschlüsselte Speicherung in der Datenbank
  - Automatische Validierung beim Speichern

🆔 GENERIERUNG DER ENVIRONMENT ID:

Environment ID: "2vxxmijh" - automatisch generiert
Funktion: Eindeutiger Bezeichner für die Umgebung
Nutzung: Referenzen in Chatbots und Einstellungen

🛡️ SICHERHEITS- UND VALIDIERUNGSMECHANISMEN:

✅ VERBINDUNGSTEST:

"Quick Test"-Schaltfläche: 
  - Überprüft die API-Konnektivität
  - Validiert den API-Schlüssel
  - Bestätigt Berechtigungen
  - Gibt den Verbindungsstatus zurück

🚨 DATENSCHUTZ:

API-Schlüssel: 
  - Werden nicht im Frontend angezeigt
  - Werden sicher an das Backend übertragen
  - Werden verschlüsselt in der Datenbank gespeichert
  - Sind nur für legitime Verarbeitung zugänglich

🎯 MEDIZINISCHE KONFIGURATIONSSTRATEGIE:

💊 AUSWAHL DES ANBIETERS:

OpenAI GPT-4 Turbo:
  - Überlegene medizinische Genauigkeit
  - Befolgt strenge Prompts
  - Optimierte Kosten für Volumen
  - Kompatibilität mit Embeddings

🔗 VOLLSTÄNDIGE SYSTEMINTEGRATION:

OpenAI Environment → Medizinischer Chatbot → Wissensbasis
         ↓                   ↓                 ↓
API-Verbindung        Verwendet Umgebung    Datenbank
Schlüsselvalidierung       GPT-4 Turbo Modell    Ada-002 Embeddings

🔹 ABSCHNITT “DEFAULT ENVIRONMENTS FOR AI” – SPEZIALISIERTE KONFIGURATION

🌐 PANEL FÜR SPEZIALISIERTE UMGEBUNGEN:

Zweck: Konfigurieren spezialisierter Umgebungen für spezifische Aufgaben
Struktur: 7 Tabs für verschiedene Arten der KI-Verarbeitung

🔧 VERFÜGBARE TABS:

🎯 DEFAULT – ALLGEMEINE VERARBEITUNG:

Environment: OpenAI
Model: GPT-4 Turbo (✅ Ausgewählt)
Zweck: Allgemeine konversationelle Interaktionen
Nutzung: Chatbots, Inhaltserstellung

⚡ FAST – SCHNELLE ANTWORTEN:

Environment: OpenAI
Model: GPT-4o Mini (✅ Ausgewählt)
Zweck: Schnelle Aufgaben, Optimierung von Suchanfragen
Merkmale: Erhöhte Geschwindigkeit, reduzierte Kosten

👁️ VISION – BILDVERARBEITUNG:

Environment: OpenAI
Model: GPT-4o Mini (✅ Ausgewählt)
Zweck: Bildanalyse und -verständnis (Bild-zu-Text)
Fähigkeiten: Texterkennung, Beschreibungen, Inhaltsanalyse

🎨 IMAGES – BILDERZEUGUNG:

Environment: OpenAI
Model: DALL-E 3 (HD) (✅ Ausgewählt)
Zweck: Erzeugen von Bildern aus Textbeschreibungen
Qualität: HD - hochauflösend
Alternativen: DALL-E 3, DALL-E 2

🔍 EMBEDDINGS – TEXTVEKTORISIERUNG:

Environment: OpenAI
Model: Embedding Ada-002 (✅ Ausgewählt)
Dimensionen: 1536 (Nativ)
Zweck: Erstellung von Embeddings für die semantische Suche
Nutzung: Wissensbasen, Textähnlichkeit

🎵 AUDIO – AUDIOVERARBEITUNG:

Environment: OpenAI
Model: Whisper (✅ Ausgewählt)
Zweck: Audiotranskription (Audio-zu-Text)
Alternativen: GPT-4o Transcribe, GPT-4o Mini Transcribe

📊 JSON – STRUKTURIERTE DATEN:

Environment: OpenAI
Model: GPT-4o Mini (✅ Ausgewählt)
Zweck: Erzeugung strukturierter Daten, JSON-Formatierung
Nutzung: API-Antworten, Datenverarbeitung

🏗️ MEDIZINISCHE KONFIGURATIONSSTRATEGIE:

💊 AUSWAHL OPTIMALER MODELLE:

Default: GPT-4 Turbo → Maximale medizinische Genauigkeit
Embeddings: Ada-002 → Kompatibel mit der medizinischen Wissensbasis
Fast: GPT-4o Mini → Schnelle Antworten für Symptome

🔗 INTEGRATIONSARCHITEKTUR:

Medizinischer Chatbot → Default Environment (GPT-4 Turbo)
Wissensbasis → Embeddings Environment (Ada-002)
Suchanfragen → Fast Environment (GPT-4o Mini)

🔍“EMBEDDINGS ADA-002” – DAS VEKTORISIERUNGSSYSTEM

🎯 WAS IST EMBEDDING ADA-002:

🤖 TECHNISCHE DEFINITION:

Embedding Ada-002: OpenAI-Modell zur Umwandlung von Text in Vektoren
Funktion: Konvertiert Wörter und Phrasen in numerische Darstellungen
Analog: "Übersetzer" von menschlicher Sprache in mathematische Sprache

🏗️ FUNKTIONSWEISE:

Text: "Paracetamol gegen Fieber"
         ↓
Embedding Ada-002
         ↓
Vektor: [0.123, -0.456, 0.789, ..., 0.234] (1536 Zahlen)

📐 DIMENSION 1536 – BEDEUTUNG:

🔢 WAS 1536 REPRÄSENTIERT:

Dimension: 1536 Zahlen in jedem Vektor
Bedeutung: 1536 Merkmale des Textes
Jede Zahl: Repräsentiert ein semantisches Merkmal

🎯 WARUM 1536 WICHTIG IST:

Präzision: Je mehr Dimensionen, desto präziser
Komplexität: Erfasst feine Nuancen der Bedeutung
Optimiert: Perfektes Gleichgewicht zwischen Leistung und Kosten

💊 ANWENDUNG IM MEDIZINISCHEN SYSTEM:

🔍 PRAKTISCHES MEDIZINISCHES BEISPIEL:

Frage: "welche Medikamente gegen akuten Husten?"
         ↓
Embedding Ada-002
         ↓
Vektor: [Husteneigenschaften, akut, respiratorische Symptome...]
         ↓
Suche nach Ähnlichkeit in der Datenbank
         ↓
Ergebnisse: Hustenmedikamente (falls verfügbar)

🏥 VORTEILE FÜR DIE MEDIZIN:

✅ Versteht medizinische Synonyme: "Fieber" = "Temperatur" = "Pyrexie"
✅ Erkennt ähnliche Kontexte: "akuter Husten" ≈ "anhaltender Husten"
✅ Findet Korrelationen: "Gelenkschmerzen" → Entzündungshemmer
✅ Eliminiert die Abhängigkeit von exakten Schlüsselwörtern

🔧 INTEGRATION IN DIE SYSTEMARCHITEKTUR:

🗂️ VOLLSTÄNDIGER FLUSS:

Medikamenten-PDF → Textextraktion → Embedding Ada-002
         ↓
1536D-Vektoren → Speicherung in Qdrant Cloud
         ↓
Benutzerfrage → Embedding Ada-002 → Suchvektor
         ↓
Vektorvergleich → Ähnliche Medikamente → Antwort

⚡ SYSTEMEFFIZIENZ:

Geschwindigkeit: Ultraschnelle Vektorsuche
Genauigkeit: Findet Verbindungen, die die Schlüsselwortsuche verpasst
Skalierbarkeit: Funktioniert mit Tausenden von Medikamenten

Embedding Ada-002 ist die Intelligenz-Engine, die die Bedeutung hinter medizinischen Wörtern versteht! 🧠


🔹 ABSCHNITT “GENERAL” – ERWEITERTE SYSTEMEINSTELLUNGEN

🔄 STREAMING – ECHTZEIT-ANTWORTEN:

Status: ✅ Aktivieren (aktiviert)
Funktion: Progressive Anzeige von KI-Antworten
Vorteile:
  - Verbessertes Benutzererlebnis
  - Sofortiges visuelles Feedback
  - Gefühl einer natürlichen Konversation

⚠️ BETA-EINSCHRÄNKUNGEN WARNUNG:

Warnung: Die Fähigkeit zur Verwaltung von Statistiken, Grenzwerten, und Filtern
befindet sich noch in der Beta-Phase
Empfehlung: Enge Überwachung der Leistung

🐛 EVENT LOGS – ERWEITERTES DEBUGGING:

Status: ❌ Aktivieren (deaktiviert)
Funktion: Anzeige von Streaming-Ereignissen und Funktionsaufrufen
Bedingungen:
  - Erfordert die Aktivierung von Streaming
  - Nur in der Chatbot-Oberfläche sichtbar
Nutzung: Technisches Debugging für Entwickler

🚀 RESPONSES API – VERBESSERTE LEISTUNG:

Status: ✅ Aktivieren (aktiviert - empfohlen)
Funktion: Verwendung der neuen OpenAI Responses API
Vorteile:
  - Überlegene Leistung
  - Erweiterte Funktionalitäten
  - Optimiertes Erlebnis

🔧 FALLBACK-VERWALTUNG:

Empfehlung: Aktivierung für maximale Vorteile
Fallback: Kann bei Problemen deaktiviert werden
Kompatibilität: Funktioniert mit allen OpenAI-Umgebungen

🏗️ ALLGEMEINE EINSTELLUNGSARCHITEKTUR:

⚡ AUSWIRKUNG AUF DAS SYSTEM:

Aktives Streaming:
  - Antworten werden Zeichen für Zeichen angezeigt
  - Reduzierte Latenz für das erste Token
  - Natürlichere Interaktion

Aktive Responses API:
  - Moderne Kommunikationsstruktur
  - Verbessertes Fehlermanagement
  - Kompatibilität mit zukünftigen Funktionen

💊 OPTIMIERUNG FÜR MEDIZINISCHES SYSTEM:

Streaming: Vorteilhaft für lange medizinische Konsultationen
Event Logs: Deaktiviert - wird in der Produktion nicht benötigt
Responses API: Aktiviert - Stabilität für Patienten

✅ EMPFOHLENE KONFIGURATION:

✅ Streaming: Aktivieren (Premium-Benutzererlebnis)
❌ Event Logs: Deaktivieren (Sicherheit und Leistung)
✅ Responses API: Aktivieren (Stabilität und Funktionen)

**📚 FORTSETZUNG IN TEIL 4**

Wir haben das Monitoring-System und die anfänglichen globalen KI-Einstellungen abgeschlossen.
Im nächsten Artikel werden wir die Konfiguration aller globalen Einstellungen vervollständigen:

🔹 **Settings – Chatbot** – Globale Einstellungen für alle Chatbots
🔹 **Settings – Knowledge** – Zentrale Wissensbasis-Konfigurationen
🔹 **Settings – Orchestration** – Integrationen und Automatisierungen
🔹 **Settings – Files & Media** – Dateiverwaltung
🔹 **Settings – Remote Access** – API und externe Verbindungen
🔹 **Settings – Others** – Sicherheit und Wartung

**[👉 Lesen Sie Teil 4: Vollständige globale Konfigurationen hier]**