Pesquisar imagens em sites

Com a Pesquisa do agente, é 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 se você pesquisa usando uma consulta de texto ou de imagem.

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

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

    1. No Google Cloud console, 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 engines.servingConfigs.search método, especificando 1 para o search_type. Escolha a sintaxe do método dependendo se a consulta é de 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: ID do app.

    • QUERY: o texto da consulta de pesquisa. Por exemplo, "Carros com faróis redondos" ou "Mostre-me um vestido listrado".

    • 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 pesquisa em sites.

      • 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, 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 de 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 imagem em 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