Módulo de Configuração

O Módulo de Configuração da Busca por Imagens é utilizado para enviar as imagens dos produtos ao Google Cloud, acompanhar o processamento dessas imagens e manter atualizado o índice utilizado nas pesquisas por similaridade visual.
A utilização deste módulo é feita após a preparação do ambiente no Google Cloud.

Por meio desse módulo, é possível:

• vincular imagens ao código de um produto;

• enviar as imagens para o armazenamento do Google Cloud;

• importar as imagens para o Google Vision Warehouse;

• analisar as imagens do corpus;

• atualizar o índice de pesquisa;

• acompanhar as operações executadas;

• testar a busca por imagem;

• acessar as ferramentas administrativas do módulo.

Após a implantação inicial, o processo normal de inclusão de novas imagens não exige a criação de outro índice, de outro endpoint ou a realização de um novo deploy.

Acessando o módulo

No PlusCom, acesse:

Cadastros → Produtos → Busca por Imagens → Módulo de Configuração

A tela principal apresenta as ferramentas utilizadas no processo rotineiro de inclusão e atualização das imagens.

As operações de implantação inicial e manutenção administrativa ficam disponíveis no botão Configurações, localizado na parte superior da tela.

Tela principal

A tela principal está dividida nas seguintes áreas:

Dados do produto

Nesta área, informe o código do produto e selecione as imagens que serão vinculadas a ele.

Cada produto pode possuir até seis imagens.

É recomendável utilizar imagens que representem o produto por diferentes ângulos ou detalhes, sempre que essas informações contribuírem para melhorar a identificação visual.

Imagens selecionadas

Apresenta os arquivos escolhidos antes do envio.

Utilize o botão Selecionar imagens para localizar os arquivos no computador.

O botão Limpar remove da tela o código informado e a lista de imagens selecionadas. Essa ação não exclui imagens que já tenham sido enviadas.

Fila local de imagens

Apresenta as imagens registradas no processo de envio e importação.

Os principais status são:

Pendente

A imagem foi enviada para o armazenamento do Google Cloud, mas ainda não foi importada para o Vision Warehouse.

Importando

A solicitação de importação foi enviada ao Google e ainda está sendo processada.

Importado

A imagem foi importada com sucesso para o corpus.

Erro

Ocorreu algum problema durante o envio ou a importação da imagem.

Operações gerais do Vision Warehouse

Apresenta as operações executadas sobre o corpus e o índice, como:

• análise do corpus;

• criação do índice;

• criação do endpoint;

• deploy do índice;

• atualização do índice;

• desativação do índice.

A grade permite acompanhar o tipo da operação, o status, a descrição, o identificador retornado pelo Google, as datas de início e conclusão e eventuais mensagens de erro.

Inclusão de novas imagens

A inclusão rotineira de novas imagens deve ser realizada conforme a sequência apresentada a seguir.

1. Informar o código do produto

No campo Código do Produto, informe o código do produto ao qual as imagens serão vinculadas.

O código deve corresponder a um produto válido cadastrado no PlusCom.

2. Selecionar as imagens

Clique em Selecionar imagens.

Localize os arquivos no computador e selecione as imagens desejadas.

Podem ser selecionadas até seis imagens para o mesmo produto.

Os formatos aceitos são:

• JPG;

• JPEG;

• PNG;

• WEBP.

Após a seleção, os arquivos serão apresentados na área Imagens selecionadas para o produto.

3. Subir as imagens

Clique em Subir imagens.

Essa operação envia os arquivos para o armazenamento do Google Cloud e registra cada imagem como pendente na fila de processamento.

Neste momento, as imagens ainda não fazem parte do corpus utilizado pela busca.

Após a conclusão, a fila será atualizada e as imagens deverão aparecer com o status Pendente.

É possível repetir esse processo para vários produtos antes de realizar a importação.

Importação das imagens

4. Importar as imagens pendentes

Depois de concluir o envio das imagens, clique em Importar pendentes.

O sistema cria o manifesto necessário e envia ao Google Vision Warehouse uma solicitação para importar todas as imagens que estiverem pendentes.

Durante esse processo, as imagens passam para o status Importando.

A importação é executada de forma assíncrona pelo Google. Por esse motivo, o retorno inicial da operação não significa que todas as imagens já foram importadas.

5. Consultar a importação

Clique em Consultar importação para verificar o andamento das importações.

Repita a consulta até que as imagens passem do status Importando para Importado.

Não execute a análise do corpus enquanto existirem imagens com os status Pendente ou Importando.

Caso alguma imagem apresente o status Erro, consulte a mensagem apresentada na fila antes de continuar.

Análise do corpus

6. Analisar o corpus

Depois que todas as novas imagens estiverem com o status Importado, clique em Analisar corpus.

Essa operação prepara as imagens do corpus para serem utilizadas na busca visual.

Durante a análise, o Google gera os sinais necessários para representar visualmente as imagens e permitir a comparação por similaridade.

A operação será registrada na grade Operações gerais do Vision Warehouse com o status Processando.

7. Consultar as operações

Clique em Consultar operações para acompanhar o andamento da análise.

Repita a consulta até que a operação AnalyzeCorpus apareça com o status Concluída.

O índice não deve ser atualizado antes da conclusão da análise.

Caso a análise termine com erro, verifique a mensagem apresentada na grade antes de prosseguir.

Atualização do índice

8. Atualizar o índice

Depois que a operação AnalyzeCorpus estiver concluída, clique em Atualizar índice.

Essa operação atualiza o índice que já está implantado, incluindo nele todas as imagens importadas e analisadas no corpus.

Durante esse processo:

• não é criado um novo índice;

• não é criado um novo endpoint;

• o índice atual não precisa ser desativado;

