Cette page décrit les étapes de dépannage qui peuvent vous être utiles si vous rencontrez des problèmes lors de l'utilisation de la recherche de produits de l'API Vision.
Résultats de recherche
Quel est le nombre maximal de résultats renvoyés ?
Le nombre maximal de résultats renvoyés varie d'une requête à l'autre en raison des détails d'implémentation. Le nombre maximal de résultats garanti est 500. Si d'autres résultats sont demandés, leur nombre risque de ne pas être atteint.
Puis-je définir un seuil pour les résultats ?
Les scores des résultats de recherche ne sont pas calibrés. Cela signifie que les scores des résultats d'une requête donnée seront comparables (c'est ainsi que les résultats sont classés). Toutefois, les résultats des requêtes A et B ne sont pas nécessairement comparables. Autrement dit, aucun seuil fixe n'est adapté à un cas d'utilisation donné.
Il est possible de définir un seuil en fonction de vos propres tests. Si vous souhaitez définir un seuil, vous devez le faire pour chaque étiquette d'élément. Cela veut dire que vous devez définir un seuil de score pour les résultats de "Chaussures" indépendamment de "Sacs", etc. pour chaque étiquette.
Existe-t-il un moyen de savoir pourquoi un résultat donné est mieux classé qu'un autre ?
Actuellement, la recherche de produits de l'API Vision n'est pas compatible avec les fonctionnalités qui expliquent pourquoi un résultat particulier a été renvoyé.
Quelle est la différence entre l'utilisation de productGroupedResults et l'utilisation de la fonctionnalité de localisation des objets de l'API Vision ?
La réponse productGroupedResults renvoie une liste d'éléments détectés, leur étiquette et score prévus, leurs cadres de délimitation et un classement des résultats de recherche de produits pour chaque élément. Cette réponse équivaut à envoyer d'abord l'image de la requête à la fonctionnalité de localisation des objets de l'API Vision, puis à l'envoyer avec chaque cadre de délimitation de produit (filtré sur les étiquettes appropriées) à la recherche de produits de l'API Vision.
L'un des avantages de l'utilisation de productGroupedResults est qu'il est plus rapide et plus direct, car il n'effectue qu'un seul appel d'API. Toutefois, si une logique d'application personnalisée doit être implémentée entre la détection d'objet et la requête de recherche, une méthode en deux étapes est recommandée. Par exemple, vous pouvez ajouter des filtres de recherche de produits avec l'API Vision, basés sur des étiquettes d'objets.
Si je connais l'emplacement d'un produit dans une image, dois-je recadrer l'image avant d'interroger l'API ?
Cette situation peut se produire si, par exemple, un utilisateur est autorisé à dessiner un cadre de délimitation autour de l'élément qu'il souhaite rechercher. En règle générale, vous ne devez pas recadrer l'image avant de l'envoyer à l'API. En effet, notre API utilise à la fois le cadre de délimitation de la requête pour renvoyer des résultats ciblés et le contexte global de l'image, ce qui permet souvent d'améliorer les résultats.
Images de référence
Quelles sont les qualités d'une bonne image de référence pour un produit ?
Une bonne image de référence montre clairement le produit et ne comporte aucun autre objet. Les images "packshot" constituent généralement de bonnes images de référence. Ces images servent à présenter un produit à un utilisateur. On les trouve fréquemment dans les pages produit et les publicités, généralement sur un fond blanc. Des images montrant le produit dans d'autres situations peuvent également constituer de bonnes images de référence, à condition qu'elles ne montrent aucun autre produit. Si vous avez de telles images à votre disposition, n'hésitez pas à toutes les utiliser comme images de référence.
Quelle est la taille idéale pour les images de référence et les images que vous utilisez pour rechercher des produits ?
Une image idéale met l'accent sur le produit qui doit remplir la majorité de l'image. Les images contenant uniquement une représentation petite ou peu claire d'un produit donnent de moins bons résultats. Par conséquent, la taille apparente du produit dans l'image est plus importante que la taille exacte de l'image. Toutefois, nous vous recommandons de manière générale d'utiliser des images d'au moins 600 pixels (pour le plus grand côté) pour les images de référence et de recherche.
Quel est le nombre optimal d'images de référence pour un produit donné ?
La recherche de produits de l'API Vision peut fonctionner correctement même avec une seule image de référence par produit. En règle générale, trois à huit images, surtout si elles présentent des variations, fournissent les informations nécessaires pour obtenir des résultats corrects lors des recherches de produits avec l'API Vision. Les variations peuvent porter sur l'orientation du produit, l'éclairage, l'arrière-plan, etc. Des images de référence supplémentaires peuvent être ajoutées à l'index sans que cela nuise généralement à la justesse.
Comment puis-je obtenir davantage d'images de référence pour mes produits ?
Le meilleur moyen d'améliorer la justesse de la recherche de produits de l'API Vision est de rajouter de bonnes images de référence pour les produits. Si vous avez déjà importé un ensemble représentatif d'images de produits et si vous souhaitez améliorer la justesse pour certains d'entre eux, vous pouvez soit utiliser d'autres images existantes, soit recueillir des images supplémentaires de ces produits.
Si vous utilisez d'autres images existantes, vérifiez qu'elles montrent clairement le produit et ne contiennent pas d'objet gênant. Par exemple, imaginons que vous ayez une photo d'un mannequin portant une chemise et un pantalon. Cette image telle quelle ne constituerait pas une bonne image de référence pour la chemise. Toutefois, si vous spécifiez un cadre de délimitation autour de la chemise ou si vous recadrez l'image pour ne garder que ce vêtement, vous obtenez alors une bonne image de référence. Vous pouvez vous servir de la fonctionnalité de localisation des objets de l'API Vision pour proposer des cadres. Cette méthode peut être utilisée seule ou combinée à une annotation humaine des cadres de délimitation.
Puis-je améliorer la justesse de l'API sur mon ensemble de produits par augmentation des données ?
Ajouter des versions augmentées (par symétrie horizontale, altération du contraste, etc.) des images de référence existantes est une idée judicieuse, mais cela améliore généralement très peu la justesse.
Gestion des données
Quelle est la méthode recommandée pour mettre à jour un ensemble de produits en production ?
Mettez à jour votre ensemble de produits avec de nouveaux produits lorsque votre inventaire évolue. Si les modifications sont mineures, vous pouvez ajouter ou supprimer des produits, si nécessaire. En cas de modification importante de votre inventaire ou de vos images de référence, vous pouvez également créer un ensemble de produits contenant les modifications et tester la qualité de la recherche avant de basculer complètement sur le nouvel ensemble. Dans les deux cas, vous devez effectuer le suivi des produits et des images de votre ensemble de produits en enregistrant votre fichier CSV d'importation par lot pour en faciliter la consultation ou le rollback.