Se connecter S'inscrire

HybridAI Benutzerhandbuch

Mit HybridAI erstellst du kundenorientierte ChatBots — Assistenten, die du auf deiner Website oder in deiner App einbettest, um Fragen zu beantworten, Leads zu erfassen und deine Nutzer zu unterstützen. Diese Dokumentation erklärt alles rund um Einrichtung, Konfiguration und Einbettung.

Darüber hinaus bieten wir mit HybridClaw ein eigenes KI-Agents-Framework: autonome KI-Kollegen, die recherchieren, Entwürfe erstellen, nachfassen und über deine Tools hinweg handeln. HybridClaw hat eine eigene Dokumentation: HybridClaw-Dokumentation →

Inhaltsverzeichnis

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

Der Workspace

Der Workspace: Chat mit Ihren Bots und HybridClaw-Agenten, Zugang zum Wissen und zum Admin-Bereich.

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.

HybridAI Chatbot Widget Integration

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

3.2 Konfiguration des Chatbots

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

Allgemeine Einstellungen

Allgemeine Einstellungen: Bot-Name, Farbe und weitere Optionen, rechts eine Live-Vorschau des Widgets.

3.3 Datenschutz-Kontrollen

HybridAI bietet umfassende Datenschutz-Kontrollen, um die Privatsphäre Ihrer Nutzer zu schützen und Datenschutzbestimmungen einzuhalten. Diese Einstellungen finden Sie unter Admin-Panel > Allgemeine Einstellungen > Datenschutz & Datensicherheit.

Bot-Level Datenschutzeinstellungen

Administratoren können folgende Datenschutzoptionen auf Bot-Ebene konfigurieren:

Nutzer-Level Datenschutzmodi

Wenn vom Administrator erlaubt, können Nutzer zwischen folgenden Modi wählen:

Datenschutz-Indikator

Ein visueller Indikator im Chat-Widget zeigt den aktuellen Datenschutzmodus an:

Admin-Sichtbarkeit

Im Admin-Panel werden private Nachrichten mit verschwommenem Inhalt angezeigt, sodass Administratoren Aktivitäten überwachen können, ohne den tatsächlichen Inhalt zu sehen. Dies gewährleistet sowohl Privatsphäre als auch notwendige Aufsicht.

Hinweis: Datenschutzeinstellungen werden sofort wirksam. Nachrichten, die im privaten Modus gesendet werden, werden niemals in lesbarer Form gespeichert und können nicht wiederhergestellt werden.

3.4 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.

Die Integrationsseite im Admin-Bereich

Die Integrationsseite im Admin-Bereich: Embed-Code Ihres Bots und die Integrationsmodi.

3.5 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

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,
        showAIAssistantSlogan: true,  // Aktiviert die AI Assistant Kennzeichnung
        customCSS: {
            borderRadius: "12px",
            boxShadow: "0 4px 20px rgba(0,0,0,0.15)"
        }
    };
</script>
<script src="https://hybridai.one/hai_embed.js"></script>
    

Hinweis: Besuchen Sie die Admin-Panel > Integration Seite, um Ihren spezifischen Einbettungscode zu erhalten und verschiedene Demo-Varianten zu testen.

3.6 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:

WordPress-Plugin Integration

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

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

Andere Plattform-Integrationen

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

Messaging-Plattform-Integrationen

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

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:

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:

Hinweis: Für spezielle Plattform-Integrationen oder benutzerdefinierte Lösungen kontaktieren Sie uns unter service@hybridai.one. Wir helfen Ihnen gerne bei der Implementierung.

3.7 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:

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

Wichtig: Die CSS-Anpassung ist vollständig optional. Wenn Sie keine Anpassungsoptionen angeben, funktioniert das Widget genau wie bisher mit den Standard-Inline-Stilen.

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:
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:

3.8 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:

Hinweis: Die Vollbild-Anpassung ist vollständig optional. Wenn Sie keine Vollbild-Konfiguration bereitstellen, verwendet das Widget ein Standard-Styling, das sich an Ihr gewähltes Design (hell/dunkel) anpasst.

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

