HybridAI Benutzerhandbuch

1. Einleitung

HybridAI ist ein fortschrittliches KI-Chatbot-System, das mehrere KI-Modelle, emotionale Erkennung und Funktionsaufrufe integriert, um eine nahtlose Benutzererfahrung zu schaffen. Es unterstützt direkte Chatbot-Interaktionen, Website-Automatisierung und Integrationen mit verschiedenen Plattformen wie WhatsApp, Slack und Telegram.

2. Systemübersicht

• Mehrere KI-Modelle: Einschließlich OpenAI GPT, Perplexity, Gemini und mehr.
• Emotionale Erkennung & Menschliche Übernahme: Erkennt Benutzerfrustration oder Dringlichkeit und ermöglicht eine menschliche Intervention.
• Funktionsaufrufe: Führt Aktionen wie das Abrufen von Echtzeitdaten, die Interaktion mit APIs und die Automatisierung von Prozessen aus.
• Website-Befehle: Ermöglicht Chatbots die dynamische Interaktion mit Webseiten.
• Integrationen: Unterstützt Plattformen wie WhatsApp, Slack und Telegram.

3. Einrichtung von HybridAI

3.1 Einbetten des Chatbots

Um HybridAI in Ihre Website zu integrieren, verwenden Sie das folgende Einbettungsskript:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID", // Ihre eindeutige Chatbot-ID
        chatbotServer: "https://hybridai.one" // Backend-Server-Domain
    };
</script>
<script src="https://hybridai.one/hai_embed.js?chatbotId=IHRE_CHATBOT_ID"></script>

Dieses Skript lädt das Chat-Widget und verbindet es mit dem HybridAI-Server. Die genauen Skript-Parameter finden Sie auf der Integrationsseite in Ihrem Admin-Panel.

Beispiel eines HybridAI Chatbot-Widgets, das in eine Website integriert wurde.

3.2 Konfiguration des Chatbots

Gehen Sie zu Admin-Panel > Allgemeine Einstellungen, um:

• Einen Bot-Namen, ein Farbschema und Standardnachrichten festzulegen.
• KI-Modellpräferenzen zu definieren (z. B. OpenAI/ChatGPT, Google-Gemini, Mistral, Perplexity als Function Call und weitere – auch selbst gehostete Modelle auf Anfrage).
• Die Anweisungen für den Bot zu optimieren und Persönlichkeit, Beispiele usw. hinzuzufügen.
• Wissen hochzuladen (z.B. PDF-Seiten, Word-Dateien, CSV usw.) oder eine Website crawlen zu lassen

Die Oberfläche für allgemeine Einstellungen zeigt Bot-Konfigurationsoptionen einschließlich Name, Farbe, Nachrichten und Preiseinstellungen.

Auf Anfrage unterstützen wir auch selbst gehostete und spezialisierte Modelle wie Teuken, Occiglot, Dolphin und weitere.

3.3 Widget-Integrationsmodi

HybridAI bietet vier verschiedene Modi zur Integration Ihres Chatbots in Ihre Website. Jeder Modus ist für spezifische Anwendungsfälle optimiert und kann je nach Ihren Anforderungen ausgewählt werden.

1. Content-Embedded ChatBot

Integrieren Sie den Chatbot direkt in den Inhalt Ihrer Website. Perfekt für Dokumentationsseiten, Wissensdatenbanken und Produktseiten, wo der Kontext wichtig ist.

Der Bot wird in den bestehenden Inhalt eingebettet und kann mit spezifischen Seitenelementen interagieren. Diese Integration ermöglicht eine nahtlose Benutzererfahrung, bei der der Chatbot als natürlicher Teil der Seite erscheint.

2. Chat-Icon mit schwebendem Widget

Zeigen Sie ein Chat-Icon an, das beim Klicken ein schwebendes Chat-Widget öffnet. Ideal für Kundensupport und allgemeine Benutzerinteraktion, ohne permanenten Platz einzunehmen.

Das Widget erscheint als schwebendes Fenster über dem Seiteninhalt und kann bei Bedarf geöffnet oder geschlossen werden. Diese Lösung ist besonders beliebt für E-Commerce-Websites und Support-Portale.

3. Standardmäßig geöffnetes schwebendes Widget

Zeigen Sie ein schwebendes Chat-Widget an, das standardmäßig geöffnet ist. Großartig für Szenarien mit hoher Interaktion, bei denen Sie möchten, dass der Chat sofort sichtbar und zugänglich ist.

Diese Option eignet sich besonders für Landing Pages, Onboarding-Prozesse oder Situationen, in denen Sie maximale Benutzerinteraktion fördern möchten. Der Chat ist von Anfang an präsent und lädt zur Interaktion ein.

4. Headless-Modus über API

Verwenden Sie Ihren Chatbot programmatisch über unsere API. Perfekt für benutzerdefinierte Integrationen, mobile Apps oder wenn Sie vollständige Kontrolle über die Benutzeroberfläche benötigen.

Im Headless-Modus haben Sie die volle Kontrolle über das Design und die Funktionalität. Sie können den Chatbot in Ihre eigenen Anwendungen einbetten, mobile Apps entwickeln oder komplexe Workflows erstellen.

3.4 Widget-Konfigurationsoptionen

Sie können das Erscheinungsbild und Verhalten Ihres Chat-Widgets über verschiedene Konfigurationsoptionen anpassen:

Grundlegende Konfiguration

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        chatbotServer: "https://hybridai.one",
        initialGreeting: "Willkommen! Wie kann ich Ihnen heute helfen?",
        widgetColor: "#3498db",
        position: "right",  // Optionen: "right", "left", "center"
        widgetSize: "standard"  // Optionen: "standard", "compact"
    };
</script>
<script src="https://hybridai.one/hai_embed.js"></script>
    

Erweiterte Konfigurationsoptionen

• initialGreeting: Die erste Nachricht, die der Bot anzeigt
• widgetColor: Die Hauptfarbe des Widgets (Hex-Code)
• position: Position des Widgets auf der Seite („right“, „left“, „center“)
• widgetSize: Größe des Widgets („standard“, „compact“)
• defaultOpen: Ob das Widget standardmäßig geöffnet sein soll (true/false)
• showAvatar: Ob das Bot-Avatar angezeigt werden soll (true/false)
• enableNotifications: Ob Desktop-Benachrichtigungen aktiviert sind (true/false)

Beispiel für erweiterte Konfiguration

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        chatbotServer: "https://hybridai.one",
        initialGreeting: "Hallo! Ich bin Ihr persönlicher Assistent. Wie kann ich helfen?",
        widgetColor: "#2ecc71",
        position: "left",
        widgetSize: "compact",
        defaultOpen: false,
        showAvatar: true,
        enableNotifications: true,
        customCSS: {
            borderRadius: "12px",
            boxShadow: "0 4px 20px rgba(0,0,0,0.15)"
        }
    };
</script>
<script src="https://hybridai.one/hai_embed.js"></script>
    

3.5 Plattform-Integrationen

HybridAI kann in verschiedene Plattformen und Systeme integriert werden, entweder über universelle JavaScript-Einbettung oder über spezielle Integrationen, die wir für beliebte Plattformen bereitstellen.

Universelle JavaScript-Integration

Die einfachste Methode zur Integration von HybridAI in jede Website oder Plattform ist die Verwendung unseres JavaScript-Einbettungsskripts:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        chatbotServer: "https://hybridai.one"
    };
</script>
<script src="https://hybridai.one/hai_embed.js?chatbotId=IHRE_CHATBOT_ID"></script>

Diese Methode funktioniert auf jeder Plattform, die JavaScript unterstützt, einschließlich:

• Statische Websites (HTML/CSS/JS)
• React, Vue.js, Angular und andere JavaScript-Frameworks
• Shopify, Wix, Squarespace und andere Website-Builder
• Custom Web-Anwendungen
• Mobile Web-Apps

WordPress-Plugin Integration

Für WordPress-Websites bieten wir ein umfassendes Plugin an, das eine nahtlose Integration ermöglicht:

