Rechercher des images sur des sites Web

Avec Vertex AI Search, vous pouvez rechercher des images à l'aide d'une application avec données de site Web. Vous fournissez une requête sous la forme d'une chaîne de texte ou d'une image, et La méthode default_config.search renvoie des images pour cette requête.

Avant de commencer

Assurez-vous de remplir les conditions préalables suivantes. Les exigences varient selon que vous effectuez une recherche à l'aide d'une requête textuelle ou d'une requête image.

Pour utiliser la ligne de commande afin de prévisualiser les résultats d'images pour un site Web, utilisez la méthode engines.servingConfigs.search:

  1. Recherchez votre ID d'application. Si vous connaissez déjà l'ID de votre application, passez à l'étape suivante.

    1. Dans la console Google Cloud, accédez à la page Agent Builder.

      Accéder à "Applications"

    2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.

  2. Appelez la méthode engines.servingConfigs.search , spécifiant 1 pour search_type. Choisir la syntaxe de la méthode selon que votre requête des octets de texte ou d'image.

    La requête est une chaîne de texte

    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 requête est une image

    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 : ID de votre projet.

    • APP_ID : ID de votre application.

    • QUERY: texte de la requête de recherche. Par exemple, "Voitures avec des phares ronds" ou "Montre-moi une robe à rayures".

    • IMAGE_BYTES: image exprimée en octets encodés en base64. Compatible sont les suivants : JPEG, PNG et BMP.

    • PAGE_SIZE : facultatif. Nombre de résultats renvoyés par la recherche. La valeur par défaut est 10 pour la recherche sur un site Web.

      • Les valeurs inférieures à 0 entraînent une erreur.
      • Les valeurs supérieures à 100 sont définies sur 100.
    • OFFSET : facultatif. Index de début des résultats. La valeur par défaut est 0.

      Par exemple, si le décalage est de 2 et que la taille de la page est de 10, les résultats 2 à 11 sont renvoyés.

  3. Vérifiez la réponse. Consultez le tableau suivant pour obtenir la description des champs:

    Champ Description
    title Titre en texte brut de la page Web contenant l'image
    htmlTitle Titre, en HTML, de la page Web qui contient l'image
    displayLink Version abrégée de l'URL des résultats de cette recherche, généralement le nom de domaine, par exemple www.example.com
    link URL de l'image
    image.contextLink Lien contextuel: URL pointant vers la page Web qui contient l'image
    image.byteSize Taille de l'image, en octets
    image.width Largeur de l'image, en pixels
    image.height Hauteur de l'image, en pixels
    image.thumbnailWidth Largeur de l'image miniature, en pixels
    image.thumbnailHeight Hauteur de l'image miniature, en pixels
    image.thumbnailLink URL de l'image miniature
    mime Le type MIME de l'image
    fileFormat Format de fichier de l'image