Wissenssammlungen

Die Wissenssammlungen-Seite (/admin/knowledge-sets) ermöglicht es Workspace-Administratoren, Wissenssammlungen zu verwalten. Nur Admin-Benutzer können auf diese Seite zugreifen.

Eine Wissenssammlung ist eine Wissensbasis (RAG-Korpus): eine Sammlung von Dokumenten und externen Quellen, die für eine semantische Suche aufbereitet ("eingebettet") wird. Agenten können auf eine oder mehrere Wissenssammlungen zugreifen, um ihre Antworten mit Ihren eigenen Inhalten zu untermauern.

Übersicht

Die Listenansicht zeigt alle Wissenssammlungen in einer Tabelle mit folgenden Spalten:

Spalte	Inhalt
Name	Name der Wissenssammlung
Beschreibung	Datenbeschreibung (gekürzt)
Dateien	Anzahl der enthaltenen Dateien
Embedding-Modell	Für die Einbettung verwendetes Modell
Erstellt	Erstellungsdatum

Über das Suchfeld (Wissenssammlungen suchen...) filtern Sie die Liste nach Name oder Beschreibung. Über die Auswahlkästchen am Zeilenanfang lassen sich mehrere Sammlungen markieren und mit der Schaltfläche Löschen (mit der Anzahl der ausgewählten Einträge) gemeinsam entfernen.

Eine Wissenssammlung erstellen

1. Klicken Sie auf Wissenssammlung erstellen
2. BasePeak.AI legt die Sammlung an und öffnet direkt deren Detailseite
3. Vergeben Sie dort einen Namen und befüllen Sie die Sammlung mit Quellen oder Dateien

Das Embedding-Modell stammt aus Ihren konfigurierten Modellanbietern (siehe Modellanbieter). Stellen Sie sicher, dass mindestens ein passendes Modell verfügbar ist.

Details bearbeiten

Auf der Detailseite einer Wissenssammlung bearbeiten Sie Name und Datenbeschreibung. Beide Felder werden automatisch gespeichert (während des Speicherns erscheint Wird gespeichert...). Eine aussagekräftige Beschreibung hilft Agenten zu erkennen, wann diese Wissensbasis relevant ist.

Eine Metadatenleiste am Kopf der Seite zeigt die wichtigsten Kennzahlen: Erstellt, Dateien (Anzahl), Gesamtgröße, Embedding-Modell sowie die Verwendung durch Agenten und Threads.

Wissensverarbeitung

Im Bereich Erweitert am Ende der Detailseite legen Sie fest, wie eine Wissenssammlung Dokumente einliest, aufteilt und durchsucht – die Wissensverarbeitung. Für die meisten Sammlungen ist die Voreinstellung passend; Sie müssen hier nichts ändern.

Wählen Sie ein vorkonfiguriertes Verarbeitungsprofil:

Profil	Geeignet für
Standard (ausgewogen)	Die meisten Inhalte – die Voreinstellung.
Hohe Qualität (hybrid)	Kombiniert bedeutungs- und stichwortbasierte Suche; bessere Treffer bei Namen, Aktenzeichen und exakten Begriffen.
Großer Kontext	Hält größere, zusammenhängende Abschnitte zusammen – für Fragen, die den ganzen Abschnitt benötigen.
Juristische Dokumente	Teilt nach juristischer Struktur (Paragrafen, Artikel, Klauseln) – für Gesetze, Verträge und Satzungen.

Alternativ laden Sie eine eigene Konfigurationsdatei (YAML) hoch, die nur für diese Wissenssammlung gilt. Eine Vorlage zum Herunterladen hilft beim Einstieg.

hinweis

Ändern Sie die Verarbeitung einer Sammlung, die bereits Dateien enthält, betrifft dies zunächst nur neu hinzugefügte Dateien. BasePeak.AI bietet daher an, alle vorhandenen Dateien neu einzulesen, damit die neue Einstellung überall greift. Sammlungen, die Sie nicht ändern, funktionieren unverändert weiter.

Wissensquellen

Im Bereich Wissensquellen binden Sie externe Datenquellen an, die automatisch synchronisiert werden. Klicken Sie auf Quelle hinzufügen, um eine Quelle anzulegen, und wählen Sie den Quellentyp aus:

