Seminar CrafterCMS – OpenSearch, Suche, Vektorsuche und RAG

Dieses praxisorientierte Seminar verbindet fachliche Einordnung, nachvollziehbare Konfigurationsschritte und kontrollierte Übungen an einer durchgängigen CrafterCMS-Laborumgebung. Eine produktionsnahe Suchlösung kombiniert strukturierte Filter, textuelle Relevanz und semantisches Retrieval mit sicheren Betriebsverfahren.

Inhaltsverzeichnis

1. Zielsetzung
2. 1. Suchanforderungen und Indexmodell
3. 2. Indexierung, Mapping und Reindex
4. 3. Queries, Filter, Facetten und Vorschläge
5. 4. Relevanz, Bewertung und A/B-Vergleich
6. 5. Vektorsuche und hybride Retrieval-Strategie
7. 6. RAG, Sicherheit und Antwortqualität
8. 7. Performance, Monitoring und Betrieb
9. Praxisprojekt und Qualitätssicherung
10. Zielgruppe und Voraussetzungen
11. Didaktik und Arbeitsweise

Zielsetzung

Eine produktionsnahe Suchlösung kombiniert strukturierte Filter, textuelle Relevanz und semantisches Retrieval mit sicheren Betriebsverfahren. Die einzelnen Arbeitsschritte werden jeweils mit einem definierten Ausgangszustand, einem erwarteten Prüfergebnis und einer dokumentierten Korrekturmöglichkeit durchgeführt.

Seminarinhalte

1. Suchanforderungen und Indexmodell

Suchfälle, Filter, Sprachen und Relevanzsignale werden in ein gezieltes Indexschema überführt. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Suchaufgaben und Nutzerintentionen priorisieren. Prüfpunkt: Relevanz kann an realen Aufgaben gemessen werden.
2. Schritt 2: Indexierte Felder, Datentypen und Analyseketten festlegen. Prüfpunkt: Schema unterstützt Suche und Filter.
3. Schritt 3: Sprach- und Inhaltsvarianten berücksichtigen. Prüfpunkt: Analyse passt zu den Zielsprachen.
4. Schritt 4: Berechtigungs- und Sichtbarkeitsmerkmale aufnehmen. Prüfpunkt: Spätere Filterung ist technisch möglich.
5. Schritt 5: Testdokumente und Referenzqueries definieren. Prüfpunkt: Ausgangsqualität ist messbar.

2. Indexierung, Mapping und Reindex

Publishing und Suchindex werden konsistent verbunden und kontrolliert wiederaufgebaut. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Content-Felder auf Indexfelder abbilden. Prüfpunkt: Dokumente enthalten die erwarteten Werte.
2. Schritt 2: Indexvorlage und Einstellungen konfigurieren. Prüfpunkt: Mapping ist reproduzierbar.
3. Schritt 3: Publishing-Ereignis bis zum Indexeintrag verfolgen. Prüfpunkt: Aktualisierung ist nachvollziehbar.
4. Schritt 4: Mappingänderung mit neuem Index und Umschaltung durchführen. Prüfpunkt: Schema kann ohne unkontrollierten Ausfall geändert werden.
5. Schritt 5: Reindex- und Fehlerprotokoll prüfen. Prüfpunkt: Fehlende Dokumente werden erkannt.

3. Queries, Filter, Facetten und Vorschläge

Strukturierte und freie Suche werden zu einer verständlichen Nutzerführung kombiniert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Volltextquery mit Feldgewichtung erstellen. Prüfpunkt: Kernbegriffe liefern erwartete Treffer.
2. Schritt 2: Filter für Typ, Sprache, Kategorie und Zeitraum ergänzen. Prüfpunkt: Ergebnismenge lässt sich kontrolliert eingrenzen.
3. Schritt 3: Facetten und Zählungen implementieren. Prüfpunkt: Nutzer sieht sinnvolle Navigationsoptionen.
4. Schritt 4: Sortierung, Paging und Vorschläge konfigurieren. Prüfpunkt: Interaktion bleibt auch bei großen Mengen stabil.
5. Schritt 5: Leere und mehrdeutige Anfragen behandeln. Prüfpunkt: Oberfläche liefert hilfreiche Rückmeldung.

4. Relevanz, Bewertung und A/B-Vergleich

Ranking wird mit Referenzfällen und messbaren Kriterien statt nach Einzelgefühl optimiert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Bewertete Query-Treffer-Paare erstellen. Prüfpunkt: Ein kleines Relevanzset liegt vor.
2. Schritt 2: Feldgewichtung, Phrase, Aktualität und Popularität testen. Prüfpunkt: Wirkung einzelner Signale ist sichtbar.
3. Schritt 3: Zwei Rankingvarianten automatisiert vergleichen. Prüfpunkt: Verbesserung ist messbar.
4. Schritt 4: Ausreißer und Nulltreffer analysieren. Prüfpunkt: Ursachen sind klassifiziert.
5. Schritt 5: Freigegebene Relevanzkonfiguration versionieren. Prüfpunkt: Änderungen bleiben nachvollziehbar.

