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.

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