Typ	Beschreibung
Webseite	Crawlen einer oder mehrerer URLs
OneDrive	Geteilte OneDrive-Links
Notion	Notion-Arbeitsbereich
Nextcloud	Nextcloud-Instanz
SMB / Netzwerkfreigabe	Netzwerkfreigabe (SMB)
WebDAV	WebDAV-Server
S3 / Objektspeicher	S3-kompatibler Objektspeicher
SFTP	SFTP-Server
Ratsinformationssystem (RIS)	Kommunales Ratsinformationssystem
Landesrecht (NRW)	Landesrecht eines Bundeslands (aktuell Nordrhein-Westfalen) von recht.nrw.de

Je nach Typ geben Sie die nötigen Verbindungsdaten und gegebenenfalls Zugangsdaten ein. Optional legen Sie einen Synchronisierungsplan fest (z. B. Stündlich, Täglich oder ein eigener Cron-Ausdruck) und aktivieren Dateien automatisch genehmigen.

Bei Landesrecht (NRW) wählen Sie zunächst das Bundesland (aktuell Nordrhein-Westfalen) und suchen anschließend in einem durchsuchbaren Katalog die Gesetze, Rechtsverordnungen und Verwaltungsvorschriften aus, die in die Wissenssammlung übernommen werden sollen.

hinweis

Der Inhalt stammt von recht.nrw.de (SGV.NRW) und ist eine nicht-amtliche, konsolidierte Fassung.

Jede Quelle zeigt ein Statusabzeichen an:

Status	Bedeutung
Ausstehend	Synchronisierung steht noch aus
Wird synchronisiert	Synchronisierung läuft gerade
Synchronisiert	Quelle wurde erfolgreich übernommen
Fehler	Synchronisierung fehlgeschlagen (Details über Fehler anzeigen)

Solange Quellen synchronisiert werden, aktualisiert die Seite den Status automatisch. Über die Aktionen einer Quelle können Sie sie Jetzt synchronisieren, ihre Dateien anzeigen, sie bearbeiten oder Quelle entfernen.

Wissensdateien

Im Bereich Wissensdateien laden Sie Dokumente direkt hoch. Klicken Sie auf Dateien hochladen und wählen Sie eine oder mehrere Dateien aus. Unterstützt werden unter anderem folgende Formate:

PDF, TXT, DOC, DOCX, MD, HTML, ODT, RTF, CSV, IPYNB, JSON, PPTX, PPT und PAGES.

Nach dem Hochladen durchläuft jede Datei die Verarbeitung (Einlesen und Einbetten). Der Verarbeitungszustand wird angezeigt:

Zustand	Bedeutung
Wartet auf Freigabe	Datei wurde erkannt, aber noch nicht verarbeitet
In Bearbeitung	Datei wird gerade verarbeitet
Verarbeitet	Datei ist verarbeitet und durchsuchbar
Nicht unterstützt	Dateityp wird nicht unterstützt
Fehler	Verarbeitung fehlgeschlagen

Die Seite aktualisiert ausstehende Dateien automatisch, bis die Verarbeitung abgeschlossen ist. Einzelne Dateien lassen sich über die jeweilige Aktion Löschen dauerhaft aus dem Wissensbestand entfernen.

Exportieren und Importieren

Mit Exportieren erstellen Sie aus einer Wissenssammlung ein Paket (.zip), das wahlweise das Manifest der Wissensdatenbank (Name und Beschreibung) und die Originaldateien enthält. Erstellte Pakete erscheinen unter Letzte Exporte mit Phase, Größe und Ablaufzeitpunkt und stehen dort zum Herunterladen bereit.

Über die Schaltfläche Importieren in der Listenansicht spielen Sie ein zuvor exportiertes Paket wieder ein. Dabei können Sie Name überschreiben und Beschreibung überschreiben oder das Manifest aus dem Paket übernehmen.

Eine Wissenssammlung löschen

Sie löschen eine Sammlung über Wissenssammlung löschen (auf der Detailseite oder über das Aktionsmenü in der Liste). Vor dem Löschen prüft BasePeak.AI, ob die Sammlung noch verwendet wird.

hinweis

Eine Wissenssammlung, die noch von Agenten oder Threads verwendet wird, kann nicht gelöscht werden. Es erscheint der Hinweis Diese Wissenssammlung wird derzeit verwendet und kann nicht gelöscht werden. Beim Mehrfachlöschen werden verwendete Sammlungen automatisch übersprungen.

Hinweise

• Das Embedding-Modell wird beim Erstellen festgelegt und stammt aus den konfigurierten Modellanbietern.
• Quellen mit Zugangsdaten (SMB, WebDAV, SFTP, S3) bleiben im Status Ausstehend, bis ein gültiges Passwort hinterlegt ist.
• Beim Löschen einer Sammlung gehen alle enthaltenen Dateien und Quellen unwiderruflich verloren.