5. Vektorsuche und hybride Retrieval-Strategie

Semantische Ähnlichkeit wird mit textueller Präzision und fachlichen Filtern verbunden. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Segmentierungs- und Embedding-Strategie festlegen. Prüfpunkt: Vektoren repräsentieren sinnvolle Inhaltseinheiten.
2. Schritt 2: Vektorfeld und kNN-Abfrage konfigurieren. Prüfpunkt: Semantisch ähnliche Inhalte werden gefunden.
3. Schritt 3: Text- und Vektorergebnisse normalisieren und kombinieren. Prüfpunkt: Hybride Rangfolge ist stabil.
4. Schritt 4: Metadaten- und Berechtigungsfilter anwenden. Prüfpunkt: Semantik umgeht keine fachlichen Grenzen.
5. Schritt 5: Qualität gegen das Relevanzset prüfen. Prüfpunkt: Mehrwert gegenüber reiner Volltextsuche ist belegt.

6. RAG, Sicherheit und Antwortqualität

Retrieval-Ergebnisse werden als begrenzter Kontext für generative Antworten verwendet und gegen Quellenbindung geprüft. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Geeignete Fragmente mit Quelle, Version und Sprache auswählen. Prüfpunkt: Kontext ist nachvollziehbar.
2. Schritt 2: Prompt für quellengebundene Antwort erstellen. Prüfpunkt: Modell soll nur aus bereitgestelltem Kontext antworten.
3. Schritt 3: Berechtigungsfilter vor der Kontextübergabe anwenden. Prüfpunkt: Gesperrte Inhalte bleiben ausgeschlossen.
4. Schritt 4: Nicht beantwortbare Frage und widersprüchliche Fragmente testen. Prüfpunkt: System verweigert oder kennzeichnet Unsicherheit.
5. Schritt 5: Antwortqualität und Retrieval-Qualität getrennt messen. Prüfpunkt: Fehlerursache kann lokalisiert werden.

7. Performance, Monitoring und Betrieb

Suchlatenz, Indexwachstum, Fehler und Reindex werden als Betriebsprozess abgesichert. Zu jedem Arbeitsschritt wird geprüft, ob Konfiguration, Inhalt und Betriebszustand dem erwarteten Ergebnis entsprechen.

Schritt-für-Schritt

1. Schritt 1: Lastprofil und Zielwerte für Suche und Indexierung definieren. Prüfpunkt: Performanceziel ist messbar.
2. Schritt 2: Langsame Queries und große Aggregationen analysieren. Prüfpunkt: Engpässe werden eingegrenzt.
3. Schritt 3: Cache, Shards und Ressourcen gezielt anpassen. Prüfpunkt: Optimierung ist durch Messung bestätigt.
4. Schritt 4: Indexzustand, Fehlerquote und Latenz überwachen. Prüfpunkt: Störungen werden früh erkannt.
5. Schritt 5: Backup, Reindex und Rollback als Runbook testen. Prüfpunkt: Suchdienst ist wiederanlauffähig.

Praxisprojekt und Qualitätssicherung

Für einen mehrsprachigen Content-Bestand wird ein Indexmodell aufgebaut, eine facettierte Suche implementiert, Vektorsuche und hybride Rangfolge ergänzt und eine RAG-Strecke mit Berechtigungsfilter und Qualitätsmessung erstellt. Die Übung wird mit einer Abnahmeliste abgeschlossen, die Funktionsprüfung, Fehlerfall, Dokumentation und reproduzierbaren Wiederanlauf umfasst.

Zielgruppe und Voraussetzungen

Zielgruppe: Search Engineering, Backend- und Full-Stack-Entwicklung, Lösungsarchitektur, AI Engineering und Plattformbetrieb.

Voraussetzungen: Grundkenntnisse in JSON, REST, Suchkonzepten und CrafterCMS Content-Modellen; Erfahrung mit OpenSearch oder vergleichbaren Suchmaschinen ist hilfreich.

Didaktik und Arbeitsweise

Kurze Fachimpulse wechseln mit Demonstrationen, geführten Konfigurationsschritten, eigenständigen Übungen, negativen Testfällen und strukturierten Auswertungen. Ergebnisse werden in Checklisten, Mappingtabellen, Testfällen oder Runbooks festgehalten, damit die erarbeiteten Verfahren im Projekt- und Betriebsalltag wiederholbar bleiben.