Conseils généraux

Cette page décrit les étapes de dépannage qui pourraient vous être utiles si vous rencontrez des problèmes avec la fonctionnalité de 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 de mise en œuvre. 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. Cela signifie qu'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 signifie 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 pertinentes) à 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 mise en œuvre 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 libellés 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 rogner 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 et le produit remplit la majorité de l'image. Les images contenant uniquement une représentation petite ou peu claire d'un produit produisent des résultats moins souhaitables. Par conséquent, la taille évidente du produit dans l'image est plus importante que la taille de l'image spécifique. 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 ne fasse généralement baisser la précision.

Comment puis-je obtenir davantage d'images de référence pour mes produits ?

Le meilleur moyen d'améliorer la précision de la recherche de produits de l'API Vision consiste à rajouter de bonnes images de référence aux produits. Si vous avez déjà importé un ensemble représentatif d'images de produits et si vous souhaitez améliorer la précision 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 le produit 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 la chemise, vous obtenez alors une bonne image de référence. Vous pouvez utiliser 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 précision 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 n'augmente généralement presque pas la précision.

Gestion des données

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 nouvel 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.