niclas wunder

KI-Assistent für das Wissen einer Schule.

Ein Chat, der Fragen aus dem internen Wiki und einem juristischen Nachschlagewerk mit rund 1.400 Seiten beantwortet – auf Deutsch und mit Quellenangabe. Allein umgesetzt, von der Anforderung bis zum Betrieb.

Kontext
Schule, Bildungsbereich
Leistung
KI-Wissensassistenten (RAG)
Rolle
AI Engineer & Fullstack
Zeitraum
04/2026 – 08/2026
Setup
Solo, von Anforderung bis Betrieb

01 — Ausgangslage

Die Antwort stand irgendwo. Nur wo?

Die Frage dahinter

„Steht das im Wiki oder im Nachschlagewerk?“

Das Wissen der Schule lag an zwei Orten: in einem internen Wiki und in einem juristischen Nachschlagewerk mit rund 1.400 Seiten als PDF. Wer eine Antwort brauchte, musste erst wissen, wo er suchen soll – und dann lesen. Eine Stichwortsuche hilft nur, wenn man das richtige Wort schon kennt.

02 — Lösung

Fragen stellen, Quelle sehen.

Ein Assistent, der beide Wissensquellen kennt, auf Deutsch antwortet und zu jeder Antwort zeigt, woher sie stammt.

  1. 01

    Beide Quellen, immer aktuell

    Das Wiki wird jede Nacht automatisch eingelesen, das Nachschlagewerk nach seinen Abschnitten zerlegt. Niemand muss Inhalte für den Assistenten von Hand pflegen.

  2. 02

    Eine Suche, die Deutsch versteht

    Bedeutungssuche und deutsche Volltextsuche arbeiten zusammen: Der Assistent findet, was gemeint ist – und den exakten Fachbegriff.

  3. 03

    Die richtige Quelle zur Frage

    Jede Frage wird zuerst eingeordnet: Wiki, Nachschlagewerk oder beides. Ein eigenes Reranking sortiert die Treffer, bevor die KI antwortet.

  4. 04

    Antworten mit Quellenangabe

    Die Antwort erscheint live im Chat, mit Verweis auf die Stelle im Wiki oder im Nachschlagewerk. Wer will, prüft nach.

03 — Architektur

Von der Quelle bis zur Antwort.

Vereinfacht. Zwei Wissensquellen, eine Suche, ein Chat – und Messung im Betrieb.

Architektur · anonymisiert

A · Quellen

Internes Wiki

Hinter einem Login. Wird jede Nacht neu eingelesen.

Scraping · nächtlich

Nachschlagewerk

Juristisch, rund 1.400 Seiten.

PDF · Abschnitte

B · Aufbereitung

Ingestion

Liest beide Quellen ein, zerlegt sie in Abschnitte.

Python · OpenAI API

Index

Vektoren und deutscher Volltext in einer Datenbank.

PostgreSQL · pgvector

C · Suche

Query-Routing

Ordnet die Frage zu: Wiki, Nachschlagewerk oder beides.

LangChain

Suche

Vektor · Volltext

Reranking

Eigenes

D · Antwort

Backend

Das Modell formuliert die Antwort aus den Treffern, mit Quellen.

FastAPI · SSE

Chat

Antwort live, Quelle zum Nachprüfen, Login pro Nutzer.

React · TypeScript

E · Betrieb

Jede Antwort wird protokolliert, Nutzer bewerten sie direkt im Chat. Langfuse, selbst gehostet.

04 — Meine Rolle

Eine Person, das ganze System.

Allein verantwortlich: Anforderungen aufnehmen, bauen, ausrollen, betreiben. Ohne Übergabe an einen zweiten Entwickler.

  1. 01

    Anforderung

    Welche Fragen gestellt werden, welche Quellen zählen und wer Zugang bekommt.

  2. 02

    Daten & Suche

    Ingestion für Wiki und PDF, hybride Suche, Reranking und Routing über zwei Quellen.

  3. 03

    Backend & Chat

    API mit Streaming und Quellenzitaten, Nutzerverwaltung, Chat-Oberfläche.

  4. 04

    Betrieb

    Automatisiertes Deployment und Feedback pro Antwort im Monitoring.

05 — Ergebnis

Was sich verändert hat.

