Relevance Studio Übersicht
Was Relevance Studio ist, die 16 Admin-Panels gegliedert in 5 Bereiche (Relevanz, LTR, Health & Scale, Cross-Region, Analytics & Debug) und wann Studio verwendet wird.
Relevance Studio ist der admin-only-Kontrollraum zum Tunen, Beobachten
und Skalieren von AACsearch. Es wird als Sammlung von 16 Panels innerhalb
von apps/saas ausgeliefert und ist bewusst vom Tagesgeschäfts-Dashboard
getrennt: Studio ist der Ort, an dem ein Search Engineer oder
Platform Owner das Ranking tunt, LTR-Experimente fährt, die Cluster-
Gesundheit prüft, die Cross-Region-Replikation verwaltet und den Read-Pfad
debuggt.
Wenn Sie Content-Editor sind und Synonyme oder Curations pflegen, nutzen Sie stattdessen Dashboard → Relevance Tuning. Studio ist die schwerere Oberfläche — sie erfordert die Admin-Rolle und zeigt Funktionen, die das Ranking der gesamten Organisation verändern können.
Zugriff
- Rollen-Gate: Studio erfordert
adminoderownerauf der aktiven Organisation. Member sehen stattdessen ein 403-Banner. - Plan-Gate: Die Bereiche LTR und Cross-Region erfordern zusätzlich den Scale-Plan oder höher (siehe Pläne & Limits).
- Route:
/[orgSlug]/studio/<bereich>/<panel>.
Der Studio-Surface-Tree
Die 16 Panels sind in 5 Bereiche gruppiert. Der Baum unten entspricht der Form, die die Sidebar in der SaaS-App rendert.
flowchart LR
classDef area fill:#dbeafe,stroke:#1d4ed8,color:#1e3a8a
classDef panel fill:#fef3c7,stroke:#b45309,color:#78350f
classDef root fill:#ede9fe,stroke:#6d28d9,color:#4c1d95
Root["Relevance Studio<br/>(admin-only)"]:::root
Root --> Relevance["1 · Relevanz"]:::area
Root --> LTR["2 · Learning to Rank"]:::area
Root --> Health["3 · Health & Scale"]:::area
Root --> CrossRegion["4 · Cross-Region"]:::area
Root --> Analytics["5 · Analytics & Debug"]:::area
Relevance --> R1["Feldgewichte"]:::panel
Relevance --> R2["Boosts & Decay"]:::panel
Relevance --> R3["Presets"]:::panel
Relevance --> R4["Personalisierung"]:::panel
LTR --> L1["Click-Feedback"]:::panel
LTR --> L2["Training Runs"]:::panel
LTR --> L3["Modelle"]:::panel
LTR --> L4["A/B-Tests"]:::panel
Health --> H1["Cluster-Health"]:::panel
Health --> H2["Capacity Planner"]:::panel
Health --> H3["Slow-Query-Log"]:::panel
CrossRegion --> C1["Replica-Map"]:::panel
CrossRegion --> C2["Lag-Dashboard"]:::panel
Analytics --> A1["Query Inspector"]:::panel
Analytics --> A2["Ranking Explainer"]:::panel
Analytics --> A3["Audit Replay"]:::panelDie 5 Bereiche im Überblick
1 · Relevanz
Statische, editor-getriebene Stellschrauben, die das Ranking bevor ein gelerntes Modell greift, formen.
| Panel | Was wird getunt |
|---|---|
| Feldgewichte | Pro-Feld query_by_weights (z. B. title:4, brand:2, description:1) |
| Boosts & Decay | Numerische Feld-Boosts (Preis-Aktualität, Popularität, Geo-Decay) |
| Presets | Benannte Bündel von Gewichten + Filtern, SDK-übergreifend wiederverwendbar |
| Personalisierung | User-Profil-Boosts, Segment-Rang, Session-Reranking (siehe Personalisierung) |
2 · Learning to Rank (LTR)
Die komplette feedback-getriebene Pipeline: Klicks einlesen → debiasen → trainieren → A/B-Test → aktivieren.
| Panel | Rolle in der Loop |
|---|---|
| Click-Feedback | Rohe Klicks + Zusammenfassung der Position-Bias-Korrektur |
| Training Runs | Trainingsjobs starten, beobachten und inspizieren |
| Modelle | Versionierte trainierte Modelle mit Metriken (NDCG, MRR, AUC) |
| A/B-Tests | Split-Traffic-Experimente mit z-Test-Signifikanz |
Der vollständige LTR-Workflow hat eine eigene Seite — siehe Learning to Rank.
3 · Health & Scale
Operative Sicht auf den darunterliegenden Typesense-Cluster und die Ingest-Pipeline.
| Panel | Zeigt |
|---|---|
| Cluster-Health | Node-Status, RAM-Reserve, Snapshot-Alter |
| Capacity Planner | Projizierte Dokumentanzahl, RAM bei p50/p95, empfohlene Node-Größe |
| Slow-Query-Log | p99-Queries pro Index inkl. Explain-Ausgabe |
4 · Cross-Region
Multi-Region-Replikation und Failover — nur Scale-Plan.
| Panel | Zeigt |
|---|---|
| Replica-Map | Wo jeder Index repliziert ist (Primary + Read-Replicas) |
| Lag-Dashboard | Replikations-Lag pro Region in Sekunden, mit Alarmschwellen |
5 · Analytics & Debug
Per-Query-Forensik und Reproduzierbarkeits-Tools.
| Panel | Zweck |
|---|---|
| Query Inspector | Jede historische Query mit ihren genauen Ranking-Inputs nachspielen |
| Ranking Explainer | Score-Aufschlüsselung pro Dokument (Text + Boosts + LTR + Personalisierung) |
| Audit Replay | Jede Studio-Änderung, die das Ranking im Zeitfenster beeinflusst hat |
Wann Studio verwenden
Studio ist die richtige Wahl, wenn Sie eine dieser Fragen beantworten müssen:
- "Warum ist dieses Produkt am Dienstag auf Position 12 gefallen?" → Ranking Explainer
- "Verbessern sich Klicks seit den neuen Title-Gewichten?" → A/B-Tests + Click-Feedback
- "Wie viel Headroom haben wir vor einem größeren Node?" → Capacity Planner
- "Hängt die EU-Replica hinterher?" → Lag-Dashboard
- "Warum ist 'electric guitar' so langsam?" → Slow-Query-Log + Query Inspector
- "Sollten wir für eingeloggte User personalisieren?" → Personalisierung
Für reine Editor-Arbeit (Synonym anlegen, Produkt pinnen) bleiben Sie im
Dashboard — das ist für alle Sitze inkl.
member verfügbar.
Weiterlesen
- Personalisierung — Profile, Segmente, Session-Reranking, Empfehlungen.
- Learning to Rank — Click-Feedback, Training, A/B-Tests, Aktivierung.
- Architektur → Analytics-Feedback-Loop — die zugrundeliegende Event-Pipeline, die Studio liest.
- Dashboard → Relevance Tuning — das editor-orientierte Gegenstück.
Analyse-Feedback-Loop
Wie eine Suchanfrage zu einem SearchUsageEvent wird, wie Klicks und Conversions aufgezeichnet werden und wie die Aggregation das Dashboard für das Relevanz-Tuning speist.
Personalisierung
Benutzerprofile, Segmente, Session-Reranking und Empfehlungen in Relevance Studio. Wie personalize=true + sessionId Profil-Boosts ins Ranking verdrahten, plus Best Practices zu PII.