Sugestões gerais

Resultados da pesquisa

Qual é o número máximo de resultados devolvidos?

O número máximo de resultados devolvidos varia de consulta para consulta devido aos detalhes de implementação. A quantidade máxima garantida de resultados devolvidos é 500. Se forem pedidas mais, o número pedido pode não ser alcançado.

Posso definir um limite mínimo para os resultados?

As classificações dos resultados da pesquisa não estão calibradas. Isto significa que as pontuações dos resultados para uma determinada consulta sã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. Isto significa que não existe um limite fixo adequado para um determinado exemplo de utilização.

É possível definir um limite com base nas suas próprias experiências. Se quiser definir um limite, deve fazê-lo com base numa etiqueta por artigo. Isto significa que deve definir um limite de pontuação de resultados para "Sapatos" independentemente de "Bolsas", etc., para cada etiqueta.

Existe alguma forma de saber por que motivo um determinado resultado foi classificado acima de outro?

Atualmente, a API Vision Product Search não suporta funcionalidades que expliquem por que motivo foi devolvido um resultado específico.

Qual é a diferença entre usar productGroupedResults e usar a funcionalidade Object Localizer da API Vision?

A resposta productGroupedResults devolve uma lista de itens detetados, a respetiva etiqueta e pontuação previstas, as caixas delimitadoras e uma lista classificada de resultados da pesquisa de produtos para cada item. Esta resposta é equivalente a enviar primeiro a imagem da consulta para a funcionalidade Object Localizer da API Vision e, em seguida, enviar a imagem juntamente com a caixa delimitadora de cada item do produto (filtrada para as etiquetas relevantes) para a API Vision Product Search.

Uma vantagem de usar productGroupedResults é que é mais rápido e mais direto porque só faz uma única chamada API. No entanto, se existir alguma lógica de aplicação personalizada que precise de ser implementada entre a deteção de objetos e a consulta de pesquisa, um método de dois passos é uma boa abordagem. Um exemplo de tal caso seria adicionar filtros de pesquisa de produtos da API Vision com base em etiquetas de objetos.

Se souber a localização de um produto numa imagem, devo recortar a imagem antes de consultar a API com ela?

Esta situação pode ocorrer se, por exemplo, um utilizador tiver autorização para desenhar uma caixa delimitadora à volta do item que quer pesquisar. Em geral, não deve recortar a imagem antes de a enviar para a API. O motivo é que a nossa API usa a caixa delimitadora da consulta para devolver resultados segmentados, bem como o contexto geral da imagem, o que é frequentemente útil para melhorar os resultados.

Imagens de referência

O que são boas imagens de referência de produtos?

As boas imagens de referência mostram o produto de forma clara e não têm outros objetos na imagem. Um exemplo típico de boas imagens de referência são as imagens de "packshot". Estas imagens são usadas frequentemente para mostrar ao utilizador um produto na página do produto ou em publicidade e são normalmente tiradas em frente de um fundo branco. As imagens do produto noutros ambientes também são boas imagens de referência, desde que não existam outros produtos na imagem. Deve usar todas as imagens deste tipo que estejam disponíveis para imagens de referência.

Qual é o tamanho ideal das imagens de referência e das imagens que usa para pesquisar produtos?

Uma imagem ideal foca-se no produto, e o produto preenche a maioria da imagem. As imagens que contêm apenas uma representação pequena ou pouco clara de um 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 recomendação geral, use imagens com 600 píxeis ou mais no lado mais longo para imagens de referência e de pesquisa.

Qual é o número ideal de imagens de referência para um determinado produto?

A API Vision Product Search pode funcionar bem mesmo com apenas uma imagem de referência de um produto. Normalmente, 3 a 8 imagens fornecem as informações necessárias para obter resultados adequados da API Vision Product Search, especialmente se estas imagens tiverem algumas variações. Essas variações incluem diferentes orientações do produto, iluminação diferente ou um fundo diferente. Podem ser adicionadas imagens de referência adicionais ao índice, e geralmente não devem diminuir a precisão.

Como posso obter mais imagens de referência para os meus produtos?

A melhor forma de melhorar a precisão da API Vision Product Search é adicionar mais imagens de referência de boa qualidade para os produtos. Se já tiver carregado um conjunto representativo de imagens dos produtos e ainda quiser aumentar a precisão de alguns produtos, pode usar outras imagens existentes ou recolher mais imagens para esses produtos.

Para usar outras imagens existentes, certifique-se de que mostram claramente o produto e não têm outros objetos que distraiam. Por exemplo, pode ter fotos de um modelo a usar uma determinada camisa com calças. Esta imagem sozinha não seria uma boa imagem de referência para o produto camisa. No entanto, se fornecer uma caixa delimitadora à volta da camisa ou recortar a imagem para incluir apenas a camisa, seria uma boa imagem de referência. Pode usar a funcionalidade Localizador de objetos da API Vision para propor caixas. Este método pode ser usado juntamente com ou em vez de anotações de caixas delimitadoras fornecidas por humanos.

A adição de aumentos de dados ao meu conjunto de produtos ajudaria a melhorar a precisão da API?

A ideia de adicionar versões aumentadas de imagens de referência existentes (por exemplo, inversões da esquerda para a direita, contraste instável, etc.) é sensata, mas normalmente faz pouco para aumentar a precisão.

Gestão de dados

Qual é a forma recomendada de atualizar um conjunto de produtos em produção?

Atualize o conjunto de produtos com novos produtos à medida que o seu inventário muda. Se as alterações forem pequenas, pode adicionar ou eliminar produtos conforme necessário. Em alternativa, se houver uma alteração significativa no seu inventário ou nas imagens de referência, pode criar um novo conjunto de produtos com as alterações e testar a qualidade da pesquisa antes de mudar totalmente para o novo conjunto. Em qualquer dos casos, deve acompanhar os produtos e a imagem que estão no conjunto de produtos guardando o ficheiro CSV de importação em lote para referência ou reversão fácil.