• Einfache Installation: Direkt aus dem WordPress-Plugin-Verzeichnis installierbar
• Vollständige Konfiguration: Alle Einstellungen über das WordPress-Admin-Panel
• Erweiterte Funktionen: Shortcode-Support, Consent-Management, Chat-Logs
• Automatische Updates: Regelmäßige Updates und Wartung
• Webhook-Integration: Sichere REST-API für Chat-Logs mit HMAC-Authentifizierung
• CSV-Export: Export von Chat-Logs mit Datumsbereich-Filterung

Das HybridAI Chatbot WordPress-Plugin bietet zusätzliche Funktionen wie:

• Automatische Bot-Erstellung bei Plugin-Aktivierung
• Consent-Management für DSGVO-Compliance
• Erweiterter Modus für spezifische Seiten
• Inhalt-Chatbot über Shortcode:
• Browser-ID-Filterung für Chat-Logs
• Responsive Design für alle Geräte

Andere Plattform-Integrationen

Neben WordPress unterstützen wir auch Integrationen mit anderen beliebten Plattformen:

• Shopify: Integration über Theme-Code oder App-Store
• Wix: Einbettung über HTML-Widget
• Squarespace: Integration über Code-Injection
• Webflow: Einbettung über Custom Code
• Magento: Integration über Theme-Anpassungen

Messaging-Plattform-Integrationen

HybridAI integriert sich nahtlos mit beliebten Messaging- und Social-Media-Plattformen:

• WhatsApp: Verbinden Sie Ihren Bot mit der WhatsApp Business API
• Telegram: Richten Sie Ihren Bot für die Kommunikation über Telegram ein
• Slack: Integrieren Sie Ihren Chatbot in Ihren Slack-Arbeitsbereich

Sie können unsere WhatsApp-Integration auf der Startseite testen. Kontaktieren Sie uns, wenn Sie diese Integrationen für Ihren Bot verwenden möchten.

Automatisierungsplattformen

HybridAI integriert sich mit beliebten Automatisierungs- und Workflow-Plattformen:

• n8n: Verbinden Sie Ihren Chatbot mit n8n-Workflows für komplexe Automatisierungsszenarien (siehe Abschnitt 9.4 für detaillierte N8N-Integration)
• Make (ehemals Integromat): Erstellen Sie anspruchsvolle Integrationen mit dem visuellen Workflow-Builder von Make
• Zapier: Nutzen Sie Zapier, um Ihren Chatbot mit Tausenden anderer Webanwendungen zu verbinden

Diese Integrationen ermöglichen es Ihnen, Aktionen in anderen Systemen basierend auf Chatbot-Interaktionen auszulösen oder externe Daten in Ihren Chatbot einzuspeisen.

API-Integration für Entwickler

Für Entwickler bieten wir verschiedene API-Endpunkte für benutzerdefinierte Integrationen:

• OpenAI-kompatible API: Für direkte Chatbot-Integrationen
• Bot-Memory-API: Für IoT und externe Datenintegration
• Webhook-Endpunkte: Für Echtzeit-Benachrichtigungen
• REST-API: Für umfassende Systemintegrationen

3.6 Erweiterte Widget-Anpassung (CSS-Anpassung)

Das HybridAI Widget v2 unterstützt jetzt erweiterte CSS-Anpassungen, die es Ihnen ermöglichen, das Erscheinungsbild vollständig an Ihre Markenidentität anzupassen, ohne die Kernfunktionalität zu beeinträchtigen.

Anpassungsmethoden

Methode 1: Externe CSS-Datei (Empfohlen für erweiterte Anpassungen)

Laden Sie eine vollständig benutzerdefinierte CSS-Datei, die die Standard-Widget-Stile überschreibt:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        customCssUrl: "https://ihredomain.de/pfad/zu/custom-widget-styles.css",
        useDefaultCss: false  // Optional: Standard-CSS vollständig deaktivieren
    };
</script>
<script src="https://hybridai.one/hai_embed.js?chatbotId=IHRE_CHATBOT_ID"></script>

Vorteile:

• Vollständige Kontrolle über alle Stile
• Kann ohne JavaScript-Änderungen aktualisiert werden
• Einfache Wartung und Versionskontrolle
• Unterstützt CDN-Hosting für bessere Performance

Methode 2: CSS-Variablen (Schnelle Themenanpassung)

Überschreiben Sie spezifische CSS-Variablen für schnelle Anpassungen:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        // Farbanpassung
        color_scheme: "#FF6B6B",
        
        // Größenanpassung
        width: "450px",
        height: "650px",
        
        // Positionsanpassung
        buttonPosition: {
            bottom: "30px",
            right: "30px"
        },
        
        // Typografie
        fontSize: "16px",
        
        // Theme
        theme: "dark"  // oder "light"
    };
</script>

Methode 3: Hybrid-Ansatz

Verwenden Sie das Standard-CSS mit Variablenüberschreibungen plus eine benutzerdefinierte CSS-Datei für spezifische Änderungen:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        customCssUrl: "https://ihredomain.de/widget-overrides.css",
        color_scheme: "#6C63FF",
        width: "500px"
    };
</script>

Verfügbare CSS-Variablen

Das Widget stellt über 30 CSS-Variablen zur Verfügung, die Sie anpassen können. Hier ist die vollständige Liste:

:root {
    /* Primäre Farben */
    --hai-primary-color: #f5f6f8;
    --hai-primary-hover: #e8e9eb;
    --hai-text-color: #333333;
    --hai-text-color-inverse: #ffffff;
    
    /* Widget-Dimensionen */
    --hai-button-size: 60px;
    --hai-window-width: 400px;
    --hai-window-height: 600px;
    --hai-window-min-width: 350px;
    --hai-window-min-height: 400px;
    --hai-window-max-width: 90vw;
    --hai-window-max-height: calc(100vh - 40px);
    
    /* Positionierung */
    --hai-button-position-bottom: 20px;
    --hai-button-position-right: 20px;
    
    /* Ränder und Schatten */
    --hai-border-radius: 12px;
    --hai-button-border-radius: 50%;
    --hai-box-shadow: 0 10px 30px rgba(0, 0, 0, 0.15);
    --hai-button-shadow: 0 4px 8px rgba(0, 0, 0, 0.2);
    
    /* Z-Index Schichtung */
    --hai-z-index: 9999;
    
    /* Animation-Timing */
    --hai-transition-duration: 0.2s;
    --hai-animation-duration: 1.5s;
    
    /* Titelleiste */
    --hai-titlebar-height: 40px;
    --hai-titlebar-bg: #2196F3;
    --hai-titlebar-text: #ffffff;
    
    /* Schriftgrößen */
    --hai-font-size-base: 14px;
    --hai-font-size-title: 14px;
    --hai-font-size-controls: 16px;
    --hai-font-size-tooltip: 12px;
    
    /* Abstände */
    --hai-spacing-xs: 4px;
    --hai-spacing-sm: 8px;
    --hai-spacing-md: 10px;
    --hai-spacing-lg: 15px;
    --hai-spacing-xl: 20px;
    
    /* Dark Theme */
    --hai-dark-bg: #1e1e1e;
    --hai-dark-text: #e0e0e0;
    --hai-dark-hover: #2a2a2a;
}

Beispiel: Unternehmens-Branding

/* corporate-theme.css */
:root {
    --hai-primary-color: #003366;
    --hai-titlebar-bg: #003366;
    --hai-button-size: 70px;
    --hai-border-radius: 8px;
    --hai-font-size-base: 16px;
}

.hybridai-chat-button {
    background: var(--hai-primary-color) !important;
    box-shadow: 0 4px 12px rgba(0, 51, 102, 0.3) !important;
}

Best Practices

• CSS-Variablen zuerst verwenden: Für einfache Farb- und Größenänderungen sind CSS-Variablen der wartungsfreundlichste Ansatz
• Responsivität testen: Testen Sie Ihre benutzerdefinierten Stile immer auf mobilen Geräten
• Funktionalität erhalten: Verbergen oder ändern Sie keine strukturellen Elemente, die für die Funktionalität erforderlich sind
• Versionierung: Fügen Sie Versionskommentare in Ihre CSS-Dateien ein für einfacheres Debugging
• CDN verwenden: Hosten Sie Ihre benutzerdefinierte CSS auf einem CDN für bessere Performance