Das Modell wählen Sie pro Bot unter KI-Einstellungen > Chat & Wissen. Zur Auswahl stehen derzeit die folgenden Modelle (Stand: November 2026).

KI-Einstellungen

KI-Einstellungen: Anweisungen bearbeiten und optimieren, Modell und Temperatur wählen.

OpenAI

Anthropic Claude

Google Gemini

Mistral

In Deutschland und der EU gehostete Modelle

Für Datensouveränität bieten wir Open-Weight-Modelle an, die vollständig in Deutschland bzw. der EU laufen:

Weitere Modelle

Eine Websuche (Perplexity) ist kein eigenes Chat-Modell, sondern steht jedem Bot als Funktion zur Verfügung, siehe 9.1 Funktionsaufrufe.

Welches Modell für welchen Zweck?

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:

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:

2. Website-basierte Anweisungsgenerierung

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

Best Practices für effektive Anweisungen

Befolgen Sie diese Richtlinien, um leistungsstarke Anweisungen zu erstellen:

Struktur und Organisation
Inhaltselemente

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

Profi-Tipp: Die effektivsten Anweisungen sind spezifisch, klar und umfassend. Zögern Sie nicht, detaillierte Informationen über Ihr Unternehmen, Prozesse und Benutzererwartungen einzuschließen. Die KI funktioniert besser mit mehr Kontext als mit weniger.

4.3 Zusätzliche KI-Konfiguration

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

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:

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:

Best Practices für Prompt-Plugins

Um das Beste aus Prompt-Plugins herauszuholen:

Hinweis: Prompt-Plugins werden von einem festen Analysemodell ausgewertet, unabhängig davon, welches Modell Sie für Chat-Antworten verwenden. So werden Plugins zuverlässig aktiviert, egal mit welchem Anbieter Ihr Bot antwortet.

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.

Für Wissen, das nicht an einen einzelnen Bot gebunden ist, sondern dem ganzen Unternehmen gehört und von KI-Agenten gepflegt wird, siehe Kapitel 16: Knowledge Collections.

Wissen & Material

Wissen & Material: RAG-Einstellungen, Datenquellen, Dokument-Upload und Web-Crawling an einem Ort.

5.1 Dokument-Upload

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

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.

Dokument-Metadaten-Header

Um die Organisation und Durchsuchbarkeit von Dokumenten zu verbessern, können Sie Metadaten-Header am Anfang Ihrer Dokumente (PDFs, Textdateien oder Markdown-Dateien) hinzufügen. Das System extrahiert diese Metadaten automatisch beim Upload und speichert sie mit jedem Dokumentenabschnitt, wodurch Ihre Inhalte besser auffindbar und organisiert werden.

Unterstützte Metadaten-Formate:

1. YAML Front Matter (Markdown-Stil):

---
title: Produktdokumentation Q4 2024
date: 2024-10-15
author: Johann Schmidt
category: Technische Dokumentation
---
Ihr Dokumenteninhalt beginnt hier...

2. Markdown-Header:

### METADATA ###
title: Benutzerhandbuch v2.0
date: 2024-10-15
version: 2.0
department: Entwicklung
###
Ihr Dokumenteninhalt beginnt hier...

3. Tagged-Format:

[METADATA]
title: Jahresbericht 2024
date: 2024-10-15
topics: Finanzen, Strategie, Wachstum
guest: CFO Michael Johnson
[/METADATA]
Ihr Dokumenteninhalt beginnt hier...

4. Einfaches Schlüssel-Wert-Format:

Title: Schulungsmaterialien
Date: 2024-10-15
Episode: 42
Topics: KI, Maschinelles Lernen, Best Practices

Ihr Dokumenteninhalt beginnt hier...

Erkannte Metadaten-Felder:

Best Practice: Platzieren Sie Metadaten ganz am Anfang Ihres Dokuments (erste Seite bei PDFs). Das System erkennt und extrahiert diese Informationen automatisch, wodurch Ihre Dokumente in der Wissensdatenbank besser durchsuchbar und organisiert werden. Dies ist besonders nützlich für Dokumentenserien, Schulungsmaterialien oder Inhalte mit mehreren Episoden oder Versionen.

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.

