Configurer la saisie semi-automatique avancée

Cette page décrit la fonctionnalité de saisie semi-automatique avancée de la recherche Vertex AI.

Comme la saisie semi-automatique de base, la saisie semi-automatique avancée génère des suggestions de requêtes en fonction des premiers caractères saisis pour la requête.

Avant de lire cette page, familiarisez-vous avec la saisie semi-automatique de base de Vertex AI Search. Consultez Configurer la saisie semi-automatique.

Principales fonctionnalités de la saisie semi-automatique avancée

Voici les principales fonctionnalités de la saisie semi-automatique avancée qui la distinguent de la saisie semi-automatique de base:

  • Recherche combinée:la saisie semi-automatique avancée peut être utilisée avec les applications de recherche combinée, qui sont des applications de recherche génériques connectées à plusieurs data store.

  • Contrôle des accès:la saisie semi-automatique avancée respecte les contrôles des accès. (Les contrôles d'accès sont également appelés LCA, listes de contrôle des accès.) La saisie semi-automatique avancée ne suggère que des recherches liées aux documents auxquels l'utilisateur a accès. Pour en savoir plus sur le contrôle des accès, consultez Utiliser le contrôle des accès aux sources de données.

  • Amélioration de la langue:vous pouvez configurer la saisie semi-automatique avancée pour améliorer les suggestions dans une ou plusieurs langues. Par exemple, si la langue du navigateur est le néerlandais, les suggestions de saisie semi-automatique dans cette langue peuvent être renforcées. Pour en savoir plus, consultez la section Envoyer une requête de saisie semi-automatique avec un boost de langue.

  • Différents types de suggestions:avec la saisie semi-automatique avancée, au lieu des suggestions de requêtes de saisie semi-automatique standards, vous pouvez spécifier différents types de suggestions:

Avant de commencer

Examinez et modifiez éventuellement les paramètres de saisie semi-automatique de votre application. Consultez la section Mettre à jour les paramètres de saisie semi-automatique.

En particulier lors des tests, pour les petits entrepôts de données, nous vous recommandons de définir Activer la saisie semi-automatique sur Maintenant. En effet, les petits data stores peuvent ne pas contenir suffisamment de données pour fournir des suggestions précises.

Envoyer des requêtes de saisie semi-automatique

Vous trouverez ci-dessous la procédure à suivre pour envoyer des requêtes de saisie semi-automatique avancées à l'aide de la méthode completionConfig.completeQuery.

REST

Pour envoyer une requête de saisie semi-automatique à l'aide de l'API, procédez comme suit:

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

    1. Dans la console Google Cloud, accédez à la page Agent Builder.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.

  2. Appelez la méthode completionConfig.completeQuery.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING"
    }'

    • PROJECT_ID : ID de votre projet Google Cloud

    • APP_ID: ID de l'application Vertex AI Search.

    • QUERY_STRING: saisie par anticipation utilisée pour extraire des suggestions.

Envoyer une requête de saisie semi-automatique avec un boost de langue

Vous pouvez renforcer l'affichage des suggestions de saisie semi-automatique en fonction du code de langue, par exemple, en rendant les suggestions de saisie semi-automatique dans certaines langues plus ou moins susceptibles d'apparaître.

La valeur d'amélioration doit être comprise entre -1 et 1. Si vous définissez un nombre négatif, les suggestions de saisie semi-automatique dans cette langue sont "enterrées", tandis qu'un nombre positif les met en avant.

Utilisez des tags de langue à deux lettres définis par la norme BCP 47, par exemple en, fr, hi et zh.

REST

Pour envoyer une requête de saisie semi-automatique incluant une valeur de boost de langue, procédez comme suit:

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

    1. Dans la console Google Cloud, accédez à la page Agent Builder.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.

  2. Appelez la méthode completionConfig.completeQuery.

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "boostSpec": {
         "conditionBoostSpecs": [{
           "condition": "(langCode: ANY(LANG_CODE))",
           "boost": BOOST_VALUE
         }]
      }
    }'

    • PROJECT_ID : ID de votre projet Google Cloud

    • APP_ID: ID de l'application Vertex AI Search.

    • QUERY_STRING: saisie par anticipation utilisée pour extraire des suggestions.

    • LANG_CODE: code à deux lettres d'une ou de plusieurs langues, entre guillemets échappés. Par exemple, \"fr\", \"es\" pour appliquer la valeur de boost à l'espagnol et au français.

    • BOOST_VALUE: nombre à virgule flottante compris entre -1 et 1. Lorsque la valeur est négative, les suggestions automatiques dans la langue sont rétrogradées (elles apparaissent plus bas dans la liste des suggestions). Lorsque la valeur est positive, les suggestions sont mises en avant (elles apparaissent plus haut dans la liste).

Envoyer une requête de saisie semi-automatique et renvoyer des suggestions enrichies

La saisie semi-automatique avancée renvoie du contenu (des documents) dont les titres contiennent des mots commençant par la requête.

