Questa pagina descrive i passaggi per la risoluzione dei problemi che potrebbero esserti utili in caso di problemi con l'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 garantito di risultati restituiti è 500. Se ne vengono richiesti altri, il numero richiesto potrebbe non essere raggiunto.
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 comparabili (in questo modo vengono classificati i risultati). Tuttavia, i punteggi dei risultati per la query A e la query B non sono necessariamente comparabili. Ciò significa che non esiste una soglia fissa adatta a un determinato caso d'uso.
È possibile impostare una soglia in base ai tuoi esperimenti. Se vuoi impostare una soglia, devi farlo in base all'etichetta per articolo. Ciò significa che devi impostare una soglia del 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, Vision API Product Search non supporta funzionalità che spieghino perché è stato restituito un determinato risultato.
Qual è la differenza tra l'utilizzo di productGroupedResults e l'utilizzo
della funzionalità di localizzazione degli oggetti dell'API Vision?
La risposta productGroupedResults restituirà un elenco di elementi rilevati,
la relativa etichetta e il relativo punteggio previsti, i riquadri di delimitazione e un elenco classificato di risultati di ricerca dei prodotti per ogni elemento. Questa risposta equivale a inviare prima l'immagine della query alla funzionalità di localizzazione degli oggetti dell'API Vision e poi inviare l'immagine insieme a ogni riquadro di delimitazione dell'articolo di prodotto (filtrato in base alle etichette pertinenti) a Product Search dell'API Vision.
Uno dei vantaggi dell'utilizzo di productGroupedResults è che è più veloce
e più 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 caso
sarebbe 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 ritagliarla prima di eseguire una query sull'API?
Questa situazione potrebbe verificarsi se, ad esempio, a un utente è consentito disegnare un riquadro di delimitazione attorno all'elemento che vuole cercare. In generale, non devi ritagliare l'immagine prima di inviarla all'API. Il motivo è che la nostra API utilizzerà sia il 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 dei prodotti di buona qualità?
Le buone immagini di riferimento 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 nella pagina del prodotto o nella pubblicità e vengono in genere scattate davanti a uno sfondo bianco. Anche le immagini del prodotto in altri ambienti sono buone immagini di riferimento, a condizione che non siano presenti altri prodotti nell'immagine. Devi utilizzare tutte le immagini disponibili per le immagini di riferimento.
Qual è la dimensione ideale delle immagini di riferimento e delle immagini 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 desiderabili. Di conseguenza, la dimensione apparente del prodotto nell'immagine è più importante della dimensione specifica dell'immagine. Tuttavia, come raccomandazione generale, utilizza immagini con 600 pixel o più sul lato più grande 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, 3-8 immagini forniscono le informazioni necessarie per ottenere risultati corretti da Product Search dell'API Vision, soprattutto se queste immagini presentano alcune variazioni. Queste variazioni includono orientamenti diversi del prodotto, illuminazione diversa o uno sfondo diverso. È possibile aggiungere altre immagini di riferimento all'indice, che in genere non dovrebbero ridurre l'accuratezza.
Come posso ottenere più immagini di riferimento per i miei prodotti?
Il modo migliore per migliorare l'accuratezza di Vision API Product Search è aggiungere altre immagini di riferimento valide per i prodotti. Se hai già caricato un insieme rappresentativo di immagini di prodotto e vuoi comunque aumentare l'accuratezza 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 includano altri oggetti che distraggono. Ad esempio, potresti avere foto di una modella che indossa una determinata maglietta con dei pantaloni. Questa immagine da sola non sarebbe una buona immagine di riferimento per il prodotto maglietta. Tuttavia, se fornisci un riquadro di delimitazione intorno alla maglietta o ritagli l'immagine in modo da includere solo la maglietta, otterrai un'immagine di riferimento valida. Puoi utilizzare la funzionalità Localizzatore di oggetti dell'API Vision per proporre riquadri. Questo metodo può essere utilizzato insieme o al posto delle annotazioni riquadro di delimitazionex fornite da persone.
L'aggiunta di arricchimenti dei dati al mio insieme di prodotti migliorerebbe l'accuratezza dell'API?
L'idea di aggiungere versioni aumentate delle immagini di riferimento esistenti (ad esempio, inversione sinistra-destra, contrasto con jitter e così via) è sensata, ma in genere non contribuisce molto ad aumentare l'accuratezza.
Gestione dati
Qual è il modo consigliato per aggiornare un insieme di prodotti in produzione?
Aggiorna il set di prodotti con i nuovi prodotti man mano che l'inventario cambia. Se le modifiche sono minime, puoi aggiungere o eliminare i prodotti in base alle tue esigenze. In alternativa, se si verifica una variazione significativa dell'inventario o delle 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 presenti nel set di prodotti salvando il file CSV di importazione batch per un facile riferimento o rollback.