Pesquise imagens em Websites

Com a Pesquisa do Vertex AI, pode pesquisar imagens através de uma app com dados de Websites. Fornece uma consulta sob a forma de uma string de texto ou uma imagem, e o método default_config.search devolve imagens para essa consulta.

Antes de começar

Certifique-se de que cumpre os seguintes pré-requisitos. Os requisitos variam consoante pesquise através de uma consulta de texto ou de uma consulta de imagem.

Para usar a linha de comandos para pré-visualizar os resultados de imagens de um Website, use o método engines.servingConfigs.search:

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

    1. Na Google Cloud consola, aceda à página Aplicações de IA.

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

  2. Chame o método engines.servingConfigs.search especificando 1 para search_type. Escolha a sintaxe do método consoante a sua consulta seja 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 o seguinte:

    • PROJECT_ID: o ID do seu projeto.

    • APP_ID: o ID da sua app.

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

    • IMAGE_BYTES: a imagem em bytes com codificação Base64. Os formatos suportados são JPEG, PNG e BMP.

    • PAGE_SIZE: opcional. O número de resultados devolvidos pela pesquisa. O valor predefinido é 10 para a pesquisa de Websites.

      • Os valores inferiores a 0 causam um erro.
      • Os valores superiores a 100 fazem com que o valor seja definido como 100.

    • OFFSET: opcional. O índice inicial dos resultados. O valor predefinido é 0.

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

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

    Campo Descrição
    title O título de texto simples da página Web que contém a imagem
    htmlTitle O título, em HTML, da página Web que contém a imagem
    displayLink Uma versão abreviada do URL do resultado desta pesquisa, normalmente 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 Web que contém a imagem
    image.byteSize O tamanho da imagem, em bytes
    image.width A largura da imagem, em píxeis
    image.height A altura da imagem, em píxeis
    image.thumbnailWidth A largura da imagem da miniatura, em píxeis
    image.thumbnailHeight A altura da imagem da miniatura, em píxeis
    image.thumbnailLink O URL da imagem em miniatura
    mime O tipo MIME da imagem
    fileFormat O formato de ficheiro da imagem