Hinweis: Für beste Ergebnisse richten Sie den Crawler auf bestimmte Abschnitte Ihrer Website, die die relevantesten Informationen enthalten. Vermeiden Sie das Crawlen sehr großer Websites auf einmal, indem Sie mit den wichtigsten Abschnitten beginnen.

5.3 Wissensmanagement

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

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:

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:

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

BefehlBeschreibung
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

8.2 Admin-Panel für Übernahme

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

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.

Erkennung & Auslöser

Erkennung & Auslöser: Schwellenwerte, ab denen der Bot-Betreiber benachrichtigt wird.

8.4 Alarm‑Einstellungen (Admin‑Chat‑Konsole)

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

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

Die Message-Konsole mit den Alarm-Einstellungen für kritische Nachrichten.

Die Message-Konsole mit den Alarm-Einstellungen für kritische Nachrichten.

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:

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.

Funktionen & Aktionen

Funktionen & Aktionen: Funktionsaufrufe per Schalter für den Bot aktivieren.

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:

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:

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
Hinweis: Die Bot-Memory-API verwendet denselben API-Schlüssel wie die OpenAI-kompatible API. Generieren Sie Ihren API-Schlüssel im Admin-Panel > API-Schlüssel Bereich.

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:

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:

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
N8N-Integration

N8N-Integration: API-Key und Basis-URL Ihrer N8N-Instanz hinterlegen.

Funktionsaufrufe aus Webhooks erstellen

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

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:

Anwendungsfälle

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

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:

Erste Schritte: Greifen Sie auf Ihre N8N-Instanz unter n8n.hybridai.one mit Ihren HybridAI-Zugangsdaten zu. Die N8N-Integration ist im Admin Panel unter KI-Einstellungen → N8N Integration verfügbar.

10. Analytics & Logs

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

13. Multi-Bot-Verwaltung

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

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:

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

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:

14.5 Integration mit emotionalen KPIs

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

14.6 Anwendungsfälle

Beliebte Anwendungen für Business Intent Extraktion umfassen:

Hinweis: Business Intent Extraktion erfordert aktive Konfiguration um zu funktionieren. Standardmäßig werden keine Entitäten extrahiert, bis Sie benutzerdefinierte Entitätstypen in den KI Sensing Einstellungen definieren.

15. Prompt Tuning Klinik

Die Prompt Tuning Klinik ist ein leistungsstarkes Werkzeug zur systematischen Verbesserung der Chatbot-Antworten durch Sammlung von Trainingsdaten und KI-gesteuerte Optimierung. Diese Funktion ermöglicht sowohl manuelles Feintuning als auch automatisierte Prompt-Verbesserung mit fortgeschrittenen Machine-Learning-Techniken.

15.1 Übersicht & Warum es wichtig ist

Die Leistung jedes Chatbots hängt stark von der Qualität seines System-Prompts (Anweisungen) ab. Die Prompt Tuning Klinik hilft Ihnen:

Durch das Sammeln von Feedback zu tatsächlichen Gesprächen erstellen Sie einen Datensatz, der echte Benutzerbedürfnisse und -präferenzen erfasst, was zu genaueren und hilfreicheren Chatbot-Antworten führt.

15.2 Workflow zur Sammlung von Trainingsdaten

Die Klinik bietet drei Methoden zum Aufbau Ihres Trainingsdatensatzes:

1. Chat-Verlauf Feedback

  1. Überprüfen Sie tatsächliche Gespräche Ihres Chatbots
  2. Wählen Sie einen Trainingskontext (z.B. "Kundensupport", "Vertrieb", "Technisch")
  3. Optional: Definieren Sie ein Trainingsziel (z.B. "Empathischer sein", "Kürzere Antworten geben")
  4. Klicken Sie 👍 für gute Antworten oder 👎 für schlechte
  5. Das Gespräch wird mit Ihrem Feedback zu Trainingsdaten

2. Manuelle Beispielerstellung

  1. Schreiben Sie ideale Benutzerfragen und Bot-Antworten
  2. Erstellen Sie Beispiele, die gewünschtes Verhalten demonstrieren
  3. Beispiele erscheinen als Kandidaten, die Feedback benötigen
  4. Wenden Sie 👍 oder 👎 an, um sie zu Ihren Trainingsdaten hinzuzufügen

