Nesta página, você verá etapas de solução de problemas que podem ser úteis se tiver problemas ao usar a Pesquisa de produtos da API Vision.
Resultados da pesquisa
Qual é o número máximo de resultados retornados?
O número máximo de resultados retornados varia de acordo com a consulta devido aos detalhes de implementação. O valor máximo garantido dos resultados retornados é 500. Se forem solicitados mais, o número solicitado poderá não ser atendido.
É possível definir um limite de pontuação para os resultados?
As pontuações dos resultados da pesquisa não são calibradas. Isso significa que as pontuações dos resultados para uma determinada consulta serão comparáveis (é assim que os resultados são classificados). No entanto, as pontuações dos resultados da consulta A e da consulta B não são necessariamente comparáveis. Isso significa que não há um limite fixo adequado para um determinado caso de uso.
É possível definir um limite com base nas suas próprias experiências. Se você quiser definir um limite, defina-o com base no rótulo de cada item. Isso significa que você precisa definir um limite de pontuação de resultados para "Sapatos" separadamente de "Bolsas" etc. para cada rótulo.
Há uma maneira de saber por que um determinado resultado foi classificado melhor do que outro?
Atualmente, a Pesquisa de produtos da API Vision não oferece suporte a recursos que explicam o motivo pelo qual um determinado resultado foi retornado.
Qual é a diferença entre usar productGroupedResults e
o recurso Localizador de objetos da API Vision?
A resposta productGroupedResults retornará uma lista de itens detectados,
os respectivos rótulos e pontuações previstos, as caixas delimitadoras e uma lista de classificação dos resultados
da pesquisa de produtos para cada item. Essa resposta equivale a enviar primeiro a imagem da consulta ao
recurso Localizador de objeto da API Vision e, em seguida, enviar a imagem com cada
caixa delimitadora do item de produto (filtrada com os rótulos relevantes) à Pesquisa de produtos da API Vision.
Uma vantagem de usar productGroupedResults é que ele é mais rápido
e direto porque faz apenas uma chamada de API. No entanto, se houver alguma
lógica de aplicativo personalizada que precise ser implementada entre a detecção de objeto e
a consulta de pesquisa, um método de duas etapas será uma boa abordagem. Um exemplo desse caso
seria adicionar filtros da Pesquisa de produtos da API Vision com base em rótulos
de objetos.
Se eu souber o local de um produto em uma imagem, preciso cortá-la antes de consultar a API com ela?
Essa situação pode ocorrer se, por exemplo, um usuário tiver permissão para desenhar uma caixa delimitadora em torno do item que quiser pesquisar. Em geral, não corte a imagem antes de enviá-la para a API. O motivo é que nossa API usará a caixa delimitadora da consulta para retornar resultados segmentados, bem como o contexto geral da imagem, que costuma ser útil para melhorar os resultados.
Imagens de referência
O que são boas imagens de referência do produto?
Boas imagens de referência mostram claramente o produto e não exibem outros objetos. Um bom exemplo são as imagens tipo packshot (em inglês). Elas são usadas para mostrar ao usuário um produto na página dele ou em anúncios e geralmente contam com um fundo branco. Imagens do produto em outros ambientes também produzem boas imagens de referência, desde que não apresentem outros produtos. Use todas as imagens disponíveis como imagens de referência.
Qual é o tamanho ideal para imagens de referência e imagens que você usa para pesquisar produtos?
uma imagem ideal se concentra no produto e preenche a maior parte dela. Imagens que contenham somente uma representação pequena ou pouco clara de um produto produzirão resultados menos desejáveis. Consequentemente, o tamanho aparente do produto na imagem é mais importante do que o tamanho específico. No entanto, como uma recomendação geral, use imagens com 600 pixels ou mais no lado maior para imagens de referência e de pesquisa.
Qual é o número ideal de imagens de referência para um produto específico?
A API Vision da Pesquisa de Produtos funciona bem mesmo com apenas uma imagem de referência. Normalmente, de três a oito imagens fornecem informações necessárias para gerar os resultados adequados na Pesquisa de produtos da API Vision, especialmente se elas tiverem algumas variações. Essas variações incluem diferentes orientações do produto, iluminação ou plano de fundo. Outras imagens de referência podem ser adicionadas ao índice e não costumam diminuir a acurácia das informações do produto.
Como ter mais imagens de referência para meus produtos?
A melhor maneira de aprimorar a acurácia da Pesquisa de produtos API Vision é adicionar mais boas imagens de referência para os produtos. Se você já tiver enviado um conjunto representativo de imagens de produtos e ainda quiser aumentar a acurácia de alguns produtos, poderá usar outras imagens existentes ou coletar mais imagens para eles.
Se quiser usar outras imagens, elas precisam mostrar claramente o produto e não podem ter outros objetos que desviem a atenção. Por exemplo, é possível ter fotos de uma modelo usando uma determinada camisa combinando com uma calça. Essa imagem sozinha não seria uma boa imagem de referência para a camisa. No entanto, se você inserir uma caixa delimitadora ao redor da camisa ou cortar a imagem para incluir somente ela, será uma boa imagem de referência. Use o recurso Localizador de objetos da API Vision para inserir caixas. Esse método pode ser usado como complemento ou substituição das anotações de caixa delimitadora inseridas por humanos.
Adicionar aprimoramentos de dados ao meu conjunto de produtos afeta a acurácia da API?
A ideia de adicionar versões aprimoradas das imagens de referência existentes (por exemplo, inversão esquerda-direita, contraste tremido etc.) é interessante, mas normalmente afeta pouco a acurácia.
Gerenciamento de dados
Qual é a maneira recomendada de atualizar um conjunto de produtos em produção?
Atualize o conjunto com novos produtos à medida que o inventário mudar. Se as mudanças forem pequenas, adicione ou exclua produtos conforme necessário. Outra opção, se houver uma mudança significativa no inventário ou nas imagens de referência, é criar um novo conjunto de produtos com as mudanças e testar a qualidade da pesquisa antes de migrar totalmente para o novo conjunto. Em qualquer um dos casos, acompanhe quais produtos e imagens fazem parte do conjunto salvando o arquivo CSV de importação em lote para facilitar a referência ou reversão.