Rechercher des images sur des sites Web

Avec Vertex AI Search, vous pouvez rechercher des images à l'aide d'une application avec des 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 prévisualiser les résultats d'image d'un site Web à l'aide de la ligne de commande, utilisez la méthode engines.servingConfigs.search:

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

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

      Accédez à "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, en spécifiant 1 pour search_type. Choisissez la syntaxe de la méthode en fonction de la nature de votre requête (texte ou octets 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 en octets encodés en base64. Les formats acceptés sont 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 le site Web.

      • Les valeurs inférieures à 0 génèrent 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. Pour en savoir plus sur les champs, consultez le tableau suivant:

    Champ Description
    title Titre en texte brut de la page Web contenant l'image
    htmlTitle Titre, au format HTML, de la page Web contenant 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 de contexte: URL pointant vers la page Web contenant 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 Type MIME de l'image
    fileFormat Format de fichier de l'image