Docs

Hints contextuales

Cuando un match cae en banda MEDIA y necesita revisión humana, Prize muestra un hint en lenguaje natural sobre qué notó el motor. Sirve para que un humano resuelva el match en segundos — no en minutos comparando atributos manualmente.

Qué es un hint

Un texto corto que describe la diferencia más relevante entre tu SKU y el candidato del competidor. Aparece en la card del match, justo arriba del botón de confirmación.

Ejemplos en producción:

  • "El sufijo PSA indica versión regional. Confirmá que sea el mismo modelo vendido en AR."
  • "Pulgadas distintas: 55" vs 65"."
  • "Mismo modelo, distintas variantes de color (negro vs blanco)."
  • "Capacidad diferente: 128 GB vs 256 GB."

Tipos de hints

| Tipo | Cuándo aparece | |------|----------------| | Atributo divergente | Un atributo JSON difiere significativamente (pulgadas, capacidad, kg, watts). | | Sufijo regional | Mismo modelo base con sufijo de variante regional (PSA, AR, NA, EU). | | Color o variante visible | Mismo modelo, color distinto. | | Año o generación | Series con números (Galaxy S22 vs S23, iPhone 14 vs 15). | | Packaging o bundle | Mismo producto pero con/sin accesorios (TV con soporte, celular con cargador). | | Edición especial | Mismo modelo en edición limitada o promocional. |

Hints típicos por categoría

| Categoría | Hints frecuentes | |-----------|-----------------| | TV | Pulgadas distintas · Panel distinto (LED vs OLED) · Refresh rate · Smart vs no-Smart | | Celulares | Capacidad de almacenamiento · RAM · Color · Generación · Variante regional | | Heladeras | Litros · No-Frost vs Cycle Defrost · Doble freezer · Clase energética | | Lavarropas | Kg · RPM · Carga frontal vs superior · Función vapor | | Notebooks | Procesador · RAM · Almacenamiento · GPU · Pulgadas | | Pequeños electro | Watts · Capacidad · Color · Edición especial |

Cómo Prize genera hints automáticamente

Los hints se generan automáticamente comparando el campo attributes JSON de tu SKU con los atributos extraídos del candidato del competidor. Cuando hay divergencia significativa en algún atributo, el hint se compone con esa diferencia en lenguaje natural.

TIP · MÁS RICO EL JSON, MEJORES HINTS

Cuanto más completo el campo attributes de tus SKUs (pulgadas, capacidad, color, año, generación), más útiles los hints. Si tu JSON sólo tiene \{"pulgadas": 55\}, los hints van a hablar sólo de pulgadas. Si tiene 6–8 atributos, Prize identifica con precisión la diferencia más relevante.

Detalle del schema en Atributos · Custom attributes (JSON).

Lo que NO es un hint

Algunas señales ya bajan el score lo suficiente como para no necesitar hint — el match cae a BAJA y se descarta automáticamente. No verás hints sobre:

  • Marca distinta — Samsung vs LG. Score directo a BAJA, no hay match para revisar.
  • Categoría completamente distinta — TV vs Heladera. Mismo tratamiento.
  • Modelo radicalmente diferente — sin coincidencia parcial, no hay candidato.

Los hints son la herramienta del caso ambiguo — donde el motor no puede decidir solo y un humano agrega valor mirando el detalle.

Próximos pasos