Configurer les résultats pour l'UI

Cette page explique comment configurer les résultats pour l'UI de l'application Web, qui est l'interface que vos utilisateurs utilisent pour accéder à votre application.

Concepts du widget Recherche

Voici quelques concepts pour vous aider à comprendre comment utiliser les commandes de l'onglet UI.

  • Extrait Une courte section de texte, généralement une phrase, sous le titre du document. Par défaut, un extrait s'affiche pour chaque résultat de recherche pour un site Web et des données non structurées.

  • Recherche avec une réponse Cette fonctionnalité fournit un paragraphe d'informations (la réponse) synthétisé à partir des meilleurs résultats du site Web ou des données non structurées. Vous pouvez personnaliser le nombre de meilleurs résultats sur lesquels la réponse est basée. Par défaut, les cinq premiers résultats sont résumés pour créer la réponse. La recherche avec une réponse ne peut pas être combinée avec la recherche avec questions complémentaires.

  • Recherche avec questions complémentaires Cette fonctionnalité pour les sites Web et les données non structurées permet de poser des questions complémentaires qui conservent le contexte de la requête de recherche initiale.

  • Saisie semi-automatique Suggère des requêtes de recherche en fonction des premières lettres que les utilisateurs saisissent dans la barre de recherche. Pour en savoir plus, consultez Configurer la saisie semi-automatique.

  • Commentaires. affiche des boutons thumb_up et thumb_down pour que les utilisateurs puissent évaluer la qualité des résultats de recherche. Ces informations ne sont envoyées qu'à Google. Pour en savoir plus, consultez Configurer les commentaires.

  • Métadonnées Si les données sont structurées ou contiennent des métadonnées, vous pouvez choisir les champs de métadonnées à inclure dans les résultats de recherche. Vous pouvez également mapper des champs avec des noms à afficher pour les attributs. Pour en savoir plus, consultez Configurer des facettes pour l'UI.

  • Nom à afficher configuré par l'administrateur pour les sources. Affiche le nom à afficher configuré par l'administrateur pour les sources de données dans l'application Web au lieu du type de connecteur. Pour en savoir plus, consultez Afficher les noms à afficher configurés par l'administrateur pour les sources de données.

Configurer les résultats de recherche pour des données non structurées ou de sites Web

L'interface utilisateur pour les données non structurées et les données de site Web propose les personnalisations de recherche suivantes :

  • Recherche (un seul tour)
  • Recherche avec une réponse (recherche en un seul tour avec résumé)
  • Recherche avec questions complémentaires (recherche multitour)

Pour configurer l'affichage des résultats de recherche pour les données non structurées dans l'UI :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur le nom de l'application que vous souhaitez modifier.

  3. Dans le menu de navigation, cliquez sur Configurations.

  4. Cliquez sur l'onglet UI.

  5. Modifiez les champs de l'onglet.

  6. Utilisez le volet Aperçu pour vous assurer que vos modifications s'affichent comme prévu.

  7. Cliquez sur Enregistrer et publier pour appliquer les modifications.

Configurer les résultats de recherche pour les données structurées

Pour les données structurées, l'interface utilisateur affiche par défaut toutes les paires nom-valeur de chaque élément dans les résultats de recherche. Vous pouvez utiliser la page Configurations de la console Google Cloud pour personnaliser l'affichage des résultats de recherche dans l'interface utilisateur.

La liste suivante présente les principaux champs permettant d'afficher les résultats de recherche :

  • Titre. Titre d'un élément sur lequel un utilisateur peut cliquer pour sélectionner cet élément dans un résultat de recherche.
  • Miniature URL d'une image à afficher à côté du titre de l'élément dans un résultat de recherche.
  • URL. URL vers laquelle l'utilisateur est redirigé lorsqu'il clique sur le titre de l'élément.

Vous pouvez afficher jusqu'à trois champs supplémentaires dans vos résultats de recherche et configurer leur apparence.

Vous pouvez également sélectionner des attributs pour filtrer les résultats de recherche et leur attribuer des noms à afficher. Pour en savoir plus sur la configuration des facettes, consultez Configurer des facettes pour l'UI.