Grundlegende Widget-Konfiguration

Sie können verschiedene Aspekte des Widgets anpassen, indem Sie das chatbotConfig-Objekt modifizieren:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        chatbotServer: "https://hybridai.one",
        initialGreeting: "Willkommen! Wie kann ich Ihnen heute helfen?",
        widgetColor: "#3498db",
        position: "right",  // Optionen: "right", "left", "center"
        widgetSize: "standard",  // Optionen: "standard", "compact"
        context: "Benutzer befindet sich auf der Produktseite für Premium Widget Pro"  // Optionale Kontextinformationen
    };
</script>
<script src="https://hybridai.one/hai_embed.js?chatbotId=IHRE_CHATBOT_ID"></script>

Kontext-Funktion

Der context-Parameter ermöglicht es Ihnen, Informationen darüber bereitzustellen, wo das Widget ausgeführt wird. Diese Kontextinformationen werden in die Willkommensnachricht an die LLM eingefügt und helfen der KI, die aktuelle Situation des Benutzers zu verstehen und relevantere Antworten zu geben.

Anwendungsfälle:

• Produktseiten: Informieren Sie die KI über welches Produkt der Benutzer betrachtet
• Support-Seiten: Lassen Sie die KI wissen, dass der Benutzer technische Hilfe sucht
• Warenkorb: Geben Sie Informationen über Artikel im Warenkorb
• Geografischer Kontext: Fügen Sie standortbasierte Informationen hinzu

Beispiele:

// Produktseiten-Kontext
window.chatbotConfig = {
    chatbotId: "ihre-chatbot-id",
    context: "Benutzer betrachtet die Premium Widget Pro Produktseite. Dies ist unser Flaggschiff-Produkt, das 299€ kostet und lebenslangen Support beinhaltet."
};

// Support-Seiten-Kontext
window.chatbotConfig = {
    chatbotId: "ihre-chatbot-id",
    context: "Benutzer befindet sich auf der Fehlerbehebungsseite für Verbindungsprobleme. Sie benötigen möglicherweise Hilfe bei der Netzwerkkonfiguration."
};

// Warenkorb-Kontext
window.chatbotConfig = {
    chatbotId: "ihre-chatbot-id",
    context: "Benutzer ist im Warenkorb mit 3 Artikeln: Premium Widget Pro (299€), Erweiterte Garantie (49€) und kostenloser Versand. Gesamtwert des Warenkorbs: 348€."
};

Hinweis: Der Kontext ist optional. Wenn nicht angegeben, funktioniert die Willkommensnachricht wie zuvor ohne Kontextinformationen.

Demo-Seite

Um verschiedene Widget-Konfigurationen zu erkunden und Erscheinungsbildoptionen zu testen, besuchen Sie unsere Widget-Demo-Seite. Diese interaktive Demo ermöglicht es Ihnen:

• Verschiedene Farbschemata zu testen
• Verschiedene Positionen und Größen zu testen
• Beispiele für benutzerdefinierte Stile zu sehen
• Den erforderlichen Code für Ihre Konfiguration zu generieren

3.7 Vollbild-Modus Anpassung

Das HybridAI Widget verfügt über einen Vollbild-Modus, der eine ChatGPT-ähnliche Benutzeroberfläche bietet. Dieser Modus kann vollständig angepasst werden, um Ihrer Markenidentität zu entsprechen und ein nahtloses Benutzererlebnis zu bieten.

Zugriff auf den Vollbild-Modus

Benutzer können den Vollbild-Modus durch Klicken auf die Vollbild-Schaltfläche (⛶) in der Widget-Kopfzeile aktivieren. Dies öffnet eine immersive Chat-Oberfläche, die das gesamte Ansichtsfenster ausfüllt.

Anpassungsoptionen

Sie können jeden Aspekt des Vollbild-Modus über das fullscreen Konfigurationsobjekt anpassen:

<script>
    window.chatbotConfig = {
        chatbotId: "IHRE_CHATBOT_ID",
        fullscreen: {
            // Hintergrund und Layout
            overlayBg: '#1a1a2e',           // Vollbild-Hintergrundfarbe
            headerBg: '#16213e',            // Header-Hintergrund
            headerBorderColor: '#0f3460',   // Header-Randfarbe
            headerPadding: '20px 30px',     // Header-Abstand
            contentMaxWidth: '900px',       // Maximale Inhaltsbreite
            contentPadding: '0 30px',       // Inhalts-Seitenabstand
            
            // Nachrichten-Styling
            messageMaxWidth: '85%',         // Maximale Nachrichtenbreite
            messagePadding: '15px 20px',    // Nachrichten-Abstand
            messageBorderRadius: '12px',    // Nachrichten-Randradius
            messageFontSize: '17px',        // Nachrichten-Schriftgröße
            userMessageBg: '#4a90e2',       // Benutzer-Nachrichten-Hintergrund
            userMessageColor: '#ffffff',    // Benutzer-Nachrichten-Textfarbe
            botMessageBg: '#2c3e50',        // Bot-Nachrichten-Hintergrund
            botMessageColor: '#ecf0f1',     // Bot-Nachrichten-Textfarbe
            
            // Eingabebereich
            inputPadding: '25px 0 50px 0',  // Eingabebereich-Abstand
            inputBorderRadius: '15px',      // Eingabe-Randradius
            inputFontSize: '17px',          // Eingabe-Schriftgröße
            inputBorderColor: '#52687a',    // Eingabe-Randfarbe
            inputTextColor: '#ffffff',      // Eingabe-Textfarbe
            inputPlaceholderColor: '#95a5a6', // Platzhalter-Textfarbe
            
            // Willkommenstext
            welcomeTitleSize: '52px',       // Willkommens-Titel-Schriftgröße
            welcomeSubtitleSize: '20px',    // Willkommens-Untertitel-Schriftgröße
            welcomeTitleColor: '#ffffff',   // Willkommens-Titel-Farbe
            welcomeSubtitleColor: '#bdc3c7', // Willkommens-Untertitel-Farbe
            
            // Schaltflächen
            buttonBg: '#e74c3c',            // Schaltflächen-Hintergrund
            buttonColor: '#ffffff',         // Schaltflächen-Textfarbe
            buttonHoverBg: '#c0392b'        // Schaltflächen-Hover-Hintergrund
        }
    };
</script>

Alternative: Externes CSS-Override

Für erweiterte Anpassungen können Sie externes CSS verwenden, um das Vollbild-Modus-Styling zu überschreiben:

<style>
    :root {
        --fs-overlay-bg: #1a1a2e !important;
        --fs-header-bg: #16213e !important;
        --fs-user-message-bg: #4a90e2 !important;
        --fs-bot-message-bg: #2c3e50 !important;
        --fs-welcome-title-color: #ffffff !important;
    }
    
    .hybridai-fullscreen-overlay {
        font-family: 'Ihre Benutzerdefinierte Schrift', sans-serif !important;
    }
</style>

Verfügbare CSS-Variablen

Der Vollbild-Modus unterstützt die folgenden CSS-Variablen, die überschrieben werden können:

• --fs-overlay-bg – Hintergrundfarbe des Vollbild-Overlays
• --fs-header-bg – Header-Hintergrundfarbe
• --fs-header-border-color – Header-Randfarbe
• --fs-header-padding – Header-Abstand
• --fs-content-max-width – Maximale Inhaltsbreite
• --fs-content-padding – Inhaltsbereich-Abstand
• --fs-message-max-width – Maximale Nachrichtenbreite
• --fs-message-padding – Nachrichten-Abstand
• --fs-message-border-radius – Nachrichten-Randradius
• --fs-message-font-size – Nachrichten-Schriftgröße
• --fs-user-message-bg – Benutzer-Nachrichten-Hintergrund
• --fs-user-message-color – Benutzer-Nachrichten-Textfarbe
• --fs-bot-message-bg – Bot-Nachrichten-Hintergrund
• --fs-bot-message-color – Bot-Nachrichten-Textfarbe
• --fs-input-padding – Eingabebereich-Abstand
• --fs-input-border-radius – Eingabe-Randradius
• --fs-input-font-size – Eingabe-Schriftgröße
• --fs-input-border-color – Eingabe-Randfarbe
• --fs-input-text-color – Eingabe-Textfarbe
• --fs-input-placeholder-color – Eingabe-Platzhalter-Farbe
• --fs-welcome-title-size – Willkommens-Titel-Schriftgröße
• --fs-welcome-subtitle-size – Willkommens-Untertitel-Schriftgröße
• --fs-welcome-title-color – Willkommens-Titel-Farbe
• --fs-welcome-subtitle-color – Willkommens-Untertitel-Farbe
• --fs-button-bg – Schaltflächen-Hintergrundfarbe
• --fs-button-color – Schaltflächen-Textfarbe
• --fs-button-hover-bg – Schaltflächen-Hover-Hintergrundfarbe