• não é necessário realizar outro deploy;

• o mesmo endpoint continua sendo utilizado pela busca por imagem.

Antes de enviar a atualização, o sistema verifica:

• se existe um índice implantado;

• se o índice pertence ao corpus configurado;

• se o índice e o endpoint estão disponíveis;

• se ainda existem imagens pendentes ou em importação;

• se existe uma análise do corpus concluída;

• se a análise foi realizada depois da última importação;

• se a análise já foi aplicada anteriormente ao índice;

• se existe outra operação geral em andamento.

Quando alguma dessas condições não for atendida, o sistema interromperá a operação e apresentará a orientação necessária.

9. Acompanhar a atualização

Depois de enviar a atualização, clique em Consultar operações.

Repita a consulta até que a operação UpdateIndex apareça com o status Concluída.

Enquanto a operação estiver em processamento, não inicie outra análise do corpus ou outra atualização do índice.

Após a conclusão, as novas imagens estarão disponíveis para a busca por similaridade visual.

Consultando uma imagem

Clique em Consultar imagem, na parte superior da tela, para testar a pesquisa.

Selecione uma imagem de referência e execute a consulta.

O sistema utilizará o índice implantado para localizar os produtos visualmente semelhantes.

Para que uma nova imagem possa aparecer nos resultados, ela deve ter concluído todas as seguintes etapas:

1. envio ao armazenamento;

2. importação para o corpus;

3. análise do corpus;

4. atualização do índice.

Atualizando as informações da tela

O botão Atualizar grids recarrega:

• a fila local de imagens;

• a grade de operações gerais;

• a situação atual do índice implantado.

Esse botão apenas atualiza as informações apresentadas na tela. Ele não envia imagens e não inicia nenhuma operação no Google.

Configurações do módulo

Clique em Configurações, na parte superior da tela, para acessar as opções administrativas.

Configurações gerais

Permite consultar e alterar os parâmetros utilizados pelo módulo de Busca por Imagens.

Essas configurações devem ser alteradas somente por usuários responsáveis pela implantação ou manutenção do ambiente.

Administração Google Vision

Permite:

• consultar os assets existentes no corpus;

• verificar informações do ambiente;

• provisionar um novo corpus quando necessário.

A criação de um novo corpus não substitui automaticamente o corpus atualmente configurado na aplicação.

Administração do índice

Reúne as operações administrativas relacionadas à implantação do índice:

• Criar índice;

• Criar endpoint;

• Fazer deploy;

• Desativar índice.

Essa tela também apresenta:

• número do projeto;

• região;

• corpus configurado;

• endpoint configurado;

• estado do endpoint;

• índice implantado;

• estado do índice;

• operações administrativas registradas.

Implantação inicial

As operações da tela Administração do índice são utilizadas principalmente durante a implantação inicial do recurso.

A sequência inicial é:

1. enviar as imagens;

2. importar as imagens pendentes;

3. consultar a importação até sua conclusão;

4. analisar o corpus;

5. consultar as operações até a conclusão da análise;

6. criar o índice;

7. consultar as operações até a conclusão da criação;

8. criar o endpoint;

9. consultar as operações até a conclusão da criação;

10. fazer o deploy do índice;

11. consultar as operações até a conclusão do deploy;

12. testar a busca por imagem.

Depois que essa implantação estiver concluída, as opções Criar índice, Criar endpoint e Fazer deploy não fazem parte da inclusão normal de novas imagens.

Desativar o índice

A opção Desativar índice remove o índice do endpoint utilizado nas consultas.

Ela não exclui:

• o corpus;

• os assets;

• o índice;

• o endpoint.

Entretanto, enquanto não houver um novo deploy, a busca por imagem ficará indisponível.

Essa opção deve ser utilizada somente em situações administrativas ou de manutenção.

Sequência resumida para novas imagens

Após a implantação inicial, utilize sempre esta sequência:

1. informar o código do produto;

2. selecionar as imagens;

3. clicar em Subir imagens;

4. clicar em Importar pendentes;

5. clicar em Consultar importação até que as imagens estejam importadas;

6. clicar em Analisar corpus;

7. clicar em Consultar operações até que a análise esteja concluída;

8. clicar em Atualizar índice;

9. clicar em Consultar operações até que a atualização esteja concluída;

10. testar a pesquisa em Consultar imagem.

Inclusão de imagens em lote

Quando houver imagens de vários produtos para incluir, é possível realizar o envio de todos eles antes de iniciar as etapas de processamento.

Nesse caso:

1. informe o primeiro produto e envie suas imagens;

2. repita o procedimento para os demais produtos;

3. depois de concluir todos os envios, clique uma única vez em Importar pendentes;

4. aguarde a conclusão de todas as importações;

5. execute uma única análise do corpus;

6. após a conclusão da análise, execute uma única atualização do índice.

Esse procedimento evita análises e atualizações repetidas desnecessariamente.

Observações importantes

Não execute Analisar corpus enquanto ainda houver imagens pendentes ou em importação.

Não execute Atualizar índice antes que a análise mais recente do corpus esteja concluída.

Não utilize Criar índice para adicionar novas imagens a um índice que já esteja implantado.

Não realize outro deploy depois de uma atualização normal do índice.

Aguarde sempre a conclusão de uma operação geral antes de iniciar a próxima.

As operações de análise e atualização são processadas pelo Google Cloud e podem levar algum tempo, dependendo da quantidade de imagens existentes no corpus.

As telas, nomes das opções e procedimentos disponibilizados pelo Google Cloud podem ser alterados pelo fornecedor. As orientações deste manual têm como finalidade apresentar o processo utilizado pelo PlusCom e auxiliar o usuário na localização e execução das operações necessárias.