3. Synthetische Datengenerierung

  1. KI generiert vielfältige Beispiele basierend auf Ihrem Kontext und Zielen
  2. Geben Sie die Anzahl der zu erstellenden Beispiele an (Standard: 10)
  3. Überprüfen Sie generierte Kandidaten
  4. Wenden Sie Feedback an, um jedes Beispiel zu akzeptieren oder abzulehnen

Wichtig: Alle Beispiele (manuell, synthetisch oder aus dem Chat-Verlauf) beginnen als neutrale Kandidaten. Erst nachdem Sie explizites Feedback (👍 oder 👎) geben, werden sie Teil Ihres Trainingsdatensatzes. Dies stellt die Qualitätskontrolle über alle Trainingsdaten sicher.

15.3 Visuelles Feedback-System

Die Klinik verwendet Farbcodierung, um den Datenstatus auf einen Blick zu zeigen:

15.4 Trainingskontexte & Ziele

Trainingskontexte (Erforderlich)

Kontexte organisieren Ihre Trainingsdaten nach Anwendungsfall oder Gesprächstyp:

Trainingsziele (Optional aber empfohlen)

Ziele definieren, was Sie verbessern möchten:

Prompt Tuning Klinik

Prompt Tuning Klinik: Trainingskontext wählen, Ziel festlegen, Daten ansehen und exportieren.

15.5 Automatisierte Prompt-Optimierung

Sobald Sie Trainingsdaten gesammelt haben, nutzen Sie die DSPy-gestützte Optimierungs-Engine:

Optimierungsmodi

So funktioniert es

  1. Analysiert positive und negative Beispiele in Ihren Trainingsdaten
  2. Identifiziert Muster darin, was Antworten gut oder schlecht macht
  3. Generiert verbesserte Anweisungen, die positive Muster fördern
  4. Liefert Metriken mit Vertrauens- und Verbesserungswerten
  5. Ermöglicht sofortiges Deployment oder weitere Tests

15.6 Datenexport & Modell-Feintuning

Exportieren Sie Ihre Trainingsdaten für erweiterte Anwendungsfälle:

Exportformate

Vorteile des Feintunings

Mit ausreichenden Trainingsdaten (typischerweise 100+ Beispiele) können Sie:

15.7 Datenüberprüfung & Verwaltung

Die "Daten anzeigen"-Funktion bietet umfassende Datenverwaltung:

Filteroptionen

Massenoperationen

15.8 Best Practices

Datensammlung

Optimierungsstrategie

Kontext-Management

Profi-Tipp: Die Prompt Tuning Klinik funktioniert am besten als iterativer Prozess. Klein anfangen, optimieren, testen, mehr Feedback sammeln und kontinuierlich verfeinern. Dies schafft einen positiven Kreislauf der Verbesserung basierend auf echten Benutzerbedürfnissen.

16. Knowledge Collections (Unternehmenswissen)

Knowledge Collections sind eine gemeinsame Wissensbasis Ihres Unternehmens. HybridClaw-Agenten bauen sie aus Dokumenten und Webseiten auf und halten sie aktuell; Ihr Team liest, durchsucht und korrigiert sie in der Web-App. Anders als die Wissensdatenbank eines Bots (Kapitel 5) gehört eine Collection dem Unternehmen, nicht einem einzelnen Bot.

16.1 Überblick

16.2 Einrichten

Öffnen Sie in der Web-App links Wissen und wählen Sie Wissen einrichten. HybridAI legt die Wissensbasis Ihres Unternehmens an und startet einen eigenen Agenten, den Knowledge Curator. Danach erscheint auf der Seite Mit dem Kurator chatten. Geben Sie dem Kurator ein erstes Dokument oder einen Link und bitten Sie ihn, daraus Seiten zu schreiben.

Admins und Inhaber können über Neue Collection weitere Collections anlegen.

Ein Klick auf „Wissen einrichten“ legt die Unternehmens-Collection an und startet den Kurator-Agenten.

Ein Klick auf „Wissen einrichten“ legt die Unternehmens-Collection an und startet den Kurator-Agenten.

