AACsearch
Relevance Studio

Vue d'ensemble de Relevance Studio

Qu'est-ce que Relevance Studio, les 16 panneaux d'administration organisés en 5 domaines (Pertinence, LTR, Health & Scale, Multi-région, Analytics & Debug) et quand utiliser Studio.

Relevance Studio est la salle de contrôle réservée aux administrateurs pour régler, observer et faire évoluer AACsearch. Il est livré sous forme d'un ensemble de 16 panneaux dans apps/saas et reste volontairement distinct du Dashboard quotidien : Studio est l'endroit où un search engineer ou un platform owner ajuste le classement, lance des expériences LTR, surveille la santé du cluster, gère la réplication multi-région et débogue le chemin de lecture.

Si vous êtes éditeur de contenu et ajustez des synonymes ou des curations, utilisez plutôt Dashboard → Réglage de pertinence. Studio est la surface plus lourde — elle requiert le rôle admin et expose des fonctions susceptibles de modifier le classement pour toute l'organisation.

Accès

  • Gate de rôle : Studio requiert admin ou owner sur l'organisation active. Les utilisateurs member voient une bannière 403.
  • Gate de plan : les domaines LTR et Multi-région exigent en plus le plan Scale ou supérieur (voir Plans et limites).
  • Route : /[orgSlug]/studio/<domaine>/<panneau>.

L'arbre des surfaces Studio

Les 16 panneaux sont regroupés en 5 domaines. L'arbre ci-dessous reproduit la forme rendue par la barre latérale dans l'app SaaS.

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 uniquement)"]:::root

    Root --> Relevance["1 · Pertinence"]:::area
    Root --> LTR["2 · Learning to Rank"]:::area
    Root --> Health["3 · Health & Scale"]:::area
    Root --> CrossRegion["4 · Multi-région"]:::area
    Root --> Analytics["5 · Analytics & Debug"]:::area

    Relevance --> R1["Poids de champs"]:::panel
    Relevance --> R2["Boosts & décroissance"]:::panel
    Relevance --> R3["Presets"]:::panel
    Relevance --> R4["Personnalisation"]:::panel

    LTR --> L1["Feedback de clics"]:::panel
    LTR --> L2["Exécutions d'entraînement"]:::panel
    LTR --> L3["Modèles"]:::panel
    LTR --> L4["Tests A/B"]:::panel

    Health --> H1["Santé du cluster"]:::panel
    Health --> H2["Planificateur de capacité"]:::panel
    Health --> H3["Journal des requêtes lentes"]:::panel

    CrossRegion --> C1["Carte des réplicas"]:::panel
    CrossRegion --> C2["Tableau de retard"]:::panel

    Analytics --> A1["Inspecteur de requêtes"]:::panel
    Analytics --> A2["Explicateur de classement"]:::panel
    Analytics --> A3["Rejeu d'audit"]:::panel

Les 5 domaines en un coup d'œil

1 · Pertinence

Réglages statiques, pilotés par l'éditeur, qui façonnent le classement avant qu'un modèle appris ne soit appliqué.

PanneauCe qu'il règle
Poids de champsquery_by_weights par champ (p. ex. title:4, brand:2, description:1)
Boosts & décroissanceBoosts numériques (récence de prix, popularité, decay géo)
PresetsPaquets nommés de poids + filtres réutilisables entre SDKs
PersonnalisationBoosts de profil, segment-rank, reranking de session (voir Personnalisation)

2 · Learning to Rank (LTR)

Le pipeline complet piloté par le feedback : ingestion de clics → debias → entraînement → test A/B → activation.

PanneauRôle dans la boucle
Feedback de clicsClics bruts + résumé de la correction de biais de position
Exécutions d'entraînementLancer, surveiller et inspecter les jobs d'entraînement
ModèlesModèles entraînés versionnés avec métriques (NDCG, MRR, AUC)
Tests A/BExpériences split-traffic avec significativité par z-test

Le workflow LTR complet a sa page dédiée — voir Learning to Rank.

3 · Health & Scale

Visibilité opérationnelle sur le cluster Typesense sous-jacent et le pipeline d'ingestion.

PanneauCe qu'il expose
Santé du clusterStatut des nœuds, marge mémoire, âge des snapshots
Planificateur de capacitéCompte projeté de docs, RAM à p50/p95, taille de nœud conseillée
Journal des requêtes lentesRequêtes p99 par index, avec sortie explain

4 · Multi-région

Réplication multi-région et failover — plan Scale uniquement.

PanneauCe qu'il expose
Carte des réplicasOù chaque index est répliqué (primary + read replicas)
Tableau de retardRetard de réplication par région en secondes, avec seuils d'alerte

5 · Analytics & Debug

Forensique par requête et outils de reproductibilité.

PanneauObjet
Inspecteur de requêtesRejouer toute requête historique avec ses entrées de classement exactes
Explicateur de classementDécomposition du score par document (texte + boosts + LTR + personnalisation)
Rejeu d'auditChaque édition Studio ayant affecté le classement sur la fenêtre

Quand utiliser Studio

Utilisez Studio lorsque vous devez répondre à une de ces questions :

  • "Pourquoi ce produit est-il tombé à la position 12 mardi ?" → Explicateur de classement
  • "Les clics s'améliorent-ils depuis les nouveaux poids de title ?" → Tests A/B + Feedback de clics
  • "Quelle marge avons-nous avant un nœud plus gros ?" → Planificateur de capacité
  • "Le réplica EU est-il en retard ?" → Tableau de retard
  • "Pourquoi 'electric guitar' est lente ?" → Journal des requêtes lentes + Inspecteur de requêtes
  • "Devons-nous personnaliser pour les utilisateurs connectés ?" → Personnalisation

Pour le travail purement éditorial (ajouter un synonyme, épingler un produit), restez dans le Dashboard — il reste disponible pour tous les sièges, y compris le rôle member.

Pour aller plus loin

On this page