Buscar imágenes en sitios web

Con Vertex AI Search, puedes buscar imágenes usando una aplicación con datos de sitios web. Proporcionas una consulta en forma de cadena de texto o imagen, y el método default_config.search devuelve imágenes para esa consulta.

Nota: La búsqueda de imágenes no está disponible en la consola Google Cloud .

Antes de empezar

Asegúrate de que cumples los siguientes requisitos previos. Los requisitos varían en función de si buscas con una consulta de texto o de imagen.

• Si buscas con una consulta de texto en la aplicación de búsqueda de tu sitio web, asegúrate de que estén activadas las funciones de la edición Enterprise.

• Si buscas con una consulta de imagen en la aplicación de búsqueda de tu sitio web, asegúrate de que estén activadas las siguientes opciones:

  • Funciones de la edición Enterprise

  • Indexación avanzada de sitios web

Vista previa de la búsqueda de imágenes

Para usar la línea de comandos y obtener una vista previa de los resultados de imagen de un sitio web, usa el método engines.servingConfigs.search:

Nota: Puedes buscar en una aplicación con el método engines.servingConfigs.search y en un almacén de datos con el método dataStores.servingConfigs.search. Para el siguiente procedimiento, Google recomienda buscar con el método engines.servingConfigs.search.

1. Busca el ID de tu aplicación. Si ya tienes el ID de tu aplicación, ve al siguiente paso.

   1. En la Google Cloud consola, ve a la página Aplicaciones de IA.

      Ir a Aplicaciones

   2. En la página Aplicaciones, busca el nombre de tu aplicación y consulta su ID en la columna ID.

2. Llama al método engines.servingConfigs.search y especifica 1 en search_type. Elige la sintaxis del método en función de si tu consulta es texto o bytes de imagen.

   Término clave: en Vertex AI Search, el término aplicación se puede usar indistintamente con el término buscador en el contexto de las APIs.

   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 consulta 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}
   }'
   

   Haz los cambios siguientes:

   • PROJECT_ID: el ID de tu proyecto.

   • APP_ID: el ID de tu aplicación.

   • QUERY: el texto de la consulta de búsqueda. Por ejemplo, "coches con faros redondos" o "muéstrame un vestido de rayas".

   • IMAGE_BYTES: la imagen en bytes codificados en Base64. Los formatos admitidos son JPEG, PNG y BMP.

   • PAGE_SIZE: opcional. Número de resultados devueltos por la búsqueda. El valor predeterminado es 10 para la búsqueda en sitios web.

     • Los valores inferiores a 0 provocan un error.
     • Si el valor es superior a 100, se asignará el valor 100.

   • OFFSET: opcional. Índice de inicio 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 devuelven los resultados del 2 al 11.

3. 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	Una versión abreviada de la URL del resultado de esta búsqueda, normalmente el nombre de dominio. Por ejemplo, www.example.com
   link	URL de la imagen
   image.contextLink	Enlace de contexto: una URL que apunta a la página web que contiene la imagen.
   image.byteSize	Tamaño de la imagen, en bytes
   image.width	Anchura de la imagen en píxeles.
   image.height	Altura de la imagen en píxeles.
   image.thumbnailWidth	Anchura de la imagen en miniatura, en píxeles.
   image.thumbnailHeight	Altura de la imagen en miniatura, en píxeles.
   image.thumbnailLink	URL de la imagen en miniatura
   mime	El tipo MIME de la imagen
   fileFormat	El formato de archivo de la imagen