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.

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.

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:

  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.

    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