Vista general de Relevance Studio
Qué es Relevance Studio, los 16 paneles de administración organizados en 5 áreas (Relevancia, LTR, Health & Scale, Cross-region, Analytics & Debug) y cuándo usar Studio.
Relevance Studio es la sala de control para administradores donde se
ajusta, se observa y se escala AACsearch. Se entrega como un conjunto de 16
paneles dentro de apps/saas y es intencionalmente independiente del
Dashboard del día a día: Studio es donde un search engineer o un
platform owner afinan el ranking, lanzan experimentos LTR, vigilan la
salud del clúster, gestionan la replicación entre regiones y depuran el
camino de lectura.
Si es un editor de contenido que ajusta sinónimos o curations, use en su lugar Dashboard → Ajuste de relevancia. Studio es la superficie más pesada — requiere rol de administrador y expone funciones que pueden cambiar el ranking de toda la organización.
Acceso
- Gate de rol: Studio requiere
adminuowneren la organización activa. Los usuariosmemberven un banner 403. - Gate de plan: las áreas LTR y Cross-region requieren además el plan Scale o superior (ver Planes y límites).
- Ruta:
/[orgSlug]/studio/<area>/<panel>.
El árbol de superficies de Studio
Los 16 paneles se agrupan en 5 áreas. El árbol siguiente es la misma forma que renderiza la barra lateral dentro de la 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/>(solo admin)"]:::root
Root --> Relevance["1 · Relevancia"]:::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["Pesos de campo"]:::panel
Relevance --> R2["Boosts & decay"]:::panel
Relevance --> R3["Presets"]:::panel
Relevance --> R4["Personalización"]:::panel
LTR --> L1["Feedback de clics"]:::panel
LTR --> L2["Ejecuciones de entrenamiento"]:::panel
LTR --> L3["Modelos"]:::panel
LTR --> L4["Tests A/B"]:::panel
Health --> H1["Salud del clúster"]:::panel
Health --> H2["Planificador de capacidad"]:::panel
Health --> H3["Log de consultas lentas"]:::panel
CrossRegion --> C1["Mapa de réplicas"]:::panel
CrossRegion --> C2["Dashboard de retraso"]:::panel
Analytics --> A1["Inspector de consultas"]:::panel
Analytics --> A2["Explicador de ranking"]:::panel
Analytics --> A3["Reproducción de auditoría"]:::panelLas 5 áreas de un vistazo
1 · Relevancia
Mandos estáticos, dirigidos por el editor, que dan forma al ranking antes de que se aplique cualquier modelo aprendido.
| Panel | Qué ajusta |
|---|---|
| Pesos de campo | query_by_weights por campo (p. ej. title:4, brand:2, description:1) |
| Boosts & decay | Boosts de campos numéricos (recencia de precio, popularidad, geo decay) |
| Presets | Paquetes de pesos + filtros reutilizables entre SDKs |
| Personalización | Boosts de perfil, segment-rank, reranking de sesión (ver Personalización) |
2 · Learning to Rank (LTR)
El pipeline completo guiado por feedback: ingerir clics → debias → entrenar → A/B test → activar.
| Panel | Rol en el bucle |
|---|---|
| Feedback de clics | Clics brutos + resumen de corrección de sesgo de posición |
| Ejecuciones de entrenamiento | Lanzar, monitorizar e inspeccionar trabajos de entrenamiento |
| Modelos | Modelos entrenados versionados con métricas (NDCG, MRR, AUC) |
| Tests A/B | Experimentos de split-traffic con significancia por z-test |
El flujo completo LTR tiene su propia página — ver Learning to Rank.
3 · Health & Scale
Visibilidad operacional del clúster Typesense subyacente y del pipeline de ingesta.
| Panel | Muestra |
|---|---|
| Salud del clúster | Estado de nodos, holgura de memoria, antigüedad de snapshots |
| Planificador de capacidad | Conteo proyectado de docs, RAM en p50/p95, tamaño de nodo recomendado |
| Log de consultas lentas | Consultas p99 por índice, con salida de explain |
4 · Cross-region
Replicación multirregional y failover — solo plan Scale.
| Panel | Muestra |
|---|---|
| Mapa de réplicas | Dónde se replica cada índice (primary + read replicas) |
| Dashboard de retraso | Retraso de replicación por región en segundos, con umbrales de alerta |
5 · Analytics & Debug
Forense por consulta y herramientas de reproducibilidad.
| Panel | Propósito |
|---|---|
| Inspector de consultas | Repetir cualquier consulta histórica con sus inputs exactos de ranking |
| Explicador de ranking | Desglose de score por documento (texto + boosts + LTR + personalización) |
| Reproducción de auditoría | Cada edición de Studio que afectó al ranking en la ventana elegida |
Cuándo usar Studio
Use Studio cuando necesite responder una de estas preguntas:
- "¿Por qué este producto cayó a la posición 12 el martes?" → Explicador de ranking
- "¿Están mejorando los clics desde los nuevos pesos de title?" → Tests A/B + Feedback de clics
- "¿Cuánto margen hay antes de necesitar un nodo más grande?" → Planificador de capacidad
- "¿Está retrasada la réplica EU?" → Dashboard de retraso
- "¿Por qué 'electric guitar' va lenta?" → Log de consultas lentas + Inspector de consultas
- "¿Debemos personalizar resultados para usuarios autenticados?" → Personalización
Para tareas puramente editoriales (añadir un sinónimo, fijar un producto)
use el Dashboard — sigue disponible para todos
los asientos incluyendo el rol member.
Leer más
- Personalización — perfiles, segmentos, reranking de sesión, recomendaciones.
- Learning to Rank — feedback de clics, entrenamiento, tests A/B, activación.
- Arquitectura → Bucle de feedback de analítica — la pipeline de eventos subyacente que Studio lee.
- Dashboard → Ajuste de relevancia — la contraparte orientada al editor.
Bucle de feedback analítico
Cómo una consulta de búsqueda se convierte en un SearchUsageEvent, cómo se registran clics y conversiones, y cómo la agregación alimenta el dashboard para el ajuste de relevancia.
Personalización
Perfiles de usuario, segmentos, reranking de sesión y recomendaciones en Relevance Studio. Cómo personalize=true + sessionId cablean el boost de perfil al ranking, y mejores prácticas sobre PII.