AACsearch
Relevance Studio

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 admin oder owner auf 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"]:::panel

Die 5 Bereiche im Überblick

1 · Relevanz

Statische, editor-getriebene Stellschrauben, die das Ranking bevor ein gelerntes Modell greift, formen.

PanelWas wird getunt
FeldgewichtePro-Feld query_by_weights (z. B. title:4, brand:2, description:1)
Boosts & DecayNumerische Feld-Boosts (Preis-Aktualität, Popularität, Geo-Decay)
PresetsBenannte Bündel von Gewichten + Filtern, SDK-übergreifend wiederverwendbar
PersonalisierungUser-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.

PanelRolle in der Loop
Click-FeedbackRohe Klicks + Zusammenfassung der Position-Bias-Korrektur
Training RunsTrainingsjobs starten, beobachten und inspizieren
ModelleVersionierte trainierte Modelle mit Metriken (NDCG, MRR, AUC)
A/B-TestsSplit-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.

PanelZeigt
Cluster-HealthNode-Status, RAM-Reserve, Snapshot-Alter
Capacity PlannerProjizierte Dokumentanzahl, RAM bei p50/p95, empfohlene Node-Größe
Slow-Query-Logp99-Queries pro Index inkl. Explain-Ausgabe

4 · Cross-Region

Multi-Region-Replikation und Failover — nur Scale-Plan.

PanelZeigt
Replica-MapWo jeder Index repliziert ist (Primary + Read-Replicas)
Lag-DashboardReplikations-Lag pro Region in Sekunden, mit Alarmschwellen

5 · Analytics & Debug

Per-Query-Forensik und Reproduzierbarkeits-Tools.

PanelZweck
Query InspectorJede historische Query mit ihren genauen Ranking-Inputs nachspielen
Ranking ExplainerScore-Aufschlüsselung pro Dokument (Text + Boosts + LTR + Personalisierung)
Audit ReplayJede 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

On this page