Cómo buscar imágenes en sitios web

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.

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:

  1. Busca el ID de tu app. Si ya tienes el ID de la app, ve al siguiente paso.

    1. En la consola de Google Cloud, ve a la página Agent Builder.

      Ir a Apps

    2. En la página Apps, busca el nombre de tu app y obtén el ID en la la columna ID.

  2. Llama al método engines.servingConfigs.search y especifica 1 para search_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.

  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 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.