Nesta página, descrevemos as etapas para solucionar problemas que podem ocorrer 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 resultados, o número total 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.
É possível saber por que um determinado resultado teve uma classificação melhor que outro?
No momento, a Pesquisa de produtos da API Vision não aceita recursos que expliquem 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 objetos da API Vision e, em seguida, enviá-la 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 objetos e a
consulta de pesquisa, adote um método de duas etapas. Um exemplo desse caso
seria adicionar filtros da Pesquisa de produtos da API Vision com base em rótulos
de objeto.
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 será pesquisado. Em geral, não corte a imagem antes de enviá-la à API. A API usará a caixa delimitadora da consulta para retornar resultados segmentados e 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 para o produto?
Boas imagens de referência mostram claramente o produto e não exibem outros objetos. Um bom exemplo são as imagens de embalagens de produtos. 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. Fotos tiradas em outros ambientes também produzem boas imagens de referência, desde que não apresentem outros produtos. Use todas as fotos 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 ele preenche a maior parte dela. Imagens que contêm somente uma representação pequena ou pouco clara do produto produzem resultados menos desejáveis. Consequentemente, o tamanho aparente do produto na imagem é mais importante do que o tamanho específico da imagem. 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 Pesquisa de produtos da API Vision funciona bem mesmo com apenas uma imagem de referência. Normalmente, de três a oito imagens fornecem as informações necessárias para gerar resultados adequados com a Pesquisa de produtos da API Vision, especialmente se elas têm 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.
Como ter mais imagens de referência para meus produtos?
A melhor maneira de aprimorar a acurácia da Pesquisa de produtos da API Vision é adicionar mais imagens de referência de qualidade para os produtos. Se você já enviou um conjunto representativo de imagens e ainda quer aumentar a acurácia de alguns produtos, pode usar outras imagens atuais ou coletar mais imagens para eles.
Para usar outras imagens atuais, 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 atuais, como 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 de acordo com as mudanças no inventário. 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 conjunto de produtos com as mudanças e testar a qualidade da pesquisa antes de migrar totalmente para esse 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 a reversão.