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.
Si vous effectuez une recherche à l'aide d'une requête textuelle dans votre application de recherche de sites Web, assurez-vous que les fonctionnalités de l'édition Enterprise sont activées.
Si vous effectuez une recherche à l'aide d'une requête d'image dans votre application de recherche de site Web, assurez-vous que les éléments suivants sont activés :
Prévisualiser la recherche dans des images
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
:
Recherchez votre ID d'application. Si vous connaissez déjà l'ID de votre application, passez à l'étape suivante.
Dans la console Google Cloud, accédez à la page Agent Builder.
Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.
Appelez la méthode
engines.servingConfigs.search
, spécifiant1
poursearch_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.
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