Cette page explique comment configurer les résultats pour l'interface utilisateur de l'application Web, qui est l'interface que vos utilisateurs utilisent pour accéder à votre application.
Concepts liés au widget Recherche
Voici quelques concepts qui vous aideront à comprendre comment utiliser les commandes de l'onglet UI.
Extrait : 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 les données de site Web et les 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 issus des données 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 meilleurs 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 données de site Web et les données non structurées permet de poser des questions complémentaires en conservant 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 J'aime et Je n'aime pas 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 à des noms à afficher pour les facettes. Pour en savoir plus, consultez Configurer les 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 les données non structurées ou de site Web
L'interface utilisateur pour les données non structurées et de site Web propose les personnalisations de recherche suivantes :
- Recherche (un seul tour)
- Recherche avec une réponse (recherche en un seul tour avec synthèse)
- Recherche avec questions complémentaires (recherche en plusieurs tours)
Pour configurer l'affichage des résultats de recherche pour les données non structurées dans l'interface utilisateur :
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Cliquez sur le nom de l'application que vous souhaitez modifier.
Dans le menu de navigation, cliquez sur Configurations.
Cliquez sur l'onglet UI.
Modifiez les champs de l'onglet.
Utilisez le volet Aperçu pour vous assurer que vos modifications s'affichent comme prévu.
Cliquez sur Enregistrer et publier pour appliquer vos 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 pour chaque élément des résultats de recherche. Vous pouvez utiliser la page Configurations de la Google Cloud console 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 le sélectionner 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.
De plus, vous pouvez sélectionner des facettes sur lesquelles filtrer les résultats de recherche et définir des noms à afficher pour celles-ci. Pour en savoir plus sur la configuration des facettes, consultez Configurer les facettes pour l'UI.
Pour configurer l'affichage des résultats de recherche pour les données structurées dans l'interface utilisateur :
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Cliquez sur le nom de l'application de recherche que vous souhaitez modifier.
Cliquez sur Configurations.
Cliquez sur l'onglet UI.
Si plusieurs datastores sont connectés à votre application, sélectionnez celui pour lequel vous souhaitez configurer les résultats.
Développez la section Configurer les champs dans les résultats.
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 est mis à jour automatiquement lorsque vous saisissez de nouveaux paramètres.
Facultatif : Cliquez sur une icône d'appareil pour afficher l'aperçu au format ordinateur ou mobile.
Pour configurer les champs principaux (Titre, Miniature et URL) dans vos résultats de recherche :
Cliquez sur la zone 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 s'affichent dans les résultats de recherche.
Cliquez sur la zone Miniature et sélectionnez un champ à mapper aux miniatures de vos résultats de recherche. Vous pouvez également sélectionner Aucun si vous ne souhaitez pas que les miniatures s'affichent dans les résultats de recherche.
Cliquez sur la zone 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 de vos résultats de recherche soient associés à des éléments.
Pour ajouter des champs à vos résultats de recherche :
Cliquez sur la zone Texte 1 et sélectionnez un champ que vous souhaitez afficher dans vos résultats de recherche. Par défaut, seule la valeur du champ s'affiche dans les résultats de recherche.
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é
pricedans la zone Texte 1 et que la valeur du prix d'un article particulier soit de 42. Si vous mettez à jour le Modèle champ en"Total Price: {value} USD", alors "Total Price: 42 USD" s'affiche dans les résultats de recherche pour cet article.Pour ajouter des champs, répétez ces étapes pour les zones Texte 2 et Texte 3.
Pour configurer les paramètres des facettes :
Développez la section Paramètres des facettes.
Sélectionnez un champ à définir comme facette et saisissez un nom à afficher.
Pour ajouter des facettes, cliquez sur Ajouter une facette.
Vérifiez le volet Aperçu pour vous assurer que vos modifications s'affichent correctement.
Cliquez sur Enregistrer et publier pour appliquer vos 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
Dans la Google Cloud console, accédez à la Gemini Enterprise page.
Cliquez sur le nom de l'application que vous souhaitez modifier.
Dans le menu de navigation, cliquez sur Configurations.
Cliquez sur l'onglet UI de recherche.
Dans la section Configurations générales, activez ou désactivez le bouton Utiliser le nom à afficher configuré par l'administrateur pour les sources.
Cliquez sur Enregistrer et publier pour appliquer vos modifications.
REST
Mettez à jour le champ uiSettings.sourceAdminDisplayNameEnabled de 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 :uspour l'emplacement multirégional USeupour l'emplacement multirégional EUglobalpour l'emplacement mondial
PROJECT_ID: numéro ou ID de votre Google Cloud projet.LOCATION_ID: emplacement géographique de votre data store, par exempleglobal. Pour plus d'informations, consultez la section Emplacements.APP_ID: ID de l'application.SOURCE_ADMIN_DISPLAY_NAME_ENABLED: valeur booléenne. Spécifieztruepour afficher le nom à afficher configuré par l'administrateur pour les sources de données, oufalsepour afficher le type de connecteur.