Cette page explique comment trier les résultats d'une requête de recherche effectuée sur des datastores de données structurées et sur des datastores de données non structurées avec des métadonnées.
Types de données compatibles pour le tri des résultats
Vous pouvez trier les résultats de recherche en fonction des types de champs suivants :
stringnumberdatetimegeolocation
Avant de commencer
Assurez-vous de disposer d'une application avec un data store contenant des données structurées ou des données non structurées avec des métadonnées.
Trier vos résultats de recherche
Pour trier les résultats de recherche d'un data store structurées ou d'un data store non structurées avec des métadonnées, procédez comme suit :
REST
Pour utiliser l'API afin de trier les résultats de recherche d'une application contenant des données structurées ou des données non structurées avec des métadonnées, utilisez la méthode engines.servingConfigs.search :
Trouvez l'ID de votre application. Si vous disposez déjà de l'ID de votre application, passez à l'étape suivante.
Dans la console Google Cloud , accédez à la page Gemini Enterprise.
Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.
Effectuez une requête de recherche et incluez le champ
orderBy.curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://discoveryengine.googleapis.com/v1alpha/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", "query": "QUERY", "orderBy": "ORDER_BY" }'Remplacez les éléments suivants :
PROJECT_ID: ID de votre projet.APP_ID: ID de l'application.QUERY: texte de la requête à rechercher.ORDER_BY: ordre dans lequel les résultats sont organisés. L'ordre de tri par défaut est croissant. Par exemple, spécifierdaterenvoie les résultats du plus ancien au plus récent. Pour obtenir un ordre de tri décroissant, ajoutezdescà la valeurdate(par exemple,date desc). Pour en savoir plus, consultez Exemples deorderBy.
orderBy exemples
Pour trier sur un champ de chaîne appelé title :
"orderBy": "title"pour renvoyer les documents par ordre alphabétique croissant en fonction du titre."orderBy": "title desc"pour renvoyer les documents triés par ordre alphabétique inverse (de Z à A) en fonction du titre.
Pour trier sur un champ numérique appelé rating :
"orderBy": "rating"pour trier les documents du moins bien noté au mieux noté."orderBy": "rating desc"pour trier les documents du mieux au moins bien noté.
Pour trier sur un champ datetime appelé available_date :
"orderBy": "available_date"pour trier les documents du plus récent au plus ancien."orderBy": "available_date desc"pour trier les documents de la date de disponibilité la plus éloignée à la date de disponibilité la plus proche.
Pour trier selon la géolocalisation sur un champ appelé location :
"orderBy": "GEO_DISTANCE(location, \"Mountain View, CA\")"trie les documents du plus proche au plus éloigné de Mountain View."orderBy": "GEO_DISTANCE(location, 37.38, -122.08) desc"trie les documents du plus éloigné au plus proche de l'emplacement 37,38°N et 122,08°O.