Pesquisar imagens em sites

Com a Vertex AI para Pesquisa, é possível pesquisar imagens usando um app com dados do site. 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ê cumpre os pré-requisitos a seguir. Os requisitos variam de acordo com o tipo de pesquisa que você faz: de texto ou de imagem.

Para usar a linha de comando para visualizar os resultados de imagem 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 do Google Cloud, acesse a página Criador de agentes.

      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 especificando 1 para o search_type. Escolha a sintaxe do método dependendo se a consulta é bytes de texto ou 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}
    }'
    
    • PROJECT_ID: o ID do seu projeto.

    • APP_ID: o ID do app.

    • QUERY: o texto da consulta de pesquisa. Por exemplo, "Farol redondo carros" ou "mostre-me um vestido listrado".

    • IMAGE_BYTES: a imagem em bytes codificados em Base64. Os formatos compatíveis 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 em site.

      • Valores abaixo de 0 causam um erro.
      • Valores acima de 100 fazem com que o valor seja definido 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, o resultado 2 até 11 são retornadas.

  3. Analise a resposta. Consulte as descrições de campos na tabela a seguir:

    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 resumida 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 imagem em miniatura, em pixels.
    image.thumbnailLink O URL da imagem em miniatura
    mime O tipo MIME da imagem
    fileFormat O formato do arquivo da imagem