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
adminouownersur l'organisation active. Les utilisateursmembervoient 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"]:::panelLes 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é.
| Panneau | Ce qu'il règle |
|---|---|
| Poids de champs | query_by_weights par champ (p. ex. title:4, brand:2, description:1) |
| Boosts & décroissance | Boosts numériques (récence de prix, popularité, decay géo) |
| Presets | Paquets nommés de poids + filtres réutilisables entre SDKs |
| Personnalisation | Boosts 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.
| Panneau | Rôle dans la boucle |
|---|---|
| Feedback de clics | Clics bruts + résumé de la correction de biais de position |
| Exécutions d'entraînement | Lancer, surveiller et inspecter les jobs d'entraînement |
| Modèles | Modèles entraînés versionnés avec métriques (NDCG, MRR, AUC) |
| Tests A/B | Expé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.
| Panneau | Ce qu'il expose |
|---|---|
| Santé du cluster | Statut 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 lentes | Requêtes p99 par index, avec sortie explain |
4 · Multi-région
Réplication multi-région et failover — plan Scale uniquement.
| Panneau | Ce qu'il expose |
|---|---|
| Carte des réplicas | Où chaque index est répliqué (primary + read replicas) |
| Tableau de retard | Retard de réplication par région en secondes, avec seuils d'alerte |
5 · Analytics & Debug
Forensique par requête et outils de reproductibilité.
| Panneau | Objet |
|---|---|
| Inspecteur de requêtes | Rejouer toute requête historique avec ses entrées de classement exactes |
| Explicateur de classement | Décomposition du score par document (texte + boosts + LTR + personnalisation) |
| Rejeu d'audit | Chaque é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
- Personnalisation — profils, segments, reranking de session, recommandations.
- Learning to Rank — feedback de clics, entraînement, tests A/B, activation.
- Architecture → Boucle de feedback analytique — le pipeline d'événements sous-jacent dont Studio se nourrit.
- Dashboard → Réglage de pertinence — la contrepartie côté éditeur.
Boucle de feedback analytique
Comment une requête de recherche devient un SearchUsageEvent, comment les clics et conversions sont enregistrés, et comment l'agrégation alimente le tableau de bord pour l'ajustement de pertinence.
Personnalisation
Profils utilisateur, segments, reranking de session et recommandations dans Relevance Studio. Comment personalize=true + sessionId câblent le boost de profil au classement, et bonnes pratiques sur les PII.