4. KI-Einstellungen

HybridAI bietet eine umfassende Auswahl modernster KI-Modelle, die jeweils für verschiedene Anwendungsfälle und Anforderungen optimiert sind. Unsere Plattform unterstützt führende Anbieter wie OpenAI, Google, Mistral und weitere, sowohl cloud-basiert als auch selbst gehostet.

4.1 KI-Modell-Auswahl

Wählen Sie aus unserer sorgfältig kuratierten Auswahl von KI-Modellen, die jeweils unterschiedliche Vorteile bieten:

Die KI-Einstellungsoberfläche zeigt Anweisungsbearbeitung, Optimierungstools, Modellauswahl und Temperaturkontrolle.

OpenAI-Modelle – Branchenführende Fähigkeiten

GPT-4 und GPT-3.5 Turbo repräsentieren den aktuellen Goldstandard in der Konversations-KI:

• Stärken: Überlegene Denkfähigkeiten, exzellente Anweisungsbefolgung, robuste Funktionsaufrufe, außergewöhnliche Code-Generierung
• Optimal für: Komplexe Problemlösung, professionelle Unterstützung, technischer Support, kreative Aufgaben
• Sprachunterstützung: Exzellente mehrsprachige Fähigkeiten mit hochwertigen Antworten in über 100 Sprachen
• Zuverlässigkeit: Hochkonsistente Ausgaben mit umfangreichen Sicherheitsvorkehrungen

Google Gemini – Herausragende Leistung

Gemini Pro und Gemini Pro Vision liefern außergewöhnliche Leistung mit erweiterten Fähigkeiten:

• Stärken: Exzellente Denkfähigkeiten, starke mehrsprachige Unterstützung, überlegene mathematische Fähigkeiten, integriertes Bildverständnis
• Optimal für: Datenanalyse, Forschungsunterstützung, Bildungsinhalte, multimodale Interaktionen
• Besondere Features: Natives Bildverständnis, längere Kontextfenster, optimiert für faktische Genauigkeit
• Leistung: Schnelle Antwortzeiten mit hochwertigen Ausgaben, exzellentes Kosten-Leistungs-Verhältnis

Mistral-Modelle – Europäischer Union Stack

Mistral Large und Mistral Medium bieten EU-konforme KI-Lösungen mit exzellenter Leistung:

• Stärken: EU-Datensouveränität, DSGVO-Konformität, starke mehrsprachige europäische Sprachunterstützung, exzellente Denkfähigkeiten
• Optimal für: Europäische Unternehmen, regulierte Industrien, datenschutzsensible Anwendungen, mehrsprachiger europäischer Support
• Compliance: Mit europäischen Datenschutzstandards entwickelt, Datenverarbeitung innerhalb der EU-Infrastruktur
• Sprachen: Außergewöhnliche Leistung in Französisch, Deutsch, Spanisch, Italienisch und anderen europäischen Sprachen
• Zuverlässigkeit: Konsistente, professionelle Antworten mit integrierten Sicherheitsmaßnahmen

Spezialisierte und selbst gehostete Modelle

Für spezifische Anforderungen unterstützen wir auch:

• Perplexity: Optimiert für Forschung und Faktenprüfung mit Echtzeit-Websuchfähigkeiten
• Benutzerdefinierte Modelle: Teuken, Occiglot, Dolphin und andere spezialisierte Modelle auf Anfrage verfügbar
• Selbst gehostete Lösungen: Modelle auf Ihrer eigenen Infrastruktur für maximale Kontrolle und Privatsphäre
• Lokale Modelle: Ollama-Integration für vollständig offline KI-Fähigkeiten

Richtlinien für Modellauswahl

Wählen Sie Ihr KI-Modell basierend auf Ihren spezifischen Bedürfnissen:

• Für maximale Fähigkeiten: OpenAI GPT-4 – beste Gesamtleistung und Denkfähigkeiten
• Für Kosteneffizienz: Google Gemini Pro – exzellente Leistung zu wettbewerbsfähigen Preisen
• Für EU-Konformität: Mistral Large – europäische Datensouveränität mit hoher Leistung
• Für Forschungsaufgaben: Perplexity – Echtzeitinformationen und Faktenprüfung
• Für Privatsphäre: Selbst gehostete oder lokale Modelle – vollständige Datenkontrolle

4.2 Anweisungsoptimierung

Das Anweisungssystem ist das Fundament der Persönlichkeit, des Wissens und Verhaltens Ihres Chatbots. Gut formulierte Anweisungen sind entscheidend für die Erstellung effektiver, ansprechender und hilfreicher KI-Assistenten.

Warum Anweisungen wichtig sind

Die Anweisungen Ihres Chatbots fungieren als seine „DNA“ – sie bestimmen:

• Persönlichkeit: Wie der Bot kommuniziert, seinen Ton und Stil
• Expertise: Was der Bot weiß und wie er Wissen anwendet
• Verhalten: Wie der Bot verschiedene Situationen und Grenzfälle behandelt
• Grenzen: Was der Bot tun sollte und nicht tun sollte
• Kontext: Wie der Bot Ihr Unternehmen und Ihre Benutzer versteht

HybridAIs Anweisungsoptimierungs-Tools

HybridAI bietet leistungsstarke Tools, um Ihnen bei der Erstellung und Optimierung effektiver Anweisungen zu helfen:

1. KI-gestützte Optimierung

Verwenden Sie den „Optimieren“-Button, um Ihre Anweisungen automatisch zu verbessern:

• Inhaltsanalyse: KI analysiert Ihre aktuellen Anweisungen auf Klarheit, Vollständigkeit und Effektivität
• Verbesserungsvorschläge: Erhält spezifische Empfehlungen zur Verbesserung
• Strukturoptimierung: Verbessert Organisation und logischen Ablauf
• Sprachverfeinerung: Verbessert Klarheit und beseitigt Mehrdeutigkeiten
• Best Practices: Wendet bewährte Anweisungsschreibtechniken an

2. Website-basierte Anweisungsgenerierung

Verwenden Sie die „URL verwenden“-Funktion, um automatisch Anweisungen von Ihrer Website abzuleiten:

• Inhaltsextraktion: KI analysiert den Inhalt, Ton und Zweck Ihrer Website
• Markentonfall-Erkennung: Identifiziert Ihren Kommunikationsstil und Ihre Markenpersönlichkeit
• Automatische Generierung: Erstellt umfassende Anweisungen basierend auf Ihrer Website
• Kontextintegration: Integriert Ihr Geschäftsmodell, Dienstleistungen und Zielgruppe
• Ausgangspunkt: Bietet eine solide Grundlage, die Sie weiter anpassen können

Best Practices für effektive Anweisungen

Befolgen Sie diese Richtlinien, um leistungsstarke Anweisungen zu erstellen:

Struktur und Organisation

• Klare Rollendefinition: Beginnen Sie mit „Du bist…“, um die Identität des Bots zu etablieren
• Spezifische Expertise: Definieren Sie Wissensbereiche und Spezialisierungen
• Verhaltensrichtlinien: Spezifizieren Sie, wie der Bot kommunizieren und handeln soll
• Grenzensetzung: Geben Sie klar an, was der Bot nicht kann oder nicht tun sollte

Inhaltselemente

