Cette page explique comment prévisualiser les résultats de recherche à l'aide de la console Google Cloud et obtenir des résultats de recherche à l'aide de l'API.
De plus, au lieu de créer un widget de recherche à ajouter à votre page Web, vous pouvez effectuer des appels d'API et les intégrer à votre serveur ou à votre application. Cette page inclut des exemples de code pour effectuer des requêtes de recherche à l'aide des bibliothèques clientes gRPC avec un compte de service.
Le résumé de recherche varie selon le modèle
Si vous générez des récapitulatifs de recherche pour vos requêtes, vous remarquerez peut-être que les récapitulatifs diffèrent entre les résultats de la console et ceux de l'API. Si vous s'affiche, il est probable que la console utilise un autre modèle LLM depuis l'API. Les exemples curl et de code de cette page utilisent le modèle LLM stable.
Pour modifier ou afficher le modèle LLM utilisé sur la page Aperçu de l'interface utilisateur, accédez à Page Configurations > Onglet UI de votre application.
Pour les appels de méthode, et pour utiliser un modèle LLM autre que le modèle stable, consultez Spécifiez le modèle de synthèse.
Obtenir des résultats de recherche pour une application avec des données de site Web
Console
Pour prévisualiser les résultats de recherche d'une application avec des données de site Web à l'aide de la console Google Cloud, procédez comme suit :
Dans la console Google Cloud, accédez à la page Agent Builder.
Cliquez sur le nom de l'application que vous souhaitez modifier.
Cliquez sur Aperçu.
Ouvrez la page Aperçu dans la console.
Facultatif: Si vous avez connecté plusieurs data stores à votre application mais que vous souhaitez provenant uniquement d'un data store spécifique, sélectionnez celui-ci pour obtenir d'où proviennent les résultats.
Saisissez une requête de recherche.
- Si vous avez activé la saisie semi-automatique, une liste de suggestions de saisie semi-automatique s'affiche sous la barre de recherche à mesure que vous saisissez du texte.
Cliquez sur Entrée pour envoyer la requête.
- Une liste de résultats de recherche s'affiche sous la barre de recherche.
- Chaque résultat contient un titre, un extrait et une URL.
- Cliquez sur un résultat pour ouvrir l'URL correspondante.
Cliquez sur la flèche située sous la liste des résultats pour charger la page suivante.
REST
Pour utiliser l'API afin d'obtenir des résultats de recherche pour une application avec des données de 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 récupérez son ID dans la colonne ID.
Obtenir les résultats de recherche
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", "query": "QUERY", "pageSize": "PAGE_SIZE", "offset": "OFFSET", "orderBy": "ORDER_BY", "params": {"user_country_code": "USER_COUNTRY_CODE", "searchType": "SEARCH_TYPE"}, "filter": "FILTER", "boostSpec": "BOOST_SPEC", "contentSearchSpec": { "searchResultMode": "RESULT_MODE" }, "dataStoreSpec": {"DATA_STORE_SPEC"} }'
- PROJECT_ID : ID de votre projet Google Cloud
- APP_ID : ID de l'application Vertex AI Search que vous souhaitez interroger.
- QUERY: texte de la requête à rechercher.
PAGE_SIZE: nombre de résultats renvoyés par la recherche. La taille de page maximale autorisée dépend du type de données. Les tailles de page supérieures à la valeur maximale sont réduites à la valeur maximale.
- Sites Web avec indexation de base :
10
par défaut,25
maximum - Sites Web avec indexation avancée:
25
par défaut,50
maximum - Autre:
50
par défaut,100
maximum
- Sites Web avec indexation de base :
OFFSET : l'index de début des résultats. La valeur par défaut est de 0.
Par exemple, si le décalage est de 2, la taille de la page est de 10 et que 15 résultats doivent être renvoyés, les résultats 2 à 12 sont renvoyés sur la première page.
ORDER_BY : ordre dans lequel les résultats sont organisés. L'attribut à trier doit avoir une interprétation numérique (par exemple, prix ou date).
USER_COUNTRY_CODE : emplacement de l'utilisateur. Cette paire clé-valeur paire est la seule entrée acceptée pour le champ de mappage
params
. La valeur par défaut est vide. Pour connaître les valeurs acceptées, consultez la section Codes pays dans la documentation de référence de l'API JSON Programmable Search Engine.SEARCH_TYPE: type de recherche à effectuer. La la valeur par défaut est 0 pour la recherche de documents. L'autre valeur acceptée est 1. pour la recherche d'images.
FILTER: champ de texte permettant de filtrer votre recherche à l'aide d'une l'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 sur le site Web.BOOST_SPEC : Facultatif. Spécification permettant de mettre en avant ou d'ignorer des documents. Valeurs :
BOOST
: nombre à virgule flottante compris entre -1 et 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
: Une expression de filtre de texte pour sélectionner les documents auxquels l'optimisation est appliquée. Le filtre doit évaluer en une valeur booléenne. Pour en savoir plus sur Boost pour la recherche structurée, consultez Optimiser les résultats de recherche.
RESULT_MODE: détermine si les résultats de recherche sont renvoyés en tant que documents complets ou en morceaux. Pour obtenir des segments, le magasin de données doit avoir activé le fractionnement de documents. Les valeurs acceptées sont
documents
etchunks
. Lorsque le fractionnement est activé pour un entrepôt de données, la valeur par défaut estchunks
. Sinon, la valeur par défaut estdocuments
. Pour plus d'informations sur la fragmentation de documents, consultez la section Analyser et fragmenter documents. Ce champ est en version Preview publique. Pour l'utiliser, remplacezv1
parv1alpha
dans la commande curl.DATA_STORE_SPEC: filtre un data store spécifique pour et effectuer une recherche. Utiliser
dataStoreSpec
si votre application de recherche est associée à plusieurs magasins de données, mais vous souhaitez obtenir les résultats d'un data store spécifique.
C#
Pour en savoir plus, consultez les API C# de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez les API Java de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour en savoir plus, consultez la documentation de référence de l'API Node.js Vertex AI Agent Builder.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour en savoir plus, consultez la documentation de référence de l'API PHP Vertex AI Agent Builder.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Python Vertex AI Agent Builder.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez les API Ruby de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Obtenir des résultats de recherche pour une application avec des données structurées ou non structurées
Vous pouvez prévisualiser les résultats de recherche depuis la console Google Cloud ou obtenir des résultats de recherche à l'aide de l'API.
Console
Pour prévisualiser les résultats de recherche d'une application avec des données structurées ou non structurées à l'aide de la console Google Cloud, procédez comme suit :
- Ouvrez la page Aperçu dans la console.
- Saisissez une requête de recherche.
- Si vous avez activé la saisie semi-automatique à l'étape 1, des suggestions de saisie semi-automatique sous la barre de recherche à mesure que vous saisissez du texte.
- (Facultatif) Si vous avez associé plusieurs data stores à votre application, mais que vous ne souhaitez obtenir des résultats que d'un data store spécifique, sélectionnez-le.
- Appuyez sur Entrée pour envoyer la requête.
- Une liste de résultats de recherche s'affiche sous la barre de recherche.
- Si aucun mappage d'attributs n'est défini sur la page Configurations, chaque résultat de recherche s'affiche sous la forme d'une liste de noms et de valeurs d'attributs bruts.
- Si des mappages d'attributs ont été enregistrés dans Configurations les résultats de recherche affichent les mêmes images que dans la Aperçu de la page Configurations.
- Si des attributs ont été spécifiés sur la page Configurations, ils sont affichées de la même manière.
- Cliquez sur la flèche située sous la liste des résultats pour charger la page suivante.
REST
Pour utiliser l'API afin d'obtenir les résultats de recherche d'une application avec des données structurées ou non structurées, 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 récupérez son ID dans la colonne ID.
Obtenir les résultats de recherche
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 '{ "query": "QUERY", "userPseudoId": "USER_PSEUDO_ID", "pageSize": "PAGE_SIZE", "offset": "OFFSET", "orderBy": "ORDER_BY", "filter": "FILTER", "boostSpec": "BOOST_SPEC", "facetSpec": "FACET_SPEC", "queryExpansionSpec": "QUERY_EXPANSION_SPEC", "spellCorrectionSpec": "SPELL_CORRECTION_SPEC", "contentSearchSpec": "CONTENT_SEARCH_SPEC", "dataStoreSpec": {"DATA_STORE_SPEC"}, }'
- PROJECT_ID : ID de votre projet Google Cloud
- APP_ID : ID de l'application Vertex AI Search que vous souhaitez interroger.
- QUERY : texte de la requête à rechercher.
- USER_PSEUDO_ID : Facultatif. Il s'agit d'un identifiant pseudonymisé pour suivre un visiteur de la recherche. Google vous recommande vivement d'utiliser ce champ, qui améliore les performances du modèle et la qualité de la personnalisation. Vous pouvez utiliser un cookie HTTP pour ce champ, identifie un visiteur sur un seul appareil. Cet identifiant ne change pas lorsque le visiteur se connecte ou se déconnecte d'un site Web. Ne définissez pas ce champ sur le même identifiant pour plusieurs utilisateurs. Dans ce cas, les événements et de dégrader la qualité du modèle. N'incluez pas personnellement des informations permettant d'identifier l'utilisateur dans ce champ.
PAGE_SIZE : nombre de résultats renvoyés par la recherche. La taille de page maximale autorisée dépend du type de données. Les tailles de page supérieures à la valeur maximale sont réduites à la valeur maximale.
- Sites Web avec indexation de base :
10
par défaut,25
maximum - Sites Web avec indexation avancée:
25
par défaut,50
maximum - Autre :
50
par défaut,100
maximum
- Sites Web avec indexation de base :
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, la taille de la page est de 10, et qu'il y a 15 résultats à renvoyer, les résultats 2 à 11 sont affiché sur la première page.
ORDER_BY : Facultatif. L'ordre dans lequel les résultats sont organisées.
FILTER : Facultatif. Champ de texte permettant de filtrer votre recherche à l'aide d'une expression de filtre. La valeur par défaut est une chaîne vide, ce qui signifie qu'aucun filtre n'est appliqué.
Exemple :
color: ANY("red", "blue") AND score: IN(*, 100.0e)
Pour en savoir plus, consultez Filtrer la recherche de données structurées ou non structurées.
BOOST_SPEC : Facultatif. Une spécification pour booster ou redescendre des documents. Valeurs :
BOOST
: nombre à virgule flottante compris entre -1 et 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
: Une expression de filtre de texte pour sélectionner les documents auxquels l'optimisation est appliquée. Le filtre doit renvoyer une valeur booléenne.
Pour en savoir plus sur l'amélioration de la recherche structurée, consultez Améliorer les résultats de recherche.
FACET_SPEC : Facultatif. Une spécification d'attribut à effectuer la recherche par attribut.
QUERY_EXPANSION_SPEC : Facultatif. Une spécification pour déterminer les conditions dans lesquelles l'extension des requêtes doit se produire. La valeur par défaut est
DISABLED
.SPELL_CORRECTION_SPEC : Facultatif. Spécification permettant de déterminer dans quelles conditions la correction orthographique doit être effectuée. Par défaut est
AUTO
.CONTENT_SEARCH_SPEC : Facultatif. Pour obtenir des extraits, les réponses extractives, les segments extractifs et les résumés de recherche. Pour les données non structurées uniquement. Pour en savoir plus, consultez les pages suivantes :
DATA_STORE_SPEC : filtres pour un datastore spécifique à rechercher. Vous pouvez utiliser cette option si votre application de recherche est connectée à plusieurs data stores.
Afficher les résultats de recherche guidée dans la réponse à la recherche :
Les résultats de recherche guidée sont renvoyés avec les réponses aux recherches et non structurées. Le résultat de la recherche guidée contient une liste les paires clé-valeur extraites des attributs en fonction des documents de résultats de recherche. Cela permet aux utilisateurs d'affiner leurs résultats de recherche en utilisant certaines clés et valeurs d'attributs comme filtres.
Dans cet exemple de réponse, la couleur verte a été utilisée pour affiner les résultats de recherche en envoyant une nouvelle requête de recherche avec le champ de filtre spécifié comme
_gs.color: ANY("green")
:{ "guidedSearchResult": { "refinementAttributes": [ { "attributeKey": "_gs.color", "attributeValue" : "green" }, { "attributeKey": "_gs.category", "attributeValue" : "shoe" } ] } }
C#
Pour en savoir plus, consultez les API C# de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour en savoir plus, consultez les API Java de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour en savoir plus, consultez les API Node.js de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
PHP
Pour en savoir plus, consultez les API PHP de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour en savoir plus, consultez la documentation de référence de l'API Python Vertex AI Agent Builder.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Pour en savoir plus, consultez les API Ruby de Vertex AI Agent Builder documentation de référence.
Pour vous authentifier auprès de Vertex AI Agent Builder, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Obtenir des résultats d'affichage instantané des résultats pour une application multimédia
Pour la recherche multimédia, Vertex AI Agent Builder propose deux types de comportement de recherche :
L'utilisateur saisit la requête de recherche, puis appuie sur Entrée. Il s'agit du comportement par défaut, qui est identique à celui de la recherche dans le widget et de la recherche d'applications non multimédias (génériques). Consultez l'article Obtenir des résultats de recherche pour une application avec des données structurées ou non structurées. données.
Un nouveau résultat de recherche est renvoyé après chaque lettre saisie par l'utilisateur. Cette fonctionnalité, appelée "recherche en temps réel", est particulièrement utile pour les utilisateurs qui saisissent leurs requêtes de recherche via des interfaces plus difficiles à utiliser, comme la télécommande d'un téléviseur.
Pour obtenir des résultats de recherche en temps réel pour une application multimédia :
Console
Pour utiliser la console Google Cloud afin d'activer la recherche en temps réel pour une application de widget :
Dans la console Google Cloud, accédez à la page Agent Builder.
Cliquez sur le nom de l'application de recherche multimédia pour laquelle vous souhaitez utiliser la saisie semi-automatique.
Cliquez sur Configurations.
Cliquez sur l'onglet UI (IUG).
Cliquez sur le bouton Activer l'affichage instantané des résultats.
Dans le volet Aperçu, commencez à saisir une requête.
Les résultats de recherche sont mis à jour après chaque frappe.
Pour conserver le paramètre d'affichage instantané des résultats, cliquez sur Enregistrer et publier.
REST
Utilisez la méthode dataStores.servingConfigs.search
pour obtenir les résultats de recherche d'une application multimédia :
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 récupérez son ID dans la colonne ID.
Exécutez la commande curl suivante pour obtenir les résultats de la recherche en temps réel.
Tous les champs, à l'exception de
contentSearchSpec
, peuvent être utilisés avec le champsearchAsYouTypeSpec
. Par souci de clarté, les champs facultatifs ont été est omis de la commande curl. Pour les champs facultatifs, reportez-vous à la section Obtenir la recherche pour une application avec des données structurées ou non structurées données.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 '{ "query": "QUERY", "searchAsYouTypeSpec": {"condition": "ENABLED"} }'
- PROJECT_ID : ID de votre projet Google Cloud
- APP_ID : ID de l'application Vertex AI Search que vous souhaitez interroger.
- QUERY: texte de la requête à rechercher.
Cliquez ici pour voir un exemple de commande curl.
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" "https://discoveryengine.googleapis.com/v1/projects/12345/locations/global/collections/default_collection/engines/my-app_4321/servingConfigs/default_search:search" -d '{ "query": "midsummer night", "searchAsYouTypeSpec": {"condition": "ENABLED"} }'