Visão gerão da tela principal do módulo de configuração do Banco de Imagens.
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.
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.
A tela principal está dividida nas seguintes áreas:
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.
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.
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.
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.
A inclusão rotineira de novas imagens deve ser realizada conforme a sequência apresentada a seguir.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
envio ao armazenamento;
importação para o corpus;
análise do corpus;
atualização do índice.
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.
Clique em Configurações, na parte superior da tela, para acessar as opções administrativas.
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.
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.
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.
As operações da tela Administração do índice são utilizadas principalmente durante a implantação inicial do recurso.
A sequência inicial é:
enviar as imagens;
importar as imagens pendentes;
consultar a importação até sua conclusão;
analisar o corpus;
consultar as operações até a conclusão da análise;
criar o índice;
consultar as operações até a conclusão da criação;
criar o endpoint;
consultar as operações até a conclusão da criação;
fazer o deploy do índice;
consultar as operações até a conclusão do deploy;
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.
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.
Após a implantação inicial, utilize sempre esta sequência:
informar o código do produto;
selecionar as imagens;
clicar em Subir imagens;
clicar em Importar pendentes;
clicar em Consultar importação até que as imagens estejam importadas;
clicar em Analisar corpus;
clicar em Consultar operações até que a análise esteja concluída;
clicar em Atualizar índice;
clicar em Consultar operações até que a atualização esteja concluída;
testar a pesquisa em Consultar imagem.
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:
informe o primeiro produto e envie suas imagens;
repita o procedimento para os demais produtos;
depois de concluir todos os envios, clique uma única vez em Importar pendentes;
aguarde a conclusão de todas as importações;
execute uma única análise do corpus;
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.
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.