Con Vertex AI Search, puedes buscar imágenes usando una app con
datos del sitio web. Proporcionas una consulta en forma de cadena de texto o imagen, y
el método default_config.search
muestra imágenes para esa consulta.
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos. Los requisitos varían según si realizas una búsqueda con una consulta de texto o de imagen.
Si realizas una búsqueda de texto en la aplicación de búsqueda de tu sitio web, asegúrate de que está activada la siguiente información: funciones de la edición Enterprise
Si realizas una búsqueda de imágenes en la aplicación de búsqueda de tu sitio web, asegúrate de que se activan las siguientes acciones:
Vista previa de la búsqueda con imágenes
Para usar la línea de comandos y obtener una vista previa de los resultados de las imágenes de un sitio web, usa el método engines.servingConfigs.search
:
Busca el ID de tu app. Si ya tienes el ID de la app, ve al siguiente paso.
En la consola de Google Cloud, ve a la página Agent Builder.
En la página Apps, busca el nombre de tu app y obtén el ID en la la columna ID.
Llama al método
engines.servingConfigs.search
y especifica1
parasearch_type
. Elige la sintaxis del método dependiendo de si tu consulta está bytes de texto o imagen.La consulta es una cadena 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} }'
La búsqueda es una imagen
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: Es el ID del proyecto
APP_ID: Es el ID de tu app.
QUERY: Es el texto de la búsqueda. Por ejemplo, "autos con faros redondos" o "muéstrame un vestido con rayas".
IMAGE_BYTES: Es la imagen en bytes codificados en Base64. Los formatos compatibles son JPEG, PNG y BMP.
PAGE_SIZE: Opcional El número de resultados devueltos por el búsqueda. El valor predeterminado es 10 para la búsqueda de sitios web.
- Los valores inferiores a 0 generan un error.
- Los valores superiores a 100 hacen que el valor se establezca en 100.
OFFSET: Opcional Es el índice inicial de los resultados. El valor predeterminado es 0.
Por ejemplo, si el desplazamiento es 2 y el tamaño de la página es 10, se obtiene 2. hasta 11.
Revisa la respuesta. Consulta la siguiente tabla para ver las descripciones de los campos:
Campo Descripción title
El título de texto sin formato de la página web que contiene la imagen htmlTitle
El título, en HTML, de la página web que contiene la imagen displayLink
Es una versión resumida de la URL del resultado de esta búsqueda, por lo general, el nombre de dominio, por ejemplo, www.example.com
.link
La URL de la imagen image.contextLink
Vínculo de contexto: Es una URL que dirige a la página web que contiene la imagen. image.byteSize
El tamaño de la imagen en bytes image.width
El ancho de la imagen en píxeles image.height
La altura de la imagen en píxeles image.thumbnailWidth
Es el ancho de la imagen de miniatura, en píxeles. image.thumbnailHeight
Es la altura de la imagen de miniatura, en píxeles. image.thumbnailLink
La URL de la imagen en miniatura mime
El tipo de MIME de la imagen fileFormat
Es el formato de archivo de la imagen.