• Geschäftskontext: Fügen Sie Informationen über Ihr Unternehmen, Produkte und Dienstleistungen hinzu
• Zielgruppe: Beschreiben Sie Ihre typischen Benutzer und deren Bedürfnisse
• Ton und Stil: Spezifizieren Sie förmlich/informell, freundlich/professionell, etc.
• Beispiele: Geben Sie Beispielinteraktionen an, um das Verhalten zu leiten
• Grenzfälle: Behandeln Sie, wie schwierige oder ungewöhnliche Situationen zu handhaben sind

Workflow zur Anweisungsoptimierung

Befolgen Sie diesen Prozess, um optimale Anweisungen zu erstellen:

1. Mit URL beginnen: Verwenden Sie Ihre Website-URL, um anfängliche Anweisungen zu generieren
2. Überprüfen und Anpassen: Modifizieren Sie den generierten Inhalt entsprechend Ihren spezifischen Bedürfnissen
3. Spezifika hinzufügen: Fügen Sie einzigartige Geschäftsinformationen, Verfahren oder Richtlinien hinzu
4. Optimieren: Verwenden Sie den „Optimieren“-Button, um zu verfeinern und zu verbessern
5. Testen und Iterieren: Testen Sie mit echten Gesprächen und verfeinern Sie basierend auf der Leistung
6. Regelmäßige Updates: Halten Sie Anweisungen aktuell, während sich Ihr Unternehmen entwickelt

4.3 Zusätzliche KI-Konfiguration

Über Modellauswahl und Anweisungen hinaus bietet das KI-Einstellungspanel zusätzliche Optionen zum:

• Auswählen bevorzugter KI-Engines und Konfigurieren von Fallback-Optionen
• Anpassen von Wissensquellen und Dokumentenverarbeitung
• Aktivieren erweiterter Funktionsaufrufe für spezifische Anwendungsfälle
• Konfigurieren von Sensing & Triggers für Benachrichtigungen bei menschlicher Übernahme
• Einrichten von emotionaler Intelligenz und Sentimentanalyse
• Konfigurieren von Antwortlänge und Formatierungseinstellungen
• Einrichten von Prompt-Plugins für dynamischen Persönlichkeitswechsel

4.4 Prompt-Plugins – Dynamische Persönlichkeitsmodule

Prompt-Plugins ermöglichen es Ihrem Chatbot, automatisch zwischen verschiedenen Persönlichkeiten oder spezialisierten Anweisungssätzen basierend auf dem Gesprächskontext zu wechseln. Diese leistungsstarke Funktion ermöglicht es Ihrem Bot, seine Expertise und seinen Kommunikationsstil dynamisch anzupassen, ohne Benutzereingriff.

Prompt-Plugins verstehen

Wenn aktiviert, ersetzt ein Plugin die Basisanweisungen Ihres Bots vollständig durch spezialisierte Anweisungen, die für bestimmte Szenarien maßgeschneidert sind. Zum Beispiel:

• Ein Konfliktlöser-Plugin, das aktiviert wird, wenn Benutzer über Streitigkeiten oder Meinungsverschiedenheiten sprechen
• Ein Technischer Support-Plugin, das sich einschaltet, wenn Benutzer technische Probleme melden
• Ein Verkaufsassistent-Plugin, das bei Produktanfragen und Kaufentscheidungen aktiviert wird
• Ein Mathe-Tutor-Plugin, das übernimmt, wenn Benutzer mathematische Fragen stellen
• Ein Persönlicher Coach-Plugin für motivierende und selbstverbessernde Diskussionen

Konfiguration von Prompt-Plugins

Um Prompt-Plugins für Ihren Chatbot einzurichten:

1. Navigieren Sie zu Admin-Panel > KI-Einstellungen > Prompt-Plugins
2. Klicken Sie auf „Neues Plugin hinzufügen“, um ein Plugin zu erstellen
3. Konfigurieren Sie die folgenden Einstellungen:
   • Plugin-Name: Ein beschreibender Name für das Plugin (z.B. „Konfliktlöser“)
   • Plugin-Prompt: Die vollständigen Ersatzanweisungen, die die neue Persönlichkeit und das Verhalten des Bots definieren
   • Aktivierungskontext: Beschreibung, wann dieses Plugin aktiviert werden soll (z.B. „Wenn Benutzer über Konflikte, Meinungsverschiedenheiten oder zwischenmenschliche Probleme sprechen“)
   • Aktivierungsschwelle: Erforderliches Konfidenzniveau (0,0-1,0) für die Aktivierung. Höhere Werte erfordern eine stärkere Kontextübereinstimmung
4. Klicken Sie auf „Plugin speichern“, um es zur Konfiguration Ihres Bots hinzuzufügen

Wie die Plugin-Aktivierung funktioniert

Das Plugin-System verwendet intelligente Kontextanalyse:

1. Jede eingehende Nachricht wird gegen die Aktivierungskontexte aller aktiven Plugins analysiert
2. Das System bewertet, wie gut die Nachricht zum Kontext jedes Plugins passt (0-1 Konfidenzwert)
3. Wenn die Konfidenz eines Plugins seinen Schwellenwert überschreitet, wird es aktiviert
4. Wenn mehrere Plugins qualifiziert sind, gewinnt dasjenige mit der höchsten Konfidenz
5. Die Basisanweisungen des Bots werden vollständig durch die Anweisungen des Plugins ersetzt
6. Das Plugin bleibt für die Dauer dieser Konversationssitzung aktiv

Testen und Verwalten von Plugins

Die Prompt-Plugins-Oberfläche bietet Werkzeuge zum Testen und Verwalten:

• Plugin-Aktivierung testen: Geben Sie Beispielnachrichten ein, um zu sehen, welches Plugin aktiviert würde und mit welcher Konfidenz
• Aktuelle Aktivierungen anzeigen: Überwachen Sie, welche Plugins in tatsächlichen Gesprächen ausgelöst wurden
• Plugins aktivieren/deaktivieren: Deaktivieren Sie Plugins vorübergehend, ohne sie zu löschen
• Plugin-Einstellungen bearbeiten: Passen Sie Schwellenwerte und Kontexte basierend auf der Leistung an
• Plugins löschen: Entfernen Sie Plugins, die nicht mehr benötigt werden

Best Practices für Prompt-Plugins

Um das Beste aus Prompt-Plugins herauszuholen:

• Klare Kontextbeschreibungen: Schreiben Sie spezifische, eindeutige Aktivierungskontexte, um Fehlauslösungen zu vermeiden
• Angemessene Schwellenwerte: Beginnen Sie mit 0,7 und passen Sie basierend auf Tests an – niedriger für breitere Aktivierung, höher für Präzision
• Vollständige Anweisungen: Jedes Plugin sollte umfassende Anweisungen enthalten, da es den Basis-Prompt vollständig ersetzt
• Gründlich testen: Verwenden Sie das Testwerkzeug, um zu überprüfen, dass Plugins korrekt aktiviert werden, bevor Sie sie einsetzen
• Aktivierungen überwachen: Überprüfen Sie Aktivierungsprotokolle, um sicherzustellen, dass Plugins angemessen ausgelöst werden
• Überschneidungen vermeiden: Entwerfen Sie Plugins mit unterschiedlichen Kontexten, um Verwirrung darüber zu vermeiden, welches aktiviert werden soll

5. Wissensdatenbank-Erweiterung

HybridAI ermöglicht es Ihnen, die Wissensdatenbank Ihres Chatbots durch Dokumenten-Uploads und Web-Crawling zu erweitern, sodass Ihr Bot besser über spezifische Themen informiert ist, die für Ihr Unternehmen oder Ihren Anwendungsfall relevant sind.

5.1 Dokument-Upload

Im Bereich Admin-Panel > KI-Einstellungen > Chat & Wissen können Sie verschiedene Dokumenttypen hochladen:

• PDF-Dokumente: Technische Dokumentation, Broschüren, Handbücher, Bücher
• Word-Dokumente (.docx): Berichte, Artikel, Verfahren
• CSV-Dateien: Datentabellen, Produktkataloge, statistische Informationen
• Textdateien (.txt): Einfache Textinformationen, Code-Snippets, Notizen