16.3 Die Wissensseite

16.4 Quellen hinzufügen

Über Quelle hinzufügen nehmen Sie eine Datei oder eine Webseite auf:

Die Quelle erscheint im Seitenbaum unter Quellen als schreibgeschützte Seite mit Herkunftsangabe. Sie wird durchsucht, aber nicht bearbeitet; Ihr Agent schreibt daraus Wissensseiten, die auf die Quelle verweisen.

16.5 Mit Agenten arbeiten

Jeder HybridClaw-Agent erreicht die Knowledge Collections ohne Einrichtung über die HybridAI-Werkzeuge: Collections auflisten, Seiten lesen, suchen, schreiben und Quellen ablegen, jeweils mit den Rechten seines Nutzers. Ein Agent überschreibt eine Seite nur, wenn er ihre aktuelle Fassung kennt.

Beispiele für Nachrichten an einen Agenten:

Hinweis: Haben Sie unter Connectors > Wissensdatenbanken die Dokumente eines Bots für Agenten freigegeben, durchsucht die Suche der Agenten diese Dokumente mit.

16.6 Seitenformat

Wissensseiten sind Markdown-Dateien mit einem Kopfbereich (YAML-Frontmatter). Die Ordner entities/, concepts/, analyses/ und sources/ bestimmen den Seitentyp; Verweise auf andere Seiten schreiben Sie als [[entities/acme]].

---
title: Acme GmbH
type: entity
tags: [kunde, enterprise]
summary: Größter Kunde in der DACH-Region.
sources: [raw/vertrag-2026.md]
---
# Acme GmbH

Kunde seit 2024, siehe [[concepts/preismodell]].

Die Übersicht verwendet Titel, Typ, Schlagworte und die einzeilige Zusammenfassung; geben Sie die Zusammenfassung deshalb immer an.

16.7 Rollen und Rechte

Eine Collection ist nur für Personen mit einer Rolle in Ihrem Unternehmen sichtbar. Jede Änderung wird protokolliert. Indexierung und Suche werden nach Nutzung abgerechnet.

17. Sales Companion und eingebautes CRM

Der Sales Companion ist ein Assistent für den Außendienst. Nach einem Termin sprechen Vertriebsmitarbeitende eine Minute mit ihm, und er legt den Besuchsbericht ab, erstellt ein Angebot oder beantwortet Fragen zu Kunden, Umsätzen und Verträgen. Dazu gehört ein eingebautes CRM, das der Assistent selbst pflegt.

17.1 Überblick

Mit der Aktivierung richtet HybridAI vier Bausteine für Sie ein:

17.2 Aktivieren

Öffnen Sie Ihre Kontoseite und wählen Sie in der Karte Produkte beim Sales Companion Aktivieren. Die Einrichtung dauert bis zu einer Minute, weil der Agent gestartet wird. Ist ein Baustein nicht fertig geworden, steht dort Einrichtung abschließen; die Karte zeigt für Agent, Chatbot und Mini-CRM jeweils den Stand. Alternativ starten Sie den Sales Companion bei der Registrierung über die Sales-Companion-Seite oder über die Willkommenskachel in der Web-App.

Bestehende Datenquellen Ihres Kontos (Geschäftsdaten) gibt HybridAI dem neuen Bot bei der Einrichtung automatisch frei. Ein Wechsel zu einem anderen Produkt löscht nichts.

17.3 Die Produktseite

Unter Ihre Produktseite auf der Kontoseite legen Sie fest:

Die Seite hat diese Bereiche:

Die CRM-Ablage an der Seite zeigt Personen, Firmen, Deals und Dokumente (Besuchsberichte, Angebote, Aufgaben). Die Ansichten sind schreibgeschützt; Änderungen nehmen Sie über den Assistenten vor. Dokumente lassen sich entfernen.

17.4 Das eingebaute CRM

Bevor der Assistent eine Firma oder einen Kontakt anlegt, prüft er auf Dubletten und fragt nach. Löschen geschieht nur nach ausdrücklicher Bestätigung; mit einer Firma werden auch ihre Kontakte, Deals und Aktivitäten gelöscht, abgelegte Dokumente bleiben.

