Obtenir des résultats de navigation personnalisés

La navigation utilise des méthodes de navigation pour afficher les résultats de recherche correspondant aux catégories ou filtres sélectionnés par l'utilisateur final. La navigation renvoie des résultats qui peuvent être personnalisés. Cette page explique comment obtenir des résultats de navigation pour les magasins de données de recherche génériques.

À propos de la navigation

Dans une application de recherche AI Applications, parcourir signifie effectuer une recherche sans requête ou avec une requête vide. Si vous disposez d'un data store de recherche générique contenant des données structurées, des données non structurées avec des métadonnées ou des données de site Web, vous pouvez envoyer une requête de recherche vide pour recevoir des résultats de navigation.

Lorsque vous envoyez une requête de navigation, les documents de votre data store qui correspondent aux filtres sont renvoyés en fonction des signaux basés sur les événements. Vous pouvez offrir une expérience de navigation améliorée en procédant comme suit :

  • Utilisez des filtres dans votre requête de recherche pour affiner les résultats. Si vous utilisez l'indexation avancée de sites Web, consultez Utiliser des données structurées pour l'indexation avancée de sites Web pour savoir comment ajouter des métadonnées à votre schéma et les utiliser pour enrichir vos champs de filtre et de boost.
  • Ajoutez une spécification d'amplification pour influencer l'ordre des résultats renvoyés en amplifiant ou en enterrant des résultats spécifiques.
  • Comprendre les événements utilisateur et les enregistrer Google utilise vos événements utilisateur pour optimiser le classement des résultats en fonction du taux de clics.

Le tableau suivant présente les différences entre la recherche et la navigation.

Fonctionnalité Rechercher Parcourir
Objectif Trouver des informations spécifiques Explorer et découvrir des contenus
Exemple Recherche des "meilleurs restaurants coréens à Vancouver" dans la recherche Google Parcourir les catégories dans lesquelles un restaurant peut figurer, par exemple "Restaurants > Coréens > Vancouver > 4 étoiles et plus"
User Intent Généralement axées sur des objectifs Exploratoire
Point de départ Requête ou mot clé, généralement dans une barre de recherche Un site Web ou une plate-forme spécifique, généralement à l'aide d'un menu, d'un fil d'Ariane, de liens ou d'autres méthodes de navigation comme les facettes
Méthode Saisie de mots clés ou d'expressions et application de la configuration de la recherche et de la diffusion Rechercher avec une requête vide, appliquer une configuration de recherche et de diffusion
Résultats Une liste de résultats pertinents Tous les documents du data store qui correspondent aux filtres

Obtenir des résultats de navigation pour une application avec des données de site Web

Pour utiliser l'API afin d'obtenir des résultats de navigation pour une application avec des données de site Web,

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

    1. Dans la console Google Cloud , accédez à la page AI Applications.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.

  2. Appelez la méthode engines.servingConfigs.search avec une requête vide ou sans requête comme suit :

    REST

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/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",
"orderBy": "ORDER_BY",
"params": {
     "searchType": "0"
 },
"filter": "FILTER",
"boostSpec": "BOOST_SPEC",
}'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .
    • APP_ID : ID de l'application Vertex AI Search que vous souhaitez interroger.
    • ORDER_BY : Facultatif. Ordre dans lequel les résultats sont organisés. L'attribut sur lequel effectuer le tri doit avoir une interprétation numérique, par exemple date. Pour en savoir plus, consultez Trier les résultats de recherche sur le Web.
    • FILTER : facultatif, mais recommandé. Champ de texte permettant de filtrer votre recherche à l'aide d'une expression de filtre. La valeur par défaut de cet attribut est une chaîne vide. Pour en savoir plus sur l'utilisation du champ filter, consultez Filtrer la recherche générique pour les données structurées ou non structurées et Filtrer la recherche sur le site Web.
    • BOOST_SPEC : Facultatif. Spécification permettant de mettre en avant ou d'enterrer des documents. Valeurs :
      • BOOST : nombre à virgule flottante compris dans la plage [-1,1]. Lorsque la valeur est négative, les résultats sont rétrogradés (ils apparaissent plus bas dans les résultats). Lorsque la valeur est positive, les résultats sont mis en avant (ils apparaissent plus haut dans les résultats).
      • CONDITION : expression de filtre de texte permettant de sélectionner les documents auxquels le boost est appliqué. Le filtre doit renvoyer une valeur booléenne. Pour en savoir plus sur l'optimisation de la recherche structurée, consultez Optimiser les résultats de recherche.

    Vous devriez recevoir une réponse JSON semblable à la réponse tronquée suivante. La réponse contient des résultats de recherche détaillés, listés dans l'ordre déterminé par les champs définis dans la demande de recherche.