Pour configurer l'affichage des résultats de recherche pour les données structurées dans l'UI :

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Gemini Enterprise

  2. Cliquez sur le nom de l'application de recherche que vous souhaitez modifier.

  3. Cliquez sur Configurations.

  4. Cliquez sur l'onglet UI.

  5. Si plusieurs datastores sont connectés à votre application, sélectionnez celui pour lequel vous souhaitez configurer les résultats.

  6. Développez la section Configurer les champs dans les résultats.

  7. Dans le volet Aperçu, saisissez une requête et appuyez sur Entrée pour voir comment les résultats de recherche s'affichent avec vos paramètres actuels. L'aperçu se met à jour automatiquement lorsque vous saisissez de nouveaux paramètres.

  8. Facultatif : Cliquez sur l'icône d'un appareil pour afficher l'aperçu au format ordinateur ou mobile.

  9. Pour configurer les champs principaux (Titre, Miniature et URL) dans vos résultats de recherche :

    1. Cliquez sur le champ Titre et sélectionnez un champ à mapper aux titres de vos résultats de recherche. Vous pouvez également sélectionner Aucun si vous ne souhaitez pas que les titres apparaissent dans les résultats de recherche.

    2. Cliquez sur la zone Miniature et sélectionnez un champ à mapper aux images miniatures dans vos résultats de recherche. Vous pouvez également sélectionner Aucun si vous ne souhaitez pas que des vignettes s'affichent dans les résultats de recherche.

    3. Cliquez sur le champ URL et sélectionnez un champ qui correspond aux éléments qui s'ouvrent lorsque les utilisateurs cliquent sur les titres des éléments dans les résultats de recherche. Vous pouvez également sélectionner Aucun si vous ne souhaitez pas que les titres des éléments dans vos résultats de recherche renvoient vers les éléments.

  10. Pour ajouter des champs supplémentaires à vos résultats de recherche :

    1. Cliquez sur la zone Texte 1 et sélectionnez un champ que vous souhaitez afficher dans les résultats de recherche. Par défaut, seule la valeur du champ s'affiche dans les résultats de recherche.

    2. Cliquez sur la flèche à côté de la zone Texte 1 pour afficher la zone Modèle. Le champ {value} de la zone Modèle représente la valeur du champ à afficher dans le résultat de recherche. Ajoutez du texte avant ou après le champ {value} (ou les deux) pour donner du contexte à la valeur dans les résultats de recherche. Par exemple, supposons que vous ayez sélectionné price dans le champ Texte 1 et que la valeur du prix d'un article particulier soit de 42. Si vous remplacez le champ Modèle par "Total Price: {value} USD", "Prix total : 42 USD" s'affiche dans les résultats de recherche pour cet article.

    3. Pour ajouter des champs supplémentaires, répétez ces étapes pour les zones Texte 2 et Texte 3.

  11. Pour configurer les paramètres des attributs :

    1. Développez la section Paramètres des facettes.

    2. Sélectionnez un champ à définir comme attribut, puis saisissez un nom à afficher.

    3. Pour ajouter d'autres facettes, cliquez sur Ajouter une facette.

  12. Consultez le volet Aperçu pour vous assurer que vos modifications s'affichent correctement.

  13. Cliquez sur Enregistrer et publier pour appliquer les modifications.

Afficher les noms à afficher configurés par l'administrateur pour les sources de données

Par défaut, l'application Web affiche le type de connecteur comme libellé pour les sources de données à instance unique. Vous pouvez activer le paramètre Utiliser le nom à afficher configuré par l'administrateur pour les sources afin que l'application Web affiche le nom à afficher personnalisé que vous avez configuré pour chaque source de données.

Pour activer ou désactiver les noms à afficher configurés par l'administrateur pour les sources de données :

Console

  1. Dans la console Google Cloud , accédez à la page Gemini Enterprise.

    Accéder à Gemini Enterprise

  2. Cliquez sur le nom de l'application que vous souhaitez modifier.

  3. Dans le menu de navigation, cliquez sur Configurations.

  4. Cliquez sur l'onglet UI de recherche.

  5. Dans la section Configurations générales, activez ou désactivez l'option Utiliser le nom à afficher configuré par l'administrateur pour les sources.

  6. Cliquez sur Enregistrer et publier pour appliquer les modifications.

REST

Mettez à jour le champ uiSettings.sourceAdminDisplayNameEnabled sur la ressource WidgetConfig de l'application en appelant la méthode engines.widgetConfigs.patch :

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
  -d '{
    "uiSettings": {
      "sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
    }
  }'

Remplacez les éléments suivants :

  • ENDPOINT_LOCATION : emplacement multirégional de votre requête API. Spécifiez l'une des valeurs suivantes :
    • us pour l'emplacement multirégional US
    • eu pour l'emplacement multirégional EU
    • global pour l'emplacement mondial
    Pour en savoir plus, consultez Spécifier un emplacement multirégional pour votre datastore.
  • PROJECT_ID : numéro ou ID de votre projet Google Cloud .
  • LOCATION_ID : emplacement géographique de votre data store, par exemple global. Pour plus d'informations, consultez la section Emplacements.
  • APP_ID : ID de l'application.
  • SOURCE_ADMIN_DISPLAY_NAME_ENABLED : valeur booléenne. Spécifiez true pour afficher le nom à afficher configuré par l'administrateur pour les sources de données, ou false pour afficher le type de connecteur.

Étapes suivantes