Handbuch

Basiswissen

Basiswissen macht freigegebene Quellen für Chats und Projekte nutzbar. Administratoren verwalten Quellen, Sichtbarkeit, Aktualisierung und Retrieval, ohne der Spark freien Internetzugriff zu geben.

· Stand: Oktober 2026

1. Was Basiswissen ist

Basiswissen ist kuratierter Kontext, den Ephraim bei passenden Anfragen ergänzt. Es besteht aus zentralen Texten, Dateien, freigegebenen URLs, Kalenderquellen, Wetterdaten oder Wikipedia-Auszügen. Die Quelle wird nicht direkt von der KI besucht: Der Webserver ruft freigegebene Quellen kontrolliert ab, prüft sie und stellt nur passende Ausschnitte bereit.

Basiswissen-Adminseite mit Quellen, Status und Aktualisierung
Die Basiswissen-Seite zeigt zentrale Quellen, Nutzung, Datenstatus, Aktualisierung und Aktionen. Freigegebener Kontext wird hier verwaltet, nicht durch freie Websuche der Spark.

2. Quellen anlegen

Neue Quellen werden über einen geführten Assistenten angelegt. Die Schritte sind bewusst getrennt: zuerst Art der Quelle, dann Datei, URL oder Providerangaben, danach Kontext, Sichtbarkeit und Aktualisierung, zuletzt eine Prüfung der Angaben. Gespeichert wird erst am Ende.

Der Assistent zeigt nur Felder, die zur gewählten Quelle passen. Ein Datei-Upload braucht keine Cron-Einstellung, eine Wikipedia-Quelle keine Upload-Datei und eine Wetterquelle Standortdaten statt Textinhalt. Dadurch landen irrelevante Einstellungen nicht versehentlich in der Quelle.

Basiswissen-Assistent mit Quellentypen Text, Datei, URL, Kalender, Wikipedia und Wetter
Der Assistent führt zuerst durch die Art der Quelle. Danach zeigt Ephraim nur die Felder, die zu dieser Quelle passen.

3. Quellentypen

Quelle Was sie liefert Besonderheit
Text Schulische Informationen, Unterrichtsmaterial oder statische Hinweise. Direkt eingefügter Text wird wie eine Basiswissen-Quelle verarbeitet.
Datei PDF, Text, HTML oder ICS aus einem Upload. Die Datei wird geprüft, begrenzt, verarbeitet und verschlüsselt gespeichert.
URL PDF, Text oder HTML von einer freigegebenen Adresse. Der Webserver ruft die Quelle kontrolliert ab; die KI surft nicht selbst.
ICS-Kalender Termine, Stundenpläne oder Ereignisse als strukturierter Kontext. Das Kalenderfenster legt fest, wie weit zurück und voraus indexiert wird.
Wetter Standortbezogene Wetterdaten für schulische oder organisatorische Kontexte. Bright Sky wird serverseitig abgefragt; frisches Wetter kann auch in der Begrüßung erscheinen.
Wikipedia Kurze Auszüge aus deutscher oder englischer Wikipedia bei passenden Allgemeinwissensfragen. Wikipedia ist ein dynamischer Provider, keine Sammlung fest hinterlegter Artikel.

4. Sichtbarkeit und Nutzung

Jede zentrale Quelle hat zwei Ebenen von Freigaben. Die Sichtbarkeit legt fest, ob Schülerinnen und Schüler, Lehrkräfte oder beide Gruppen die Quelle nutzen dürfen. Die Nutzung legt fest, ob die Quelle im Chat und zusätzlich im Projektbuilder verfügbar ist.

Diese Trennung ist wichtig: Ein interner Lehrkrafthinweis gehört nicht automatisch in Schülerantworten, und nicht jede Chatquelle ist sinnvoll für den Entwurf neuer Projekte. Der Aktiv-Schalter ist davon nochmals getrennt. Eine technisch bereite Quelle kann administrativ deaktiviert bleiben.

5. Status und Aktualisierung

Die Quellenliste unterscheidet fachliche Freigabe und technischen Zustand. Eine Quelle kann bereit, deaktiviert, im Refresh, fehlgeschlagen oder noch Entwurf sein. Remote-, Kalender- und Wetterquellen können automatisch aktualisiert werden; Uploads und eingefügte Texte bleiben statische Quellen, bis sie bewusst geändert werden.

Wenn bei einer bestehenden Kalenderquelle das Kalenderfenster geändert wird, verarbeitet Ephraim die Quelle neu. Erst nach erfolgreicher Verarbeitung gelten die neuen Werte. Bei Fehlern bleiben die bisherigen Kalenderdaten nutzbar.

6. Webabrufe bleiben beim Webserver

Basiswissen ergänzt den Kontext für das lokale GPT-OSS-Chatmodell, das derzeit mit vLLM auf der Spark läuft. Wenn eine URL, Wikipedia oder Wetterdaten benötigt werden, ruft der Webserver diese Quellen nach den konfigurierten Regeln ab. Die Spark erhält den freigegebenen Kontext. Das Modell führt diese Webabrufe nicht selbst aus.

Die Vektorerzeugung nutzt einen eigenen SGLang-Embedding-Dienst auf der Spark. Er berechnet aus freigegebenen Textabschnitten Zahlenvektoren und erzeugt keine Chatantwort. Die geprüfte Modellgeneration bleibt von der Webanwendung getrennt. Texte und Vektoren aus den einzelnen Anfragen werden im Dienst nicht dauerhaft gespeichert. Die verschlüsselte Ablage des Basiswissens bleibt auf dem Webserver.

7. Zentral vs. privat

Zentrales Basiswissen ist administrativ verwaltet. Private Kalenderabos einzelner Nutzer sind davon getrennt und gehören zur Personalisierung. Diese Trennung verhindert, dass ein privater Stundenplan plötzlich zur zentralen Wissensquelle wird.

Private Kalenderquellen werden nur für das jeweilige Konto im normalen Chat und in der persönlichen Startseitenbegrüßung genutzt. Sie werden nicht im Projektbuilder und nicht für fremde Konten verwendet. Zentrale Kalenderquellen bleiben dagegen Teil des administrativ freigegebenen Basiswissens.