Sugerencias generales

En esta página, se describen los pasos que debes seguir a la hora de solucionar problemas que pueden resultarte útiles si tienes problemas para usar la API de Vision para Product Search.

Resultados de la búsqueda

¿Cuál es la cantidad máxima de resultados que se muestran?

La cantidad máxima de resultados que se muestran variará según la consulta debido a los detalles de la implementación. La cantidad máxima garantizada de resultados que se mostrarán es de 500. Si se solicitan más, es posible que no se llegue a cumplir la cantidad.

¿Puedo establecer un umbral de puntuación para los resultados?

Las puntuaciones de los resultados de la 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 para la consulta A y la consulta B no siempre son comparables. Esto significa que no hay un umbral fijo adecuado para un caso de uso determinado.

Es posible establecer un límite en función de tus propios experimentos. Si deseas configurar un umbral, debes hacerlo en función de una etiqueta por elemento. Esto significa que debes configurar un umbral de puntuación de resultados para “Zapatos” independientes de “Bolsos”, etc. en cada etiqueta.

¿Hay alguna manera de saber por qué un resultado en particular se clasificó en una posición superior a la de otro?

Por el momento, la API de Vision para Product Search no admite ninguna función que explique por qué se mostró un resultado en particular.

¿Cuál es la diferencia entre usar productGroupedResults y la función Localizador de objetos de la API de Vision?

La respuesta productGroupedResults mostrará una lista de elementos detectados, la etiqueta y la puntuación previstas, los cuadros de límite y una lista clasificada de resultados de la búsqueda de productos para cada elemento. Esta respuesta equivale a enviar la imagen de consulta al Localizador de objetos de la API de Vision y, luego, enviar la imagen junto con el cuadro de límite de cada elemento del producto (filtrado según las etiquetas relevantes) a la API de Vision para Product Search.

Uno de los beneficios de usar productGroupedResults es que es más rápido y directo, ya que solo realiza una única 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 búsqueda, se recomienda usar un método de dos pasos. Un ejemplo de este caso sería agregar filtros de la API de Vision para Product Search en función de las etiquetas de objetos.

Si conozco la ubicación de un producto en una imagen, ¿debo recortar la imagen antes de realizar una consulta en la API con ella?

Por ejemplo, esta situación puede surgir si un usuario puede dibujar un cuadro de límite alrededor del elemento que desea buscar. En general, no debes recortar la imagen antes de enviarla a la API. Esto se debe a que nuestra API usará el cuadro de límite de la consulta a fin de mostrar resultados orientados y, también, el contexto general de la imagen, lo que suele ser útil para mejorar los resultados.

Imágenes de referencia

¿Qué tipos de imágenes del producto son ideales para usarse de referencia?

En las imágenes que mejor sirven de referencia se muestra el producto con claridad y no hay ningún otro objeto presente. Un ejemplo típico de imágenes de referencia ideales son las imágenes al estilo “plan de producto”. Estas imágenes se usan con frecuencia para mostrar al usuario un producto en la página del producto o en la publicidad, y suelen tomarse frente a un fondo blanco. Las imágenes del producto en otros contextos también sirven como imágenes de referencia, siempre que no haya otros productos en la imagen. Debes usar todas las imágenes que estén disponibles para las imágenes de referencia.

¿Cuál es el tamaño de imagen ideal para las imágenes de referencia y las imágenes que usas a fin de buscar productos?

Una imagen ideal se enfoca en el producto y, a su vez, el producto ocupa la mayor parte de ella. Las imágenes que contienen solo una representación pequeña o poco clara de un producto producirán resultados menos convenientes. Por lo tanto, el tamaño aparente del producto en la imagen es más importante que el tamaño de la imagen específico. Sin embargo, como recomendación general, usa imágenes con 600 píxeles o más en el lado más grande para las imágenes de referencia y búsqueda.

¿Cuál es la cantidad óptima de imágenes de referencia para un producto en particular?

La API de Vision para Product Search puede funcionar bien incluso con una sola imagen de referencia de un producto. Por lo general, con 3 a 8 imágenes se proporciona la información necesaria a fin de obtener resultados adecuados de la búsqueda de productos de la API de Vision para Product Search, en especial si estas imágenes tienen algunas variaciones. Estas variaciones incluyen diferentes orientaciones del producto, iluminación distinta o un fondo diferente. Se pueden agregar imágenes de referencia adicionales al índice; lo que, en general, no debería disminuir la exactitud.

¿Cómo puedo obtener más imágenes de referencia para mis productos?

La mejor manera de optimizar la precisión de la API de Vision para Product Search es agregar más imágenes que sirvan de referencia de los productos. Si ya subiste un conjunto representativo de imágenes de productos y deseas aumentar la exactitud de algunos productos, puedes usar otras imágenes existentes o recopilar más imágenes para esos productos.

Para usar otras imágenes existentes, asegúrate de que muestren el producto con claridad y que no tengan otros objetos que puedan distraer. Por ejemplo, es posible que tengas fotos de una modelo con una camisa en particular y pantalones. Usar esta imagen de referencia sola no sería ideal para el producto de la camisa. Sin embargo, si proporcionas un cuadro de límite alrededor de la camisa o recortas la imagen para incluir solo la camisa, sería una imagen de referencia ideal. Puedes usar la función Localizador de objetos de la API de Vision para proponer cuadros. Se puede usar este método junto con las anotaciones de cuadros de límites proporcionadas por humanos o en lugar de ellas.

¿Mejoraría la exactitud de la API agregar magnificación de datos a mi conjunto de productos?

La idea de agregar versiones magnificadas de las imágenes de referencia existentes (por ejemplo, giradas de izquierda a derecha, con contraste irregular, etc.) es razonable, pero, por lo general, no aumenta la exactitud.

Administración de datos

Actualiza tu conjunto con productos nuevos a medida que tu inventario se modifique. Si los cambios son pequeños, puedes agregar o borrar productos según sea necesario. Como alternativa, si hay un cambio significativo en tu inventario o en tus imágenes de referencia, puedes crear un conjunto de productos nuevo con los cambios y probar la calidad de búsqueda antes de cambiar completamente al nuevo conjunto. En cualquier caso, debes realizar un seguimiento de los productos y la imagen que se encuentran en el conjunto de productos. Para esto debes guardar el archivo CSV de importación por lotes a fin de facilitar la referencia o la reversión.