Cómo buscar imágenes en sitios web

Con Vertex AI Search, puedes buscar imágenes con una app que tenga datos de sitios 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 tu app, ve al siguiente paso.

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

      Ve a Apps.

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

  2. Llama al método engines.servingConfigs.search y especifica 1 para search_type. Elige la sintaxis del método según si tu consulta es de bytes de texto o de 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 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}
}'

    • 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 Es la cantidad de resultados que muestra la 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 muestran los resultados del 2 al 11.

  3. Revisa la respuesta. Consulta la siguiente tabla para obtener 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 Es 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 Es el tamaño de la imagen, en bytes.
    image.width Es el ancho de la imagen, en píxeles.
    image.height Es 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.