En esta página se describen los pasos para solucionar problemas que pueden resultarte útiles si tienes algún problema mientras usas Product Search de la API Vision.
Resultados de búsqueda
¿Cuál es el número máximo de resultados devueltos?
El número máximo de resultados devueltos variará de una consulta a otra debido a los detalles de implementación. El número máximo garantizado de resultados devueltos es 500. Si se solicitan más, es posible que no se cumpla el número solicitado.
¿Puedo definir un umbral de puntuación para los resultados?
Las puntuaciones de los resultados de búsqueda no están calibradas. Esto significa que las puntuaciones de los resultados de una consulta determinada serán comparables (así es como se clasifican los resultados). Sin embargo, las puntuaciones de los resultados de la consulta A y la consulta B no son necesariamente comparables. Esto significa que no hay un umbral fijo adecuado para un caso práctico concreto.
Puedes definir un umbral en función de tus propios experimentos. Si quieres definir un umbral, debes hacerlo por cada etiqueta de artículo. Esto significa que debes definir un umbral de puntuación de resultados para "Zapatos" independientemente de "Bolsos", etc., para cada etiqueta.
¿Hay alguna forma de saber por qué un resultado concreto se ha clasificado por encima de otro?
Actualmente, Product Search de la API de Vision no admite ninguna función que explique por qué se ha devuelto un resultado concreto.
¿Qué diferencia hay entre usar productGroupedResults y usar la función Object Localizer de la API Vision?
La respuesta productGroupedResults devolverá una lista de los elementos detectados, su etiqueta y puntuación predichas, sus cuadros delimitadores y una lista clasificada de resultados de búsqueda de productos para cada elemento. Esta respuesta equivale a enviar primero la imagen de consulta a la función de localizador de objetos de la API Vision y, a continuación, enviar la imagen junto con el cuadro delimitador de cada producto (filtrado por las etiquetas pertinentes) a Product Search de la API Vision.
Una de las ventajas de usar productGroupedResults es que es más rápido y directo, ya que solo hace una llamada a la API. Sin embargo, si hay alguna lógica de aplicación personalizada que deba implementarse entre la detección de objetos y la consulta de búsqueda, un método de dos pasos es una buena opción. Un ejemplo de este caso sería añadir filtros de Product Search de la API de Vision basados en etiquetas de objetos.
Si sé dónde está un producto en una imagen, ¿debo recortarla antes de enviar una consulta a la API?
Esta situación puede darse si, por ejemplo, se permite a un usuario dibujar un cuadro delimitador alrededor del elemento que quiere buscar. Por lo general, no debes recortar la imagen antes de enviarla a la API. El motivo es que nuestra API usará tanto el cuadro delimitador de la consulta para devolver resultados específicos como el contexto general de la imagen, lo que suele ser útil para mejorar los resultados.
Imágenes de referencia
¿Qué son las imágenes de referencia de productos de buena calidad?
Las imágenes de referencia de buena calidad muestran el producto con claridad y no incluyen ningún otro objeto. Un ejemplo típico de buenas imágenes de referencia son las imágenes de "packshot". Estas imágenes se suelen usar para mostrarle al usuario un producto en la página del producto o en la publicidad, y normalmente se toman delante de un fondo blanco. Las imágenes del producto en otros entornos también son buenas imágenes de referencia, siempre que no haya otros productos en la imagen. Debes usar todas las imágenes de referencia que estén disponibles.
¿Cuál es el tamaño de imagen ideal para las imágenes de referencia y las imágenes que se usan para buscar productos?
En una imagen ideal, el producto es el elemento principal y ocupa la mayor parte de la imagen. Las imágenes que solo muestren una representación pequeña o poco clara de un producto darán resultados menos satisfactorios. Por lo tanto, el tamaño aparente del producto en la imagen es más importante que el tamaño específico de la imagen. Sin embargo, como recomendación general, utiliza imágenes de 600 píxeles o más en el lado más largo para las imágenes de referencia y de búsqueda.
¿Cuál es el número óptimo de imágenes de referencia para un producto concreto?
Product Search de la API Vision puede funcionar bien incluso con una sola imagen de referencia de un producto. Normalmente, con entre 3 y 8 imágenes se obtiene la información necesaria para obtener resultados adecuados de Product Search de la API Vision, sobre todo si estas imágenes tienen algunas variaciones. Estas variaciones incluyen diferentes orientaciones del producto, iluminación o fondos. Se pueden añadir imágenes de referencia adicionales al índice, lo que no debería reducir la precisión.
¿Cómo puedo conseguir más imágenes de referencia de mis productos?
La mejor forma de mejorar la precisión de Product Search de la API Vision es añadir más imágenes de referencia de buena calidad de los productos. Si ya ha subido un conjunto representativo de imágenes de producto y quiere aumentar la precisión de algunos productos, puede usar otras imágenes que ya tenga o recoger más imágenes de esos productos.
Para usar otras imágenes, asegúrate de que muestren claramente el producto y de que no tengan otros objetos que distraigan. Por ejemplo, puede que tengas fotos de un modelo que lleva una camiseta concreta con pantalones. Esta imagen por sí sola no sería una buena imagen de referencia para el producto de la camiseta. Sin embargo, si proporcionas un cuadro delimitador alrededor de la camisa o recortas la imagen para que solo se vea la camisa, sería una buena imagen de referencia. Puedes usar la función Localizador de objetos de la API Vision para proponer cuadros. Este método se puede usar junto con las anotaciones de recuadros proporcionadas por humanos o en lugar de ellas.
¿Aumentaría la precisión de la API si añadiera aumentos de datos a mi conjunto de productos?
La idea de añadir versiones aumentadas de imágenes de referencia (por ejemplo, volteos de izquierda a derecha, contraste con fluctuaciones, etc.) es sensata, pero normalmente no aumenta mucho la precisión.
Gestión de los datos
¿Cuál es la forma recomendada de actualizar un conjunto de productos en producción?
Actualice su conjunto de productos con productos nuevos a medida que cambie su inventario. Si los cambios son pequeños, puedes añadir o eliminar productos según sea necesario. Si hay un cambio significativo en tu inventario o en tus imágenes de referencia, puedes crear un nuevo conjunto de productos con los cambios y probar la calidad de la búsqueda antes de cambiar por completo al nuevo conjunto. En cualquier caso, debe registrar qué productos e imágenes hay en su conjunto de productos guardando el archivo CSV de importación por lotes para poder consultarlo o restaurarlo fácilmente.