Einleitung

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md (Stand 06/2026, dort als laufend ergänzt markiert).

Zielgruppe: Community-Admins und Redakteur:innen. Kein Entwickler-Wissen vorausgesetzt.

Renate ist der KI-Assistent der Ausbilder-Community (AuCo). Sie beantwortet Fragen rund um die Berufsausbildung in Deutschland und greift dabei auf die Lernhappen der Ausbilderakademie.digital sowie auf Beiträge aus dem Community-Forum zurück.

Renate läuft lokal — kein Cloudanruf, keine Datenweitergabe an externe Dienste.

Dieses Handbuch richtet sich an alle, die Renate im Alltag betreuen: neue Lernhappen einspeisen, den Systemstatus prüfen, häufige Probleme selbst lösen — ohne dafür Entwickler-Wissen zu brauchen. Für die technische Tiefe (Deployment, Logs, Server) siehe stattdessen docs/OPS.md im Code-Repository.

Wer stattdessen wissen möchte, wie Renate für die Community insgesamt funktioniert, findet das im AuCo-Segment; wer die Forschung dahinter sucht, im Forschungs-Segment.

Systemübersicht

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md.

Discourse (Community-Forum)
    ↓ Fragen der Ausbilder
Renate (Chatbot-Frontend)
    ↓ Anfrage
RAG-Backend (Retrieval)       ← Lernhappen + Forum-Beiträge (Teich)
    ↓ Kontext
LLM (Renate's Gehirn)         ← lokal via llama.cpp / Ollama
    ↓ Antwort
Renate (Chatbot-Frontend)

Komponenten und ihre Ports:

Starten & Stoppen

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md.

Alle Dienste laufen auf renate.chat. Start- und Stop-Skripte liegen unter backend/:

# Einzelne Dienste starten (auf dem Server, im /opt/renate-Verzeichnis)
bash backend/run-auco-service.sh
bash backend/run-ingest-service.sh
bash backend/run-picnic-workflow.sh
bash backend/run-auth-proxy.sh

# Einzelne Dienste stoppen
bash backend/stop-auco-service.sh
# … analog für alle Dienste

Systemstatus prüfen:

curl http://127.0.0.1:9090/health   # Chatbot-Kern (Version, Modell, Reranker)
curl http://127.0.0.1:9091/health   # Lernhappen-Einspeisung (Chunk-Anzahl)

→ Technische Details für Entwickler: docs/OPS.md

Lernhappen pflegen

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md — Teile davon waren dort bereits als offen markiert ("noch in Entwicklung", "folgt") und sind hier bewusst so belassen, nicht ausgedacht ergänzt.

Lernhappen hinzufügen (Picknick)

Renate lernt durch Picknicks — das ist der Begriff dafür, ihr neue Lernhappen beizubringen.

Im Chat

Tippe im Chat einfach:

/picnic

Oder in natürlicher Sprache: “Lass uns ein Picknick machen”

Renate antwortet mit einer Bestätigung, z. B.:

„Picknick beendet! Ich habe heute 14 neue Lernhappen aufgenommen — 11 aus der Ausbilderakademie, 3 neue Beiträge aus dem Forum.“

Quellen

Hinweis: Der Picknick-Befehl ist noch in Entwicklung — Picnic command: slash-command to batch-ingest Lernhappen (Bean 1mv9).

Neue Lernhappen erstellen

outline stub Noch offen — Prozess wird hier dokumentiert, sobald das Redaktions-Workflow steht.

Lernhappen sind Markdown-Dateien im Verzeichnis backend/data/pond/. Jede Datei entspricht einem Wissensthema.

Format: folgt

Monitoring

outline stub Noch offen — wird ausgefüllt, sobald das Dashboard steht (Bean 1akg: Persist unanswered AuCo questions in Redis + Dashboard via MotherDuck Dive).

Kennzahlen, die überwacht werden sollen:

• Anzahl beantworteter / unbeantworteter Fragen
• Antwortzeit (P50 / P95)
• Teich-Größe (Anzahl Lernhappen im Vektorspeicher)

Häufige Probleme

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md.

Grenzen des Systems

draft Erste Fassung, 2026-07-21. Übernommen aus docs/betriebshandbuch.md.

Renate ist kein Ersatz für:

• Rechtsberatung (Abmahnung, Kündigung, Vertragsrecht → Handwerkskammer)
• Terminverwaltung oder Kalender-Integration
• Persönliche Beratungsgespräche

Sie verweist bei außerhalb ihres Bereichs liegenden Fragen explizit weiter.

Kontakte

outline stub Übernommen aus docs/betriebshandbuch.md — dort noch mit "folgt" markierte Zeilen sind hier bewusst offen gelassen, nicht ausgedacht ergänzt.