Questa pagina descrive i passaggi per la risoluzione dei problemi, utili in caso di problemi nell'utilizzo di Vision API Product Search.
Risultati di ricerca
Qual è il numero massimo di risultati restituiti?
Il numero massimo di risultati restituiti varia da query a query a causa dei dettagli di implementazione. Il numero massimo di risultati garantiti restituiti è 500. Se ne vengono richiesti di più, il numero richiesto potrebbe non essere soddisfatto.
Posso impostare una soglia di punteggio per i risultati?
I punteggi dei risultati di ricerca non sono calibrati. Ciò significa che i punteggi dei risultati per una determinata query saranno confrontabili (è così che vengono classificati i risultati). Tuttavia, i punteggi dei risultati per la query A e la query B non sono necessariamente paragonabili. Ciò significa che non esiste una sola soglia fissa adatta a un determinato caso d'uso.
È possibile impostare una soglia in base ai tuoi esperimenti. Se vuoi impostare una soglia, devi impostarla in base all'etichetta dell'articolo. Ciò significa che devi impostare una soglia di punteggio dei risultati per "Scarpe" indipendentemente da "Borse" e così via per ogni etichetta.
Esiste un modo per sapere perché un determinato risultato è stato classificato più in alto di un altro?
Al momento, Product Search dell'API Vision non supporta funzionalità che spieghino il motivo per cui è stato restituito un determinato risultato.
Qual è la differenza tra l'utilizzo di productGroupedResults e l'utilizzo della funzionalità Object Localizer dell'API Vision?
La risposta productGroupedResults restituirà un elenco di elementi rilevati,
la loro etichetta e il loro punteggio previsti, i relativi riquadri di delimitazione e un elenco classificato dei risultati di ricerca dei prodotti per ciascun elemento. Questa risposta è equivalente all'invio prima dell'immagine di query alla funzionalità Object Localizer dell'API Vision e poi dell'immagine insieme a ogni riquadro di delimitazione dell'articolo del prodotto (filtrata in base alle etichette pertinenti) a Product Search dell'API Vision.
Un vantaggio dell'utilizzo di productGroupedResults è che è più veloce
e diretto perché esegue una sola chiamata API. Tuttavia, se è presente una logica dell'applicazione personalizzata che deve essere implementata tra il rilevamento degli oggetti e la query di ricerca, un metodo in due passaggi è un buon approccio. Un esempio di questo tipo di caso
è l'aggiunta di filtri di ricerca di prodotti dell'API Vision in base alle etichette degli oggetti.
Se conosco la posizione di un prodotto in un'immagine, devo ritagliare l'immagine prima di eseguire query sull'API?
Questa situazione potrebbe verificarsi se, ad esempio, un utente è autorizzato a disegnare un riquadro di delimitazione intorno all'elemento che vuole cercare. In genere, non devi ritagliare l'immagine prima di inviarla all'API. Il motivo è che la nostra API utilizzerà sia la riquadro di delimitazione della query per restituire risultati mirati sia il contesto generale dell'immagine, che spesso è utile per migliorare i risultati.
Immagini di riferimento
Quali sono le immagini di riferimento prodotto di buona qualità?
Le immagini di riferimento di buona qualità mostrano chiaramente il prodotto e non contengono altri oggetti. Un esempio tipico di buone immagini di riferimento sono le immagini "packshot". Queste immagini vengono spesso utilizzate per mostrare all'utente un prodotto sulla pagina del prodotto o nella pubblicità e in genere vengono scattate su uno sfondo bianco. Anche le immagini del prodotto in altri ambienti sono ottime immagini di riferimento, a condizione che non siano presenti altri prodotti nell'immagine. Dovresti utilizzare tutte le immagini di questo tipo disponibili come immagini di riferimento.
Quali sono le dimensioni ideali per le immagini di riferimento e quelle che utilizzi per cercare i prodotti?
Un'immagine ideale si concentra sul prodotto, che occupa la maggior parte dell'immagine. Le immagini che contengono solo una rappresentazione piccola o poco chiara di un prodotto produrranno risultati meno auspicabili. Di conseguenza, le dimensioni apparenti del prodotto nell'immagine sono più importanti delle dimensioni specifiche dell'immagine. Tuttavia, come consiglio generale, utilizza immagini con almeno 600 pixel sul lato più lungo per le immagini di riferimento e di ricerca.
Qual è il numero ottimale di immagini di riferimento per un determinato prodotto?
Product Search dell'API Vision può funzionare bene anche con una sola immagine di riferimento di un prodotto. In genere, da 3 a 8 immagini forniscono le informazioni necessarie per ottenere risultati adeguati da Product Search dell'API Vision, soprattutto se queste immagini presentano alcune variazioni. Queste variazioni includono diversi orientamenti del prodotto, illuminazione diversa o uno sfondo diverso. È possibile aggiungere altre immagini di riferimento all'indice e in genere questo non dovrebbe diminuire l'accuratezza.
Come faccio a ottenere altre immagini di riferimento per i miei prodotti?
Il modo migliore per migliorare l'accuratezza di Product Search dell'API Vision è aggiungere altre buone immagini di riferimento per i prodotti. Se hai già caricato un insieme rappresentativo di immagini prodotto e vuoi comunque aumentare la precisione per alcuni prodotti, puoi utilizzare altre immagini esistenti o raccogliere altre immagini per questi prodotti.
Per utilizzare altre immagini esistenti, assicurati che mostrino chiaramente il prodotto e che non contengano altri oggetti che possono distrarre l'attenzione. Ad esempio, potresti avere foto di un modello che indossa una camicia e dei pantaloni specifici. Questa immagine da sola non sarebbe una buona immagine di riferimento per la camicia. Tuttavia, se fornisci un riquadro di delimitazione intorno alla camicia o ritaglie l'immagine in modo da includere solo la camicia, questa sarebbe un'immagine di riferimento valida. Puoi utilizzare la funzionalità Object Localization (Localizzatore di oggetti) dell'API Vision per proporre delle caselle. Questo metodo può essere utilizzato insieme o al posto delle annotazioni con riquadro di delimitazione fornite dall'uomo.
L'accuratezza dell'API migliorerebbe se aggiungessi l'aumento dei dati al mio set di prodotti?
L'idea di aggiungere versioni aumentate di immagini di riferimento esistenti (ad esempio, rotazioni da sinistra a destra, contrasto con jitter e così via) è sensata, ma in genere non fa molto per aumentare la precisione.
Gestione dati
Qual è il modo consigliato per aggiornare un set di prodotti in produzione?
Aggiorna l'insieme di prodotti con nuovi prodotti man mano che l'inventario cambia. Se le modifiche sono minime, puoi aggiungere o eliminare i prodotti in base alle esigenze. In alternativa, se si verifica una modifica significativa nell'inventario o nelle immagini di riferimento, puoi creare un nuovo set di prodotti con le modifiche e testare la qualità della ricerca prima di passare completamente al nuovo set. In entrambi i casi, devi tenere traccia dei prodotti e delle immagini nel tuo set di prodotti salvando il file CSV di importazione collettiva per riferimento o rollback facili.