Pesquisar imagens em sites

Com a Vertex AI para Pesquisa, é possível pesquisar imagens usando um app com dados de sites. Você fornece uma consulta na forma de uma string de texto ou uma imagem, e o método default_config.search retorna imagens para essa consulta.

Antes de começar

Verifique se você atende aos seguintes pré-requisitos. Os requisitos variam dependendo de você usar uma consulta de texto ou de imagem.

• Se você pesquisar usando uma consulta de texto no app de pesquisa em sites, verifique se a opção Recursos da edição Enterprise está ativada.

• Se você pesquisar usando uma consulta de imagem no app de pesquisa em sites, verifique se as seguintes opções estão ativadas:

  • Recursos da edição Enterprise

  • Indexação avançada de sites

Prévia da pesquisa de imagens

Para usar a linha de comando e visualizar os resultados de imagens de um site, use o método engines.servingConfigs.search:

1. Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.

   1. No console Google Cloud , acesse a página Aplicativos de IA.

      Acessar "Apps".

   2. Na página Apps, encontre o nome do app e confira o ID dele na coluna ID.

2. Chame o método engines.servingConfigs.search e especifique 1 para o search_type. Escolha a sintaxe do método dependendo se a consulta é texto ou bytes de imagem.

   A consulta é uma string de texto

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_config:search" \
   -d '{
   "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "query": "QUERY",
   "pageSize": "PAGE_SIZE",
   "offset": "OFFSET",
   "params": {"search_type": 1}
   }'
   

   A consulta é uma imagem

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
   -d '{
   "servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
   "imageQuery": {"imageBytes":"IMAGE_BYTES"},
   "pageSize": "PAGE_SIZE",
   "offset": "OFFSET",
   "params": {"search_type": 1}
   }'
   

   Substitua:

   • PROJECT_ID: ID do projeto.

   • APP_ID: o ID do seu app.

   • QUERY: o texto da consulta de pesquisa. Por exemplo, "carros com faróis redondos" ou "mostre vestidos listrados".

   • IMAGE_BYTES: a imagem em bytes codificados em Base64. Os formatos aceitos são JPEG, PNG e BMP.

   • PAGE_SIZE: opcional. O número de resultados retornados pela pesquisa. O valor padrão é 10 para a pesquisa de sites.

     • Valores abaixo de 0 causam um erro.
     • Valores acima de 100 são definidos como 100.

   • OFFSET: opcional. O índice inicial dos resultados. O valor padrão é 0.

     Por exemplo, se o deslocamento for 2 e o tamanho da página for 10, os resultados de 2 a 11 serão retornados.

3. Analise a resposta. Consulte a tabela a seguir para ver as descrições dos campos:

   Campo	Descrição
   title	O título em texto simples da página da Web que contém a imagem.
   htmlTitle	O título, em HTML, da página da Web que contém a imagem
   displayLink	Uma versão abreviada do URL do resultado da pesquisa, geralmente o nome de domínio, por exemplo, www.example.com.
   link	O URL da imagem
   image.contextLink	Link de contexto: um URL que aponta para a página da Web que contém a imagem
   image.byteSize	O tamanho da imagem, em bytes
   image.width	A largura da imagem, em pixels.
   image.height	A altura da imagem, em pixels.
   image.thumbnailWidth	A largura da miniatura, em pixels.
   image.thumbnailHeight	A altura da miniatura, em pixels.
   image.thumbnailLink	O URL da imagem em miniatura
   mime	O tipo MIME da imagem
   fileFormat	O formato do arquivo da imagem