Fragen zum CRM beantwortet der Assistent direkt aus den Daten, zum Beispiel „Welche Deals schließen diesen Monat?“ oder „Wann war ich zuletzt bei Firma X?“.

Die CRM-Oberfläche

Das Mini-CRM hat eine eigene Oberfläche, die Sie aus der Sales-Companion-App öffnen. Sie hat vier Ansichten: Heute mit offenen Aufgaben zum Abhaken, Sprachassistent, Hot News zu Ihren wichtigsten Kunden und den Kennzahlen der Pipeline; Firmen und Personen mit eigenen Detailseiten, auf denen Sie Daten direkt bearbeiten und Firmen aus dem Web anreichern; und die Pipeline als Board, auf dem Sie Deals per Drag-and-drop zwischen den Phasen verschieben. Am unteren Rand jeder Ansicht steht der Assistent bereit, per Sprache oder Text, und weiß, welche Firma gerade geöffnet ist.

Heute

Heute: offene Aufgaben, Sprachassistent, Hot News und die Kennzahlen der Pipeline.

Die Pipeline

Die Pipeline als Board: Deals per Drag-and-drop in die nächste Phase ziehen.

Die Detailseite einer Firma

Die Detailseite einer Firma mit Stammdaten, Personen, offenen Deals und Aktivitäten.

17.5 Agent und Werkzeuge

Der Chatbot der Produktseite und Ihr HybridClaw-Agent arbeiten mit denselben CRM-Werkzeugen: Besuchsbericht ablegen, Angebot erstellen, Aufgabe anlegen, Dokumente auflisten, Firmen, Kontakte und Deals suchen, anlegen und ändern, Aktivitäten vermerken. Die Werkzeuge stehen dem Inhaber der Produktseite zur Verfügung.

Der Agent bringt zusätzlich die Fähigkeit zur Wettbewerbsbeobachtung mit. Er hält seine Beobachtungen in seiner täglichen Notiz fest, die iOS-App zeigt sie unter Watch. Dafür muss in den HybridClaw-Einstellungen das Cloud-Gedächtnis eingeschaltet sein.

Für die Akquise stehen allen Agenten die Werkzeuge outreach (Recherche zu Person und Firma, Entwurf einer persönlichen E-Mail, ohne Versand) und geo_sniffer (welche Quellen und Marken KI-Assistenten zu einer Kundenfrage nennen) zur Verfügung; beide werden pro Aufruf abgerechnet.

17.6 iOS-App

Die App Sales Companion bringt den Assistenten aufs iPhone und mit CarPlay ins Auto: Fragen per Sprache, Aufgaben, Überblick, Coaching und Wettbewerbsbeobachtung. So verbinden Sie sie:

  1. Auf der Kontoseite unter Verbundene Geräte Gerät verbinden wählen. Ein QR-Code erscheint; er gilt 10 Minuten und nur einmal.
  2. In der App über das Zahnrad „Mit QR-Code verbinden“ wählen und den Code scannen.

Jedes Gerät erhält einen eigenen Schlüssel und lässt sich auf der Kontoseite umbenennen oder trennen. Ohne Verbindung läuft die App im Demomodus mit Beispieldaten. Hinweise zum Datenschutz stehen in Abschnitt 15 der Datenschutzerklärung.

17.7 Eigene Daten und externe CRMs

Damit der Assistent Fragen zu Umsatz, Verträgen und Verlängerungen beantwortet, verbinden Sie eine Datenquelle unter Connectors > Geschäftsdaten und erlauben Sie sie dort unter Erlaubte Datenquellen auch für Agenten. Quellen, die bei der Aktivierung schon bestehen, sind dem Sales-Companion-Bot freigegeben; später hinzugefügte ordnen Sie dem Bot zu.

Salesforce oder Microsoft Dynamics: Statt des eingebauten CRMs kann Ihr bestehendes CRM angebunden werden. Seine Daten werden dann als Geschäftsdaten synchronisiert, und der Assistent beantwortet Fragen daraus; Änderungen im CRM selbst nimmt er in diesem Fall nicht vor. Die Umstellung richtet HybridAI auf Anfrage ein: service@hybridai.one.

18. Kontakt & Support

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