📚 Benutzeranleitung: Wissensdatenbanken
🚀 Hauptfunktionen
🔧 Instanz-Verwaltung
- Knowledge Base Instanzen erstellen
- Konfigurationen bearbeiten
- Ergebnislimits festlegen
- Unternehmenszuordnung
🎯 Typen-System
- Vector-basierte Suche
- Graph-basierte Abfragen
- Flexible Konfiguration
- Optimierte Performance
🔍 Suche & Filter
- Erweiterte Suchfunktionen
- Filter nach Unternehmen
- Typ-basierte Filterung
- Sortierbare Spalten
🧪 Testing & Validierung
- Instanz-Testing
- Ergebnis-Vorschau
- Konfigurationsvalidierung
- Performance-Monitoring
📋 Knowledge Base Instanzen verstehen
Was sind Knowledge Base Instanzen?
Knowledge Base Instanzen sind spezifische Konfigurationen, die eine bestehende Wissensdatenbank mit benutzerdefinierten Einstellungen verbinden. Sie ermöglichen es, dieselbe Knowledge Base für verschiedene Anwendungsfälle, Unternehmen oder Zugriffsszenarien zu nutzen.
🎯 Kernkomponenten
- Name: Eindeutiger Bezeichner der Instanz
- Typ: VECTOR oder GRAPH-basierte Verarbeitung
- Knowledge Base: Verknüpfung zur Basis-Wissensdatenbank
- Unternehmen: Organisatorische Zuordnung
- Ergebnislimit: Anzahl der zurückgegebenen Resultate
⚙️ Konfigurationsoptionen
- Beschreibung: Dokumentation des Verwendungszwecks
- Anweisungen: Spezifische Nutzungsrichtlinien
- Result Limits: 1-100 Ergebnisse pro Abfrage
- Unternehmenskontext: Isolierte Datenräume
Vector vs. Graph Typen
🔷 VECTOR Typ
- Anwendung: Semantische Ähnlichkeitssuche
- Technologie: Embedding-basierte Suche
- Vorteile: Schnell bei großen Datenmengen
- Ideal für: Dokumentensuche, FAQ-Systeme
- Performance: Optimiert für Skalierung
- Ergebnisse: Relevanz-basierte Ranking
🔶 GRAPH Typ
- Anwendung: Beziehungsbasierte Abfragen
- Technologie: Graph-Datenbank-Queries
- Vorteile: Komplexe Zusammenhänge erkennen
- Ideal für: Strukturierte Daten, Ontologien
- Performance: Optimiert für Beziehungen
- Ergebnisse: Kontext-bewusste Antworten
🌟 Erste Schritte
1. Voraussetzungen prüfen
- Knowledge Base vorhanden: Eine Basis-Wissensdatenbank muss bereits existieren
- Unternehmen konfiguriert: Mindestens ein Unternehmen muss im System registriert sein
- Berechtigungen: Administrative Rechte für Knowledge Base Verwaltung
- Anwendungsfall definiert: Klare Vorstellung des Einsatzzwecks
2. Zur Knowledge Base Instanz Verwaltung navigieren
- Menü öffnen: Navigieren Sie zur Verwaltung im Hauptmenü
- Knowledge Base Instanzen: Wählen Sie den entsprechenden Menüpunkt
- Übersicht: Sie sehen die Liste aller vorhandenen Instanzen
- Neue Instanz: Klicken Sie auf "Neue Instanz" um zu beginnen
➕ Neue Knowledge Base Instanz erstellen
Schritt-für-Schritt Anleitung
1. Grundlegende Informationen
2. Verknüpfungen konfigurieren
3. Performance-Einstellungen
Erweiterte Konfiguration
Beschreibung hinzufügen
- Zweck dokumentieren: Erklären Sie den Verwendungszweck der Instanz
- Zielgruppe definieren: Wer wird diese Instanz nutzen?
- Anwendungsbereich: In welchen Szenarien wird sie eingesetzt?
- Besonderheiten: Spezielle Konfigurationen oder Einschränkungen
Anweisungen formulieren
- Nutzungsrichtlinien: Wie soll die Instanz verwendet werden?
- Kontextinformationen: Welcher Kontext ist bei Abfragen zu beachten?
- Qualitätsrichtlinien: Wie werden relevante Ergebnisse identifiziert?
- Ausschlüsse: Was soll nicht berücksichtigt werden?
Beispiel für gute Anweisungen:
"Diese Instanz ist für Kundensupport-Anfragen optimiert. Priorisieren Sie Antworten, die konkrete Lösungsschritte enthalten. Berücksichtigen Sie den Schwierigkeitsgrad der Anfrage und bieten Sie sowohl schnelle Fixes als auch detaillierte Erklärungen. Ignorieren Sie veraltete Dokumentation vor 2023."
📊 Knowledge Base Instanzen verwalten
Übersicht und Navigation
Hauptübersicht
- Instanz-Liste: Tabellarische Darstellung aller Instanzen
- Sortierung: Klicken Sie auf Spaltenüberschriften zum Sortieren
- Quick Actions: Direktzugriff auf Anzeigen, Bearbeiten, Löschen
- Status-Badges: Visuelle Kennzeichnung von Typ und Limits
Spalten-Informationen
- Name: Instanz-Name mit optionaler Beschreibung
- Knowledge Base: Verknüpfte Basis-Datenbank
- Unternehmen: Organisatorische Zuordnung
- Typ: VECTOR oder GRAPH Badge
- Ergebnislimit: Konfigurierte Anzahl Resultate
- Aktionen: Anzeigen, Bearbeiten, Löschen
Suche und Filterung
🔍 Suchfunktion
- Volltext-Suche: Durchsucht Namen und Beschreibungen
- Echtzeit-Filter: Ergebnisse werden während der Eingabe gefiltert
- Platzhalter-Suche: Teilbegriffe werden erkannt
- Groß-/Kleinschreibung: Suche ist nicht case-sensitive
🎯 Filter-Optionen
Unternehmen-Filter
- Alle Unternehmen anzeigen
- Spezifisches Unternehmen wählen
- Nur eigene Instanzen
Knowledge Base Filter
- Alle Knowledge Bases
- Spezifische KB auswählen
- Nach KB-Typ filtern
Typ-Filter
- Alle Typen anzeigen
- Nur VECTOR Instanzen
- Nur GRAPH Instanzen
⚙️ Erweiterte Filter-Techniken
- Kombinierte Filter: Mehrere Filter gleichzeitig anwenden
- Filter zurücksetzen: "Alle" Option wählen um Filter zu löschen
- URL-Parameter: Filter bleiben beim Neuladen erhalten
- Export-Kompatibilität: Gefilterte Ergebnisse können exportiert werden
Sortierung und Pagination
📊 Sortieroptionen
- Name: Alphabetisch aufsteigend/absteigend
- Unternehmen: Nach Unternehmensname sortieren
- Typ: VECTOR/GRAPH gruppiert anzeigen
- Erstellungsdatum: Neueste/Älteste zuerst
📄 Pagination
- Seitennavigation: Vor/Zurück und direkte Seitenwahl
- Einträge pro Seite: Konfigurierbare Anzahl
- Gesamtübersicht: "Zeige X von Y Einträgen"
- Performance: Lazy Loading für große Datenmengen
🔍 Instanz-Details und Bearbeitung
Detailansicht verstehen
📋 Informations-Bereiche
Grundlegende Informationen
- Name: Eindeutiger Bezeichner
- Typ-Badge: VECTOR/GRAPH mit Farbcodierung
- Knowledge Base: Verknüpfte Datenbank (klickbar)
- Unternehmen: Organisatorische Zuordnung
- Ergebnislimit-Badge: Konfigurierte Anzahl
Beschreibung & Anweisungen
- Beschreibung: Verwendungszweck dokumentiert
- Anweisungen: Spezifische Richtlinien
- Formatierung: Text mit Zeilenumbrüchen
- Platzhalter: Hinweise bei fehlenden Inhalten
⚡ Quick Actions
- Instanz testen: Funktionalität der Konfiguration prüfen
- Ergebnis-Vorschau: Beispielhafte Ausgabe anzeigen
- Knowledge Base Details: Zur Basis-Datenbank navigieren
- Bearbeiten: Konfiguration ändern
Instanz bearbeiten
✏️ Bearbeitbare Felder
Immer bearbeitbar
- Name: Kann jederzeit geändert werden
- Beschreibung: Dokumentation aktualisieren
- Anweisungen: Richtlinien anpassen
- Ergebnislimit: Performance-Tuning
Eingeschränkt bearbeitbar
- Typ: Änderung kann Neuindizierung erfordern
- Knowledge Base: Vorsicht bei bestehenden Abhängigkeiten
- Unternehmen: Berechtigungen prüfen
🔄 Bearbeitungs-Workflow
- Instanz auswählen: In der Liste oder Detailansicht
- Bearbeiten-Button: Klicken Sie auf das Stift-Symbol
- Felder anpassen: Ändern Sie die gewünschten Werte
- Validierung: System prüft Eingaben automatisch
- Speichern: Änderungen werden sofort übernommen
- Testen: Überprüfen Sie die Funktionalität nach Änderungen
🧪 Testing und Validierung
Instanz Testing durchführen
🔍 Test-Funktionen
Instanz testen
- Verbindungstest: Knowledge Base erreichbar?
- Konfigurationstest: Alle Parameter korrekt?
- Performance-Test: Antwortzeiten messen
- Ergebnis-Validierung: Plausibilität der Antworten
Ergebnis-Vorschau
- Beispiel-Queries: Typische Anfragen simulieren
- Result-Format: Struktur der Antworten prüfen
- Limit-Überprüfung: Konfigurierte Anzahl eingehalten?
- Relevanz-Check: Qualität der Ergebnisse bewerten
📊 Test-Ergebnisse interpretieren
✅ Erfolgreicher Test
- Verbindung zur Knowledge Base funktioniert
- Konfiguration ist vollständig und korrekt
- Ergebnisse werden in erwarteter Zeit zurückgegeben
- Limit wird eingehalten
❌ Fehlgeschlagener Test
- Knowledge Base nicht erreichbar
- Konfigurationsfehler identifiziert
- Timeout bei der Abfrage
- Unerwartete Fehlerresponses
Performance-Optimierung
⚡ Ergebnislimit optimieren
Niedrige Limits (1-10)
- Vorteile: Sehr schnelle Antwortzeiten
- Anwendung: FAQ-Systeme, schnelle Lookups
- Performance: < 100ms typisch
- Speicher: Minimaler Verbrauch
Mittlere Limits (10-30)
- Vorteile: Gute Balance zwischen Speed und Vollständigkeit
- Anwendung: Standard-Suchsysteme
- Performance: 100-500ms typisch
- Speicher: Moderater Verbrauch
Hohe Limits (30-100)
- Vorteile: Umfassende Ergebnisse
- Anwendung: Analytische Abfragen, Research
- Performance: 500ms-2s möglich
- Speicher: Höherer Verbrauch
🎯 Typ-spezifische Optimierung
VECTOR Optimierung
- Embedding-Qualität: Hochwertige Vektoren verwenden
- Similarity-Threshold: Relevanz-Schwellwerte anpassen
- Index-Tuning: Für häufige Abfragen optimieren
- Batch-Processing: Multiple Queries zusammenfassen
GRAPH Optimierung
- Relationship-Depth: Traversal-Tiefe begrenzen
- Node-Indexing: Wichtige Knoten indizieren
- Query-Patterns: Effiziente Abfrage-Muster nutzen
- Caching: Häufige Pfade zwischenspeichern
🔗 Integration in Workflows
Knowledge Base Instanzen in KI-Agenten
🤖 Agent-Integration
- Context-Injection: Instanz-spezifische Anweisungen werden automatisch eingebunden
- Result-Filtering: Agent erhält nur relevante, limitierte Ergebnisse
- Company-Isolation: Datenschutz durch Unternehmens-Trennung
- Performance-Guarantee: Vorhersagbare Antwortzeiten durch Limits
⚙️ Konfigurations-Workflow
- Instanz erstellen: Spezifisch für den Agent-Anwendungsfall
- Anweisungen formulieren: Wie soll der Agent die Knowledge Base nutzen?
- Limit optimieren: Balance zwischen Vollständigkeit und Speed
- Agent konfigurieren: Instanz dem Agent zuweisen
- Testing: End-to-End Test der Integration
- Monitoring: Performance und Qualität überwachen
Beispiel: Kundensupport-Agent
- Instanz-Name: "Support FAQ VECTOR"
- Typ: VECTOR (für schnelle FAQ-Suche)
- Limit: 5 (für präzise, schnelle Antworten)
- Anweisungen: "Priorisiere Lösungsschritte. Wenn keine passende Antwort gefunden wird, eskaliere an menschlichen Support."
Workflow-Integration
🔄 Workflow-Szenarien
Automatisierte Recherche
- Input: Nutzeranfrage oder Dokument
- Processing: Knowledge Base Abfrage
- Output: Relevante Informationen extrahieren
- Follow-up: Weitere Aktionen basierend auf Ergebnissen
Content-Enrichment
- Input: Basis-Content (Text, Dokument)
- Processing: Zusatzinformationen suchen
- Output: Angereicherter, detaillierter Content
- Quality-Check: Relevanz und Qualität bewerten
📊 Multi-Instanz Workflows
- Staged Queries: Erst VECTOR für Übersicht, dann GRAPH für Details
- Parallel Processing: Multiple Instanzen gleichzeitig abfragen
- Result Merging: Ergebnisse intelligent kombinieren
- Fallback Strategies: Alternative Instanzen bei Fehlern
💼 Typische Anwendungsfälle
📞 Beispiel 1: Kundensupport-System
Szenario
Ein Unternehmen möchte einen KI-basierten Kundensupport mit verschiedenen Wissensdatenbanken für unterschiedliche Produktlinien implementieren.
Instanz-Konfiguration
FAQ Instanz
- Name: "FAQ Support VECTOR"
- Typ: VECTOR
- Knowledge Base: "Hauptsupport-Datenbank"
- Limit: 3 (schnelle, präzise Antworten)
- Anweisungen: "Fokus auf häufige Probleme und deren Lösungen. Priorisiere selbstlösbare Probleme."
Technische Details Instanz
- Name: "Technical Deep Dive"
- Typ: GRAPH
- Knowledge Base: "Technische Dokumentation"
- Limit: 15 (umfassende technische Informationen)
- Anweisungen: "Detaillierte technische Zusammenhänge erklären. Berücksichtige Abhängigkeiten zwischen Komponenten."
Workflow-Integration
- Erste Triage: FAQ Instanz für schnelle Antworten
- Eskalation: Bei komplexen Fragen → Technical Deep Dive Instanz
- Human Handoff: Wenn keine passende Antwort gefunden
- Feedback Loop: Ungelöste Fragen in Knowledge Base integrieren
🏢 Beispiel 2: Multi-Tenant Enterprise System
Szenario
Ein SaaS-Anbieter betreibt eine zentrale Wissensdatenbank, möchte aber kundenspezifische Anpassungen und Datenisolation.
Instanz-Architektur
Standard-Instanz
- Name: "Global Knowledge Base"
- Typ: VECTOR
- Unternehmen: "Master Organisation"
- Limit: 20
- Anweisungen: "Allgemeine, produktübergreifende Informationen. Keine kundenspezifischen Details."
Kunde-spezifische Instanzen
- Name: "ACME Corp Custom KB"
- Typ: GRAPH
- Unternehmen: "ACME Corporation"
- Limit: 10
- Anweisungen: "ACME-spezifische Konfigurationen und Prozesse. Berücksichtige deren Workflows und Terminologie."
Datenschutz und Isolation
- Unternehmens-Trennung: Jede Instanz sieht nur eigene Daten
- Rollen-basierter Zugriff: Admins verwalten nur eigene Instanzen
- Audit-Trail: Vollständige Nachverfolgung aller Zugriffe
- Performance-Isolation: Limits verhindern gegenseitige Beeinträchtigung
🔬 Beispiel 3: Forschungs- und Entwicklungsumgebung
Szenario
Ein Forschungsunternehmen nutzt verschiedene Instanzen für unterschiedliche Forschungsprojekte und Entwicklungsstadien.
Entwicklungs-Pipeline
Experimentelle Instanz
- Name: "Research Experiment High Recall"
- Typ: VECTOR
- Limit: 100 (maximale Abdeckung)
- Anweisungen: "Sammle alle potentiell relevanten Informationen. Priorisiere Vollständigkeit über Präzision."
Produktions-Instanz
- Name: "Production High Precision"
- Typ: GRAPH
- Limit: 5 (höchste Qualität)
- Anweisungen: "Nur hochrelevante, validierte Informationen. Priorisiere Präzision über Vollständigkeit."
A/B Testing Workflow
- Baseline: Aktuelle Produktions-Instanz
- Experiment: Neue Instanz mit anderen Parametern
- Vergleich: Paralleles Testing der beiden Konfigurationen
- Metriken: Relevanz, Performance, Nutzerzufriedenheit
- Migration: Überführung der besseren Konfiguration in Produktion
💡 Best Practices
✅ Empfohlene Vorgehensweise
- Aussagekräftige Namen: Nutzen Sie beschreibende, eindeutige Namen
- Dokumentierte Anweisungen: Detaillierte Nutzungsrichtlinien formulieren
- Optimierte Limits: Balance zwischen Performance und Vollständigkeit
- Typ-gerechte Nutzung: VECTOR für Speed, GRAPH für Beziehungen
- Regelmäßiges Testing: Funktionalität kontinuierlich überprüfen
- Unternehmens-Trennung: Klare organisatorische Zuordnung
- Performance-Monitoring: Antwortzeiten und Qualität überwachen
- Versionierung: Änderungen dokumentieren und nachverfolgen
🔄 Wartung und Updates
- Regelmäßige Validierung: Monatliche Konfigurationsprüfung
- Performance-Review: Limits basierend auf Nutzung anpassen
- Anweisungen aktualisieren: Bei Änderungen der Anforderungen
- Knowledge Base Updates: Auswirkungen auf Instanzen prüfen
- Unused Instance Cleanup: Nicht genutzte Instanzen entfernen
❌ Häufige Fehler vermeiden
- Unklare Namen: "Test KB 1" statt "Customer FAQ Support"
- Fehlende Anweisungen: Keine Nutzungsrichtlinien definiert
- Falsche Limits: Zu hoch (langsam) oder zu niedrig (unvollständig)
- Falscher Typ: GRAPH für einfache Suchen, VECTOR für Beziehungen
- Keine Dokumentation: Zweck und Konfiguration nicht dokumentiert
- Unternehmens-Durchmischung: Falsche organisatorische Zuordnung
- Ungetestete Änderungen: Konfiguration ohne Validierung deployed
- Performance ignoriert: Keine Überwachung der Antwortzeiten
🔒 Sicherheits-Tipps
- Datenschutz: Unternehmens-spezifische Datenisolation
- Zugriffskontrolle: Minimale notwendige Berechtigungen
- Audit-Logging: Alle Konfigurationsänderungen protokollieren
- Sensitive Data: Keine vertraulichen Informationen in Anweisungen
- Rate Limiting: Instanz-Limits gegen Missbrauch
- Monitoring: Ungewöhnliche Nutzungsmuster erkennen
🆘 Troubleshooting
🔧 Konfigurations-Probleme
Instanz kann nicht erstellt werden
- Pflichtfelder vollständig ausgefüllt?
- Name bereits vergeben?
- Berechtigungen für Knowledge Base?
- Unternehmen korrekt zugeordnet?
Ergebnislimit wird ignoriert
- Wert zwischen 1 und 100?
- Knowledge Base unterstützt Limits?
- Cache-Probleme nach Änderung?
- Browser-Cache löschen
🧪 Test-Probleme
Instanz-Test schlägt fehl
- Knowledge Base erreichbar?
- Netzwerkverbindung prüfen
- Authentifizierung korrekt?
- Service-Status überprüfen
Unerwartete Ergebnisse
- Anweisungen zu spezifisch/allgemein?
- Typ (VECTOR/GRAPH) passend?
- Knowledge Base aktuell?
- Limit zu niedrig gesetzt?
⚡ Performance-Probleme
Langsame Antwortzeiten
- Ergebnislimit reduzieren
- Knowledge Base-Performance prüfen
- Netzwerk-Latenz messen
- Server-Last überprüfen
Speicher- oder CPU-Probleme
- Limits aller Instanzen prüfen
- Parallel laufende Abfragen
- Knowledge Base-Größe optimieren
- Hardware-Ressourcen skalieren
🎓 Erweiterte Features
🔍 Erweiterte Suchfunktionen
Die Wissensdatenbank-Verwaltung bietet umfangreiche Such- und Filtermöglichkeiten:
🎯 Kombinierte Filter
- Multi-Kriterien-Suche: Gleichzeitige Filterung nach mehreren Attributen
- Volltext + Filter: Suchbegriff kombiniert mit Dropdown-Filtern
- Ausschluss-Filter: Bestimmte Werte explizit ausschließen
- Bereichs-Filter: Ergebnislimits in bestimmten Bereichen
📊 Sortierung und Gruppierung
- Multi-Level-Sortierung: Primäre und sekundäre Sortierkriterien
- Typ-Gruppierung: VECTOR und GRAPH Instanzen getrennt anzeigen
- Unternehmens-Gruppierung: Nach organisatorischer Zugehörigkeit
- Custom-Sortierung: Benutzerdefinierte Reihenfolge
📈 Analytics und Monitoring
📊 Nutzungsstatistiken
- Abfrage-Häufigkeit: Wie oft wird jede Instanz genutzt?
- Performance-Metriken: Durchschnittliche Antwortzeiten
- Erfolgs-Rate: Anteil erfolgreicher vs. fehlgeschlagener Anfragen
- Resource-Usage: CPU und Speicher-Verbrauch pro Instanz
🔍 Quality-Metriken
- Relevanz-Scores: Bewertung der Ergebnis-Qualität
- User-Feedback: Nutzerbewertungen der Antworten
- Result-Coverage: Vollständigkeit der Ergebnisse
- Diversity-Index: Vielfalt der zurückgegebenen Informationen
Monitoring-Dashboard Beispiel:
- Performance-Graph: Antwortzeiten über Zeit
- Usage-Heatmap: Aktivität nach Tageszeit
- Error-Log: Chronologie der Fehler und Lösungen
- Capacity-Planning: Ressourcen-Vorhersage
🔄 Batch-Operationen
🎛️ Massen-Bearbeitung
- Bulk-Update: Mehrere Instanzen gleichzeitig bearbeiten
- Template-basierte Erstellung: Neue Instanzen aus Vorlagen
- Migration-Tools: Instanzen zwischen Systemen übertragen
- Backup & Restore: Sicherung und Wiederherstellung von Konfigurationen
📋 Import/Export
- CSV-Export: Instanz-Konfigurationen als Tabelle
- JSON-Export: Vollständige Konfigurationsdaten
- Template-Import: Vordefinierte Konfigurationen importieren
- Schema-Validation: Automatische Validierung beim Import