In questa pagina vengono descritti i passaggi per la risoluzione dei problemi, utili in caso di problemi nell'utilizzo di Product Search dell'API Vision.
Risultati di ricerca
Qual è il numero massimo di risultati restituiti?
Il numero massimo di risultati restituiti varia da una query all'altra 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 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 (in questo modo viene eseguito il ranking dei 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 per un determinato caso d'uso.
È possibile impostare una soglia in base ai tuoi esperimenti. Se vuoi impostare una soglia, devi impostarla per ogni etichetta dell'articolo. Ciò significa che devi impostare una soglia di punteggio dei risultati per "Scarpe" indipendentemente dalle "Borse" e così via per ogni etichetta.
Esiste un modo per sapere perché un determinato risultato è stato classificato più in alto di un altro?
Attualmente Product Search dell'API Vision non supporta alcuna funzionalità che spieghi perché è stato restituito un determinato risultato.
Qual è la differenza tra l'uso di productGroupedResults e l'utilizzo della funzionalità Localizzatore di oggetti dell'API Vision?
La risposta productGroupedResults restituirà un elenco di articoli rilevati, l'etichetta e il punteggio previsti, i relativi riquadri di delimitazione e un elenco classificato dei risultati di ricerca dei prodotti per ciascun articolo. Questa risposta equivale a inviare prima l'immagine della query alla funzionalità Localizzatore di oggetti dell'API Vision, quindi l'immagine insieme a ogni riquadro di delimitazione degli elementi del prodotto (filtrato in base alle etichette pertinenti) a Product Search dell'API Vision.
Un vantaggio dell'uso di productGroupedResults è che è più veloce e diretto perché effettua una sola chiamata API. Tuttavia, se è necessario implementare una logica di applicazione personalizzata tra il rilevamento degli oggetti e la query di ricerca, un metodo in due passaggi è un buon approccio. Un esempio di questo caso potrebbe essere l'aggiunta di filtri Product Search dell'API Vision basati sulle etichette degli oggetti.
Se conosco la posizione di un prodotto in un'immagine, devo ritagliarla prima di inviare una query all'API?
Questa situazione può verificarsi se, ad esempio, un utente può tracciare un riquadro di delimitazione intorno all'elemento in cui desidera eseguire la ricerca. In generale, non ritagliare l'immagine prima di inviarla all'API. Il motivo è che la nostra API utilizzerà sia il riquadro di delimitazione delle query per restituire risultati mirati sia il contesto complessivo dell'immagine, il che è spesso utile per migliorare i risultati.
Immagini di riferimento
Quali sono le immagini di riferimento del prodotto efficaci?
Immagini di riferimento efficaci mostrano il prodotto in modo chiaro e non devono essere presenti altri oggetti. Un tipico esempio di immagini di riferimento valide sono le immagini "packshot". Queste immagini vengono spesso utilizzate per mostrare all'utente un prodotto nella pagina del prodotto o nella pubblicità e in genere sono scattate davanti a uno sfondo bianco. Anche le immagini del prodotto in altri ambienti sono buone immagini di riferimento, a condizione che non ci siano altri prodotti nell'immagine. Devi utilizzare tutte le immagini disponibili come 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 e quest'ultimo riempie la maggior parte dell'immagine; le immagini contenenti 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 consiglio generale, utilizza immagini con almeno 600 pixel 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 da 3 a 8 immagini forniscono le informazioni necessarie per ottenere i risultati appropriati dalla ricerca dei prodotti dell'API Vision, soprattutto se queste immagini presentano alcune variazioni. Queste varianti possono includere diversi orientamenti del prodotto, diverse luci o uno sfondo differente. Ulteriori immagini di riferimento possono essere aggiunte all'indice e 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 Product Search dell'API Vision è aggiungere altre immagini di riferimento valide per i prodotti. Se hai già caricato un insieme rappresentativo di immagini prodotto e vuoi comunque aumentare la precisione di alcuni prodotti, puoi utilizzare altre immagini esistenti o raccogliere più immagini per questi prodotti.
Per utilizzare altre immagini esistenti, assicurati che mostrino chiaramente il prodotto e che non contengano altri oggetti di disturbo. Ad esempio, potresti avere foto di una modella che indossa una determinata camicia insieme a dei pantaloni. Questa immagine da sola non sarebbe una buona immagine di riferimento per la camicia. Tuttavia, si tratta di un'immagine di riferimento valida se fornisci un riquadro di delimitazione intorno alla maglietta o ritagli l'immagine in modo da includere solo la camicia. Puoi utilizzare la funzionalità Localizzatore oggetti dell'API Vision per proporre caselle. Questo metodo può essere utilizzato insieme o al posto delle annotazioni del riquadro di delimitazione fornite dall'utente.
Aiuterebbe l'accuratezza dell'API ad aggiungere aumenti dei dati al mio set di prodotti?
L'idea di aggiungere versioni aumentate di immagini di riferimento esistenti (ad esempio, capovolgimenti da sinistra a destra, contrasto tremolante e così via) è sensata, ma in genere fa poco per aumentare la precisione.
Gestione dei dati
Qual è il modo consigliato per aggiornare un set di prodotti in produzione?
Aggiorna il set 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 tue esigenze. In alternativa, se si verifica un cambiamento significativo nel tuo 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 presenti nel tuo set di prodotti salvando il file CSV di importazione batch per semplificare la consultazione o il rollback.