Konkrete Nutzungszahlen gebe ich nur mit Freigabe der Schule weiter. Im Gespräch erzähle ich gern mehr.

1.400 Seiten, eine Frage
Im Nachschlagewerk musste man vorher selbst suchen. Jetzt stellt man eine Frage und bekommt die Stelle gleich mit.
Jeden Morgen aktuell
Neue und geänderte Wiki-Seiten sind am nächsten Morgen im Assistenten. Ohne Pflege von Hand.
Im Produktivbetrieb
Feedback pro Antwort zeigt, wo das System gut ist und wo es nachgeschärft werden muss.

06 — Technik

Der Stack.

Für technische Leser, Teams und Agenturen.

KI & Suche
LangChain, OpenAI API, pgvector, hybride Suche, Reranking
Backend
Python, FastAPI, Server-Sent Events
Daten
PostgreSQL, Scraping, PDF-Parsing
Oberfläche
React, TypeScript
Betrieb
Docker, Traefik, GitHub Actions, Langfuse

Technische Details

Wie Ingestion, Suche, Chat und Betrieb im Detail gebaut sind.

Ein Wiki hinter Login einlesen

Das Wiki läuft auf HumHub. Die nächtliche Ingestion liest das CSRF-Token aus, meldet sich per Session an, filtert Navigation und Kommentare heraus, folgt verlinkten Ressourcen und dedupliziert Inhalte. Diese Grenze zum Wiki ist mit deterministischen Tests gegen gemockte HTTP-Transports abgesichert.

Nachschlagewerk mit Seiten und Abschnittspfad

Das PDF wird entlang seiner Abschnitte zerlegt. Jeder Chunk trägt Ausgabejahr, Seitenbereich und Abschnittspfad und liegt in einer eigenen Vektortabelle.

Hybride Suche direkt in PostgreSQL

Keine separate Vektordatenbank: pgvector (Kosinus-Distanz) und die deutsche Volltextsuche von PostgreSQL (websearch_to_tsquery) laufen in einer Datenbank. Ein deterministischer Reranker gewichtet Vektor-Score, Keyword-Ranking und Begriffsüberlappung in Inhalt und Überschriften.

Routing über zwei Korpora

Juristisches Material fließt nur ein, wenn die Frage rechtliche Signale trägt – etwa „§“, „Gesetz“ oder „Elternzeit“ – oder sein Score einen höheren Schwellenwert überschreitet. So bleiben Alltagsantworten sauber und Rechtsfragen fundiert.

Chat mit Streaming und strukturierten Zitaten

Folgefragen verdichtet ein LLM mit dem Verlauf zu eigenständigen Suchanfragen. Antworten kommen per Server-Sent Events, Zitate strukturiert: Wiki-URL und Titel oder Ausgabe, Seiten und Abschnitt. Fehlt passender Kontext, sagt der Assistent das, statt zu raten.

Anmeldung und Verwaltung

Session-basierte Authentifizierung mit Argon2, gespeicherte Chat-Verläufe, ein Admin-Bereich mit Benutzerverwaltung und CSV-Import sowie eine Typer-CLI für Betriebsaufgaben.

Betrieb

Datenbankmigrationen mit Alembic, nächtliche Re-Ingestion per Cron im App-Container und selbst gehostetes Langfuse: Über Trace-IDs hängt das Feedback der Nutzer an der jeweiligen Antwort. Ausgeliefert als ein Image hinter Traefik, TLS über Let’s Encrypt.

07 — Weiter

Mehr davon.

Die Leistung

KI-Wissensassistenten (RAG)

Assistenten, die Antworten aus eurem Wiki, euren PDFs und Handbüchern liefern. Mit Quellenangabe, Zugriffsrechten und gemessener Qualität.

So baue ich Wissensassistenten

Ähnliches Projekt

Multi-Agenten-System im Konzern

Spezialisierte Agenten beantworten Analysefragen über mehrere Datenquellen hinweg, in einer Chat-Oberfläche mit Live-Streaming.

Zur Case Study

Projekt anfragen

Euer Wissen als Chat – mit Quellen?

Schreib mir in zwei, drei Sätzen, worum es geht. Du bekommst innerhalb eines Werktags eine ehrliche Einschätzung – auch wenn sie lautet, dass du gar keine KI brauchst.