En plus du titre du document, la requête de saisie semi-automatique renvoie les valeurs source_type et entity_type, et, le cas échéant, les propriétés clés : uri, create_time et update_time. Vous pouvez afficher et modifier les mappages de propriétés clés dans l'onglet Schéma de la page du data store.

Comme pour toutes les suggestions de saisie semi-automatique avancées, les ACL sont respectées pour tous les documents suggérés.

Exemple

Un employé interroge le site intranet de son entreprise pour obtenir des informations techniques sur les autorisations d'accès.

L'employé commence à saisir tec, et les documents suivants peuvent être renvoyés : Data technicians handbook, Access technology guide et Techniques for troubleshooting access issues.

Avec les suggestions enrichies, vous pouvez afficher toutes les informations suivantes pour chacun de ces documents suggérés: le titre du document (title), un lien vers le document (uri), la date de sa dernière mise à jour (update_time) et la source (source_type), par exemple, si le document a été trouvé dans Confluence Cloud ou Slack. Savoir quand un document a été mis à jour et quelle en est la source aide l'employé à choisir celui qu'il doit consulter en premier.

Limites

La saisie semi-automatique avancée ne s'applique qu'aux connecteurs tiers et uniquement à certains magasins de données d'entités pour ces connecteurs tiers. Le tableau suivant indique les entités compatibles avec les connecteurs.

Connecteur tiers Entités acceptées
Box Fichier
Confluence Cloud Page Espace
Dropbox Fichier
Jira Cloud Problème Espace
OneDrive Fichier
Salesforce Account Prospect Opportunité
ServiceNow Incident Connaissances
SharePoint Online Rattachement Événement Fichier Page
Slack Message

Procédure

Pour envoyer une requête de saisie semi-automatique qui renvoie une suggestion enrichie, procédez comme suit:

REST

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

    1. Dans la console Google Cloud, accédez à la page Agent Builder.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.

  2. Appelez la méthode completionConfig.completeQuery.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["CONTENT"]
    }'

    • PROJECT_ID : ID de votre projet Google Cloud

    • APP_ID: ID de l'application Vertex AI Search.

    • QUERY_STRING: saisie par anticipation utilisée pour extraire des suggestions.

Envoyer une requête de saisie semi-automatique et renvoyer les requêtes récentes

Renvoie, sous forme de suggestions, la liste des requêtes les plus récentes de l'utilisateur qui correspondent au préfixe de la requête de la demande.

Les suggestions de requêtes correspondantes sont listées de la plus récente à la plus ancienne. Pour utiliser la recherche récente, vous devez fournir le pseudo-identifiant utilisateur.

Exemple

Un employé interroge le site intranet de son entreprise pour obtenir des informations sur les congés. L'employé a effectué les requêtes suivantes, listées de la plus récente à la plus ancienne:

PTO, Vacation blackout periods, How much vacation time do I have?, Time off, Vacation policy, covering a vacant position during absences et Can I take unpaid time off?

Maintenant, lorsque l'employé saisit vac dans le champ de recherche, les suggestions de saisie semi-automatique sont les suivantes:

  • Vacation blackout periods
  • How much vacation time do I have?
  • Vacation policy
  • Covering a vacant position during absences

Procédure

Pour envoyer une requête de saisie semi-automatique qui renvoie les requêtes les plus récentes de l'utilisateur, procédez comme suit:

REST

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

    1. Dans la console Google Cloud, accédez à la page Agent Builder.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et obtenez son ID dans la colonne ID.

  2. Appelez la méthode completionConfig.completeQuery.

    
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/completionConfig:completeQuery" \
-d '{
      "query":"QUERY_STRING",
      "suggestionTypes": ["RECENT_SEARCH"],
      "userPseudoId": "USER_PSEUDO_ID"
    }'

    • PROJECT_ID : ID de votre projet Google Cloud

    • APP_ID: ID de l'application Vertex AI Search.

    • QUERY_STRING: saisie par anticipation utilisée pour extraire des suggestions.

    • USER_PSEUDO_ID: identifiant pseudonymisé de l'utilisateur. Vous pouvez utiliser un cookie HTTP pour ce champ, qui identifie de manière unique un visiteur sur un seul appareil. Ne définissez pas ce champ sur le même identifiant pour plusieurs utilisateurs. Cela combinerait leurs historiques de requêtes. N'ajoutez pas d'informations permettant d'identifier personnellement l'utilisateur dans ce champ.

Utiliser une liste de blocage pour la saisie semi-automatique

Vous pouvez utiliser une liste de blocage pour empêcher des termes spécifiques d'apparaître sous forme de suggestions de saisie automatique.

Bien que la saisie semi-automatique avancée soit au niveau de l'application, les listes de blocage sont au niveau du magasin de données. Cela est important si votre application est une application de recherche combinée. Créez une liste de blocage pour chaque data store associé à l'application.

Pour en savoir plus sur la création et l'utilisation de listes de blocage, consultez Utiliser la saisie semi-automatique pour les listes de blocage.