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.
Se você pesquisar usando uma consulta de texto no app de pesquisa em sites, verifique se os seguintes recursos estão ativados: Recursos da edição Enterprise.
Se você pesquisar usando uma consulta de imagem no app de pesquisa do site, verifique se as seguintes opções estão ativadas:
Visualizar a pesquisa de imagens
Para usar a linha de comando para visualizar os resultados de imagem de um site,
use o método engines.servingConfigs.search
:
Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.
No Console do Google Cloud, acesse a página Criador de agentes.
Na página Apps, encontre o nome do app e confira o ID dele na coluna ID.
Chame o método
engines.servingConfigs.search
especificando1
para osearch_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.
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