Hochgeladene Dokumente werden verarbeitet und in ein Format konvertiert, das es der KI ermöglicht, dieses Wissen beim Beantworten von Benutzerfragen zu referenzieren und zu nutzen. Das System extrahiert automatisch den Inhalt und bewahrt dabei die Struktur und Beziehungen zwischen verschiedenen Teilen des Dokuments.

5.2 Web-Crawling

HybridAI bietet eine leistungsstarke Web-Crawling-Funktion, die es Ihrem Chatbot ermöglicht, aus Website-Inhalten zu lernen:

1. Navigieren Sie zu Admin-Panel > KI-Einstellungen > Chat & Wissen
2. Finden Sie den Abschnitt Web-Crawling
3. Geben Sie die Basis-URL ein, von der der Bot lernen soll (z.B. „https://ihredomain.de/wissen/“)
4. Legen Sie die maximale Anzahl der zu crawlenden Seiten fest (empfohlen: beginnen Sie mit 10-20 Seiten)
5. Klicken Sie auf „Crawling starten“, um den Prozess zu beginnen

Das System erkundet automatisch die Website, folgt Links von der angegebenen URL und extrahiert Inhalte, die in die Wissensdatenbank Ihres Chatbots aufgenommen werden. Der Crawling-Fortschritt wird in Echtzeit angezeigt und zeigt, welche Seiten gerade verarbeitet werden.

5.3 Wissensmanagement

Nach dem Hochladen von Dokumenten oder dem Crawlen von Websites können Sie Ihre Wissensdatenbank verwalten:

• Anzeigen aller hochgeladenen Dateien im Wissensrepositorium
• Löschen veralteter oder irrelevanter Dokumente
• Aktualisieren von Dateien durch Hochladen neuerer Versionen (das System ersetzt sie automatisch)

Die KI wird dieses Wissen automatisch in Gespräche einbeziehen, wenn relevante Fragen gestellt werden.

6. Bild-Integration

HybridAI unterstützt die Bild-Integration, die es Ihrem Chatbot ermöglicht, während Gesprächen relevante Bilder anzuzeigen, um das Benutzerengagement und die Informationsvermittlung zu verbessern.

6.1 Hochladen von Bildern

Um Bilder zur Bibliothek Ihres Chatbots hinzuzufügen:

1. Gehen Sie zu Admin-Panel > KI-Einstellungen > Chat & Wissen
2. Scrollen Sie zum Abschnitt Bild hochladen
3. Wählen Sie eine Bilddatei aus (unterstützte Formate: PNG, JPG, JPEG, GIF, SVG, WEBP)
4. Fügen Sie eine beschreibende Bildunterschrift hinzu, die erklärt, was das Bild zeigt
5. Klicken Sie auf „Bild hochladen“, um es zur Bibliothek Ihres Bots hinzuzufügen

6.2 Wie die Bild-Integration funktioniert

Bilder werden automatisch in das Anweisungssystem Ihres Chatbots integriert. Der Bot versteht:

• Was jedes Bild darstellt (basierend auf Ihrer Beschreibung)
• Wann es angemessen ist, bestimmte Bilder anzuzeigen
• Wie Bilder in Gesprächskontexten referenziert werden können

Wenn ein Benutzer eine Frage stellt oder ein Thema diskutiert, das mit einem Ihrer hochgeladenen Bilder zusammenhängt, kann der Chatbot wählen, das Bild neben seiner Textantwort anzuzeigen, um das Verständnis zu verbessern.

6.3 Verwalten von Bildern

Sie können Ihre Bildbibliothek über dieselbe Oberfläche verwalten:

• Alle hochgeladenen Bilder mit ihren Beschreibungen anzeigen
• Bilder löschen, die nicht mehr benötigt werden
• Beschreibungen aktualisieren, um das Verständnis des Bots darüber zu verbessern, wann jedes Bild verwendet werden soll

7. Website-Befehle

Website-Befehle ermöglichen es dem Chatbot, dynamisch mit Elementen auf der Webseite zu interagieren. Diese können Abschnitte hervorheben, Formulare ausfüllen, navigieren oder Seiteninhalt ändern.

7.1 Wie Website-Befehle funktionieren

Wenn ein Chatbot eine relevante Aktion erkennt, löst er ein JavaScript-Ereignis aus, das die Webseite modifiziert.

Um dies zu aktivieren, müssen Sie dies zur Anweisung des Bots hinzufügen, z.B. Wenn nach „Scope 1“ gefragt wird, füge den Befehl [CMD:highlight=Scope1] in deine Antwort ein.

Website-Befehle sind ein integraler Bestandteil des Website-Bots (der sich unten rechts auf der Website befindet), Sie müssen sie nur aktivieren, indem Sie sie zum Teil der Agenten-Anweisung machen (siehe Beispiel unten).

Website-Befehle zielen auf HTML-Elemente über ihre ID-Eigenschaft ab. Bitte verwenden Sie Eigenschaften in Kleinbuchstaben. Vermeiden Sie Leerzeichen in der ID-Eigenschaft und verwenden Sie stattdessen Unterstriche.
Wenn ein Befehl nicht ausgeführt werden kann, können Sie die Browser-Konsole überprüfen, um zu sehen, welches Element das System zu adressieren versucht hat.

7.2 Verfügbare Befehle

Befehl	Beschreibung
highlightElement(selector)	Hebt ein Webseiten-Element hervor.
fillInput(selector, value)	Füllt ein Eingabefeld mit einem vordefinierten Wert.
navigateTo(url)	Leitet den Benutzer zu einer anderen Webseite weiter.

8. Menschliche Übernahme

HybridAI enthält eine Menschliche Übernahme-Funktion, die es menschlichen Agenten ermöglicht, bei Bedarf nahtlos in eine Konversation einzugreifen.

8.1 Auslösen einer Übernahme

• Der Chatbot erkennt hohe emotionale Dringlichkeit oder Frustration
• Der Chatbot erkennt eine Geschäftsmöglichkeit oder ein Serviceproblem
• Ein Benutzer fordert ausdrücklich menschliche Unterstützung an.
• Ein Administrator übernimmt manuell über das Admin-Panel die Kontrolle.
• Der Bot-Betreiber erhält auch eine sofortige Benachrichtigung „Chat-Antwort erforderlich“ mit einem Link zur Antwortschnittstelle für schnelle Reaktion

8.2 Admin-Panel für Übernahme

Im Admin-Panel > Chat-Konsole können Administratoren:

• Live-Konversationen einsehen, einschließlich der Ergebnisse des Sensing-Modells.
• Eingreifen und manuelle Antworten senden.
• Bei Benachrichtigungen an Betreiber wird der Übernahme-Link in die Benachrichtigung eingebettet

8.3 Sensing & Trigger

In Sensing & Trigger können Sie den Schwellenwert anpassen, ab dem eine Sensing-Dimension beginnt, die Benachrichtigung zu aktivieren.

Es ist auch möglich, zwei benutzerdefinierte Dimensionen zu konfigurieren, die relevante Ereignisse für Ihren Anwendungsfall beschreiben.

8.4 Alarm‑Einstellungen (Admin‑Chat‑Konsole)

In der Admin‑Chat‑Konsole können Sie steuern, wie Alarme für Betreiber angezeigt werden:

• Browser‑Benachrichtigungen bei hohem Sentiment: Zeigt In‑Page‑Toasts und bei Bedarf Systembenachrichtigungen, wenn ein Messwert seinen Schwellenwert überschreitet.
• Ton abspielen: Spielt einen kurzen Klang zusammen mit der Benachrichtigung (erfordert einmalige Benutzerinteraktion pro Sitzung wegen Browser‑Richtlinien).
• Auch benachrichtigen, wenn Tab sichtbar ist: Wenn aktiviert, werden Systembenachrichtigungen auch im Vordergrund angezeigt.
• E‑Mail‑Benachrichtigungen senden: Sendet Alarm‑E‑Mails an den Bot‑Besitzer, wenn Schwellenwerte erreicht werden. Diese Einstellung gilt bot‑weit (in den Sensing‑Einstellungen gespeichert) und ist standardmäßig AUS.

Schwellenwerte werden in Sensing & Trigger konfiguriert. Alarme werden ausgelöst, sobald ein Messwert den konfigurierten Schwellenwert erreicht oder überschreitet.

9. KI-Funktionen & API-Integration

9.1 Funktionsaufrufe

HybridAI unterstützt Funktionsaufrufe zur Erweiterung der Chatbot-Fähigkeiten. Sie können vordefinierte Funktionen wie diese aktivieren:

• ISS-Position abrufen (Echtzeit-Satellitenverfolgung)
• Energiepreisabfragen
• Perplexity-Suche für aktuelle Informationen

Sie können die derzeit integrierten Funktionen ausprobieren, die auf der Funktionsaufruf-Seite zu finden sind. Kontaktieren Sie uns, wenn Sie Ihre eigenen Funktionen implementieren möchten. Aus Sicherheitsgründen wird dies später im Selbstbedienungsmodus verfügbar sein.

9.2 Bot-Memory-API (IoT & Externe Datenintegration)

HybridAI bietet eine Bot-Memory-API, mit der Sie externe Daten (wie IoT-Messungen, Benutzerpräferenzen oder Kontextinformationen) direkt in den Speicher Ihres Bots übertragen können. Dies ermöglicht Ihrem Bot, dauerhaftes Wissen zu haben, das seine Antworten verbessert.

Hauptfunktionen:

• Speichern von IoT-Sensordaten, Messungen und Telemetrie
• Externe Speicherung von Benutzerpräferenzen und Einstellungen
• Dynamische Aktualisierung des Bot-Wissens über API
• Organisation von Daten mit benutzerdefinierten Schlüsseln und Typen
• Automatische Integration in Bot-Konversationen

API-Endpunkte:

Speicher speichern/aktualisieren:

POST /v1/bot/memory
Authorization: Bearer IHR_API_SCHLÜSSEL
Content-Type: application/json

{
    "bot_id": "IHRE_BOT_ID",
    "memory_key": "temperatur_sensor_1",
    "memory_content": "Aktuelle Temperatur: 22,5°C, Luftfeuchtigkeit: 65%",
    "memory_type": "sensor_daten"  // optional, Standard: "general"
}

Speicher abrufen:

GET /v1/bot/memory?bot_id=IHRE_BOT_ID&memory_key=temperatur_sensor_1
Authorization: Bearer IHR_API_SCHLÜSSEL

Speicher löschen:

DELETE /v1/bot/memory?bot_id=IHRE_BOT_ID&memory_key=temperatur_sensor_1
Authorization: Bearer IHR_API_SCHLÜSSEL

Anwendungsfälle:

• IoT-Integration: Senden Sie Sensorwerte, Gerätezustände oder Alarme an Ihren Bot
• Persönlicher Assistent: Speichern Sie Benutzerziele wie „Ich möchte bis Jahresende abnehmen“
• Geschäftskontext: Aktualisieren Sie Lagerbestände, Preise oder Verfügbarkeit
• Dynamisches Wissen: Halten Sie den Bot über sich ändernde Bedingungen oder Zustände informiert

Beispiel: IoT-Temperaturüberwachung

import requests

# Ihr IoT-Gerät sendet Temperaturdaten
api_url = "https://hybridai.one/v1/bot/memory"
headers = {"Authorization": "Bearer IHR_API_SCHLÜSSEL"}

# Temperaturmessung aktualisieren
data = {
    "bot_id": "IHRE_BOT_ID",
    "memory_key": "büro_temperatur",
    "memory_content": "Bürotemperatur um 14:30 Uhr: 23,5°C (komfortabler Bereich)",
    "memory_type": "iot_sensor"
}

response = requests.post(api_url, json=data, headers=headers)

# Wenn Benutzer jetzt fragen "Wie ist die Bürotemperatur?", 
# hat der Bot diese Information in seinem Kontext

9.3 OpenAI-kompatible API

HybridAI bietet jetzt eine OpenAI-kompatible API, die es Ihnen ermöglicht, Ihre benutzerdefinierten Chatbots mit Ihren Anwendungen zu integrieren. Zu den wichtigsten Funktionen gehören:

• Standard OpenAI-kompatibles Endpunktformat
• Unterstützung für Completions und Chat-Completions
• API-Schlüsselverwaltung über das Admin-Panel
• Multi-Bot-Auswahl für verschiedene Anwendungsfälle

Verwendung der API

Um die API zu verwenden, generieren Sie zuerst einen API-Schlüssel im Bereich Admin-Panel > API-Schlüssel. Verwenden Sie dann die API mit Standard-Bibliotheken:

import openai

# Konfiguration mit Ihrem API-Schlüssel und der HybridAI-Basis-URL
openai.api_key = "IHR_API_SCHLÜSSEL"
openai.base_url = "https://hybridai.one/"

# Eine Chat-Completion-Anfrage stellen
response = openai.chat.completions.create(
    model="gpt-3.5-turbo",  # Sie können verfügbare Modelle verwenden
    messages=[
        {"role": "user", "content": "Hallo, Welt!"}
    ],
    chatbot_id="IHRE_BOT_ID"  # Geben Sie an, welchen Ihrer Bots Sie verwenden möchten
)

print(response.choices[0].message.content)

9.4 N8N Integration

HybridAI bietet eine native Integration mit N8N, einer leistungsstarken Workflow-Automatisierungsplattform. Diese Integration ermöglicht es Ihnen, komplexe Automatisierungen und Workflows direkt über natürliche Unterhaltung in Ihre Chatbots zu integrieren.

Was ist N8N?

N8N ist eine Open-Source-Workflow-Automatisierungsplattform, die es Ihnen ermöglicht, verschiedene Dienste und Anwendungen miteinander zu verbinden. Mit N8N können Sie:

• Automatisierte Workflows zwischen verschiedenen Plattformen erstellen
• Daten zwischen Systemen synchronisieren und transformieren
• Komplexe Geschäftsprozesse automatisieren
• Webhooks und APIs nahtlos integrieren
• Echtzeit-Benachrichtigungen und Alerts einrichten
• Datenbankoperationen und Dateiverarbeitung automatisieren

Wie die N8N Integration funktioniert

Die HybridAI N8N-Integration verwandelt Ihre N8N-Webhooks in KI-Funktionsaufrufe, die natürlich durch Unterhaltung ausgelöst werden können. So funktioniert es:

1. Webhook-Erkennung: Das System scannt automatisch Ihre N8N-Workflows nach Webhook-Triggern
2. Funktionserstellung: Erkannte Webhooks werden in KI-Funktionsaufrufe mit benutzerdefinierten Parametern umgewandelt
3. Natürliche Aktivierung: Benutzer bitten den Chatbot einfach in natürlicher Sprache, Aktionen durchzuführen
4. Automatische Ausführung: Die KI erkennt die Absicht und ruft den entsprechenden N8N-Workflow mit den korrekten Parametern auf

N8N Integration einrichten

So richten Sie die N8N-Integration für Ihren Chatbot ein:

1. Gehen Sie zu Admin Panel → KI-Einstellungen → N8N Integration
2. Geben Sie Ihren N8N-API-Schlüssel ein (erhalten Sie von n8n.hybridai.one)
3. Setzen Sie die N8N-Basis-URL (Standard: https://n8n.hybridai.one)
4. Klicken Sie auf „Webhooks entdecken“, um Ihre aktiven Workflows zu scannen
5. Klicken Sie für jeden Webhook auf „Funktionsaufruf erstellen“, um ihn in eine KI-Funktion umzuwandeln
6. Definieren Sie Funktionsparameter im JSON-Schema-Format
7. Testen Sie die Integration durch natürliche Unterhaltung

Die N8N-Integrationsoberfläche zeigt API-Konfiguration, Webhook-Erkennung und Funktionsaufruf-Verwaltung.

Funktionsaufrufe aus Webhooks erstellen

Beim Erstellen von Funktionsaufrufen aus N8N-Webhooks müssen Sie definieren:

• Funktionsname: Ein beschreibender Name wie „benachrichtigung_senden“ oder „aufgabe_erstellen“
• Beschreibung: Klare Erklärung, was die Funktion macht
• Parameter: JSON-Schema, das die Eingabeparameter definiert, die die KI sammeln soll

Beispiel Parameter-Schema

{
  "type": "object",
  "properties": {
    "nachricht": {
      "type": "string",
      "description": "Die zu sendende Benachrichtigung"
    },
    "empfaenger": {
      "type": "string", 
      "description": "E-Mail-Adresse oder Benutzername des Empfängers"
    },
    "prioritaet": {
      "type": "string",
      "enum": ["niedrig", "normal", "hoch"],
      "description": "Prioritätsstufe der Benachrichtigung"
    }
  },
  "required": ["nachricht", "empfaenger"]
}

Natürlichsprachliche Nutzung

Sobald N8N-Funktionen eingerichtet sind, können Benutzer sie natürlich aufrufen:

• Benutzer: „Bitte sende eine hohe Priorität Benachrichtigung an john@example.com, dass der Server wieder online ist“
• KI: Ruft automatisch die `benachrichtigung_senden` Funktion mit den extrahierten Parametern auf
• Ergebnis: N8N-Workflow wird ausgeführt und der Benutzer erhält eine Bestätigung

Anwendungsfälle

Beliebte Anwendungsfälle für die N8N-Integration:

• Kundensupport: Automatische Erstellung und Zuweisung von Support-Tickets
• Aufgabenmanagement: Erstellen und Zuweisen von Aufgaben an Teammitglieder
• Benachrichtigungen: Senden von Alerts per E-Mail, Slack, SMS oder anderen Plattformen
• Datenverarbeitung: Auslösen von Datenanalysen oder Berichterstellung
• E-Commerce: Bestellungen verarbeiten, Lagerbestand prüfen, Produktinformationen aktualisieren
• CRM-Integration: Leads erstellen, Kontaktinformationen aktualisieren, Interaktionen protokollieren

Beispiel: Kundensupport-Automatisierung

Ein praktisches Beispiel der N8N-Integration für Kundensupport:

1. Benutzer: „Ich habe Probleme mit meinem Account-Login“
2. KI: Ruft automatisch die `support_ticket_erstellen` Funktion auf
3. N8N-Workflow: Erstellt Ticket im Support-System, weist es dem entsprechenden Team zu
4. KI-Antwort: „Ich habe Support-Ticket #12345 für Ihr Login-Problem erstellt. Unser Team wird Sie innerhalb von 24 Stunden kontaktieren.“
5. Zusätzliche Aktionen: N8N kann Bestätigungs-E-Mail senden, Support-Team benachrichtigen, etc.

Native N8N-Instanz

Wir bieten eine native N8N-Instanz unter n8n.hybridai.one an, die speziell für die Integration mit HybridAI-Chatbots konfiguriert ist. Diese Instanz bietet:

• Optimierte Leistung für Chatbot-Integrationen
• Vorkonfigurierte Sicherheitseinstellungen
• Direkten API-Zugang für Webhook-Erkennung
• Dedizierten Support für HybridAI-Workflows

10. Analytics & Logs

HybridAI bietet Echtzeit-Analytics und Logs für Chatbot-Interaktionen. Besuchen Sie einfach die „Analytics“-Seite, um Zugriff zu erhalten auf:

• Benutzeraktivitätsmetriken und Browser-Informationen
• Konversationsanalysen und Interaktionsdaten
• Detaillierte Nutzungsprotokolle für die Fehlerbehebung
• KI-generierte Empfehlungen zur Plattformoptimierung

13. Multi-Bot-Verwaltung

HybridAI ermöglicht es Ihnen, mehrere Chatbots unter einem Konto zu erstellen und zu verwalten, jeder mit seiner eigenen Konfiguration:

• Nutzen Sie das Bot-Auswahlmenü, um zwischen Bots zu wechseln
• Erstellen Sie neue Bots mit der Option „Neuen Bot erstellen“
• Konfigurieren Sie jeden Bot unabhängig mit verschiedenen Einstellungen
• Teilen Sie bestimmte Bots mit Kollegen oder Kunden

14. Business Intent Extraktion

HybridAI bietet eine fortschrittliche Business Intent Extraktions-Funktion, die automatisch geschäftsrelevante Informationen aus Kundengesprächen mittels KI-Analyse identifiziert und extrahiert.

14.1 Überblick

Das Business Intent Extraktions-System analysiert Benutzernachrichten in Echtzeit, um wichtige Geschäftsinformationen zu identifizieren wie:

• Konkurrentennamen und Produkterwähnungen
• Firmennamen und Unternehmensreferenzen
• Produktinteresse und Service-Anfragen
• Standorterwähnungen und regionale Daten
• Benutzerdefinierte geschäftsspezifische Entitäten

14.2 Konfiguration

So konfigurieren Sie die Business Intent Extraktion:

1. Navigieren Sie zu Admin Panel → KI Sensing & Triggers
2. Scrollen Sie zum Bereich Business Intent Extraktion
3. Klicken Sie auf Intent-Typ hinzufügen um neue Extraktionsregeln zu erstellen
4. Definieren Sie Ihre benutzerdefinierten Entitätstypen mit beschreibenden Namen
5. Geben Sie klare Beschreibungen an, um die KI-Extraktion zu leiten
6. Aktivieren/deaktivieren Sie spezifische Entitätstypen nach Bedarf
7. Klicken Sie auf Intent-Konfiguration speichern

Beispiele für Entitätskonfiguration

• Entitätstyp: „konkurrenten_namen“ – Beschreibung: „Namen von konkurrierenden Unternehmen oder Produkten, die von Benutzern erwähnt werden“
• Entitätstyp: „produkt_interesse“ – Beschreibung: „Produkte oder Dienstleistungen, für die der Benutzer Interesse zeigt“
• Entitätstyp: „firmen_namen“ – Beschreibung: „Firmennamen oder Geschäftseinheiten, die in Gesprächen erwähnt werden“
• Entitätstyp: „preis_erwähnungen“ – Beschreibung: „Preis-, Budget- oder kostenbezogene Informationen“

14.3 Anzeige extrahierter Daten

So können Sie extrahierte Business Intents anzeigen und analysieren:

1. Navigieren Sie zu Admin Panel → Analytics
2. Zugriff auf die Business Intents Analytics Seite unter /admin_analytics_intents
3. Nutzen Sie die Filteroptionen um Ihre Ansicht zu verfeinern:
   • Datumsbereich: Filtern nach bestimmten Zeiträumen
   • Entitätstyp: Fokussierung auf spezifische Typen extrahierter Daten
4. Exportieren Sie Daten als CSV für weitere Analysen

14.4 Datenanalyse & Export

Das Business Intent Analytics Dashboard bietet:

• Echtzeitdaten: Anzeige extrahierter Intents während der Erfassung
• Erweiterte Filterung: Filter nach Datum, Entitätstyp oder Suchbegriffen
• CSV-Export: Download gefilterter Daten für externe Analysen
• Entitätsstatistiken: Überblick über Extraktionshäufigkeit und Muster
• Nachrichtenverfolgung: Verknüpfung zu ursprünglichen Gesprächen

14.5 Integration mit emotionalen KPIs

Business Intent Extraktion funktioniert nahtlos mit bestehender emotionaler KPI-Analyse:

• Beide Analysen nutzen einen einzigen KI-Aufruf für Effizienz
• Emotionale Dringlichkeit und Business Intents werden gleichzeitig erfasst
• Kombinierte Daten bieten umfassende Gesprächseinblicke
• Vereinheitlichte Analytics für emotionale und geschäftliche Intelligenz

14.6 Anwendungsfälle

Beliebte Anwendungen für Business Intent Extraktion umfassen:

• Wettbewerbsanalyse: Verfolgung von Konkurrentenerwähnungen und Marktanalysen
• Lead-Qualifizierung: Identifikation hochwertiger Interessenten und Geschäftsmöglichkeiten
• Produktentwicklung: Verstehen von Kundenbedürfnissen und Feature-Anfragen
• Marktforschung: Analyse von Kundenpräferenzen und Trends
• Vertriebsanalyse: Verfolgung von Preisdiskussionen und Kaufabsicht
• Kundeneinblicke: Aufbau umfassender Kundenprofile

15. Kontakt & Support

Für Support kontaktieren Sie service@hybridai.one oder besuchen Sie die HybridAI-Website.