Configurer la saisie semi-automatique avancée

Expérimental

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" dans la section "Conditions d'utilisation générales" des Conditions spécifiques au service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une assistance limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Important :La saisie semi-automatique avancée est disponible dans Google Cloud clients. Pour en savoir plus ou vous inscrire pour utiliser cette fonctionnalité, contactez votre Conseiller commercial Google Cloud.

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

Tout comme la saisie semi-automatique de base, la saisie semi-automatique avancée génère des requêtes des suggestions basées sur les 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

Principales fonctionnalités de la saisie semi-automatique avancée qui la distinguent de la saisie semi-automatique de base pour la saisie semi-automatique sont les suivantes:

• Recherche combinée:la saisie semi-automatique avancée peut être utilisée avec la recherche combinée. applications, il s'agit d'applications de recherche génériques connectée à plusieurs data store.

• Contrôle des accès : la saisie semi-automatique avancée respecte les contrôles des accès. (Accès sont également appelés LCA (listes de contrôle des accès). Avancé la saisie semi-automatique suggère uniquement des recherches en rapport avec les documents auquel l'internaute a accès. Pour en savoir plus sur le contrôle des accès, consultez la section Utiliser les données le contrôle des accès aux sources.

• 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, la saisie semi-automatique les suggestions dans cette langue pourraient être boostées. Pour en savoir plus, consultez 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 des suggestions de requête de saisie semi-automatique standards, vous pouvez indiquer différents types de suggestions:

  • Suggestions enrichies:en tant que suggestions de saisie semi-automatique, les utilisateurs obtiennent des informations sur les documents dont le préfixe de titre correspond aux lettres qu'il saisit. Pour en savoir plus, consultez Envoyer une requête de saisie semi-automatique et renvoyer des suggestions enrichies.

  • Requêtes récentes:en tant que suggestions de saisie semi-automatique, les utilisateurs obtiennent requêtes commençant par les lettres qu'ils saisissent. Pour en savoir plus, consultez la section Envoyer une requête de saisie semi-automatique et renvoyer des requêtes.

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ée à 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 récupérez 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. Définir un nombre négatif "cerne" des suggestions de saisie semi-automatique dans cette langue et un nombre positif langue.

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 qui inclut une valeur d'amplification de la langue, procédez comme suit : 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: entrée de saisie utilisée pour récupérer les suggestions.

   • LANG_CODE: code à deux lettres correspondant à une ou plusieurs langues entre guillemets échappés. Par exemple, \"fr\", \"es\" pour appliquer en espagnol et en 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).

   Exemple de commande

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   -d '{
        "query": { "text": "Co"}
        "boostSpec": {
           "conditionBoostSpecs": [{
             "condition": "(langCode: ANY(\"es\", \"fr\"))",
             "boost": 0.75 }, {
             "condition": "(langCode: ANY(\"en\"))",
             "boost": -1
           }]
         }
       }'
    

   Dans cet exemple, les suggestions de saisie semi-automatique pour la requête Co sont mises en avant (placées plus haut dans la liste de suggestions semi-automatiques) si elles sont en français ou en espagnol, et masquées (placées plus bas dans la liste de suggestions semi-automatiques) si elles sont en anglais.

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 à la recherche d'informations techniques sur les autorisations d'accès.

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

Grâce aux suggestions enrichies, vous pouvez afficher pour chacun de ces documents toutes les informations suivantes à propos du document: le titre du document (title), un lien vers le document (uri), lors 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 à quel point un document a été mis à jour récemment 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 entrepôts de données d'entités pour ces connecteurs tiers. Le tableau suivant montre 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 l'ID de votre 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.

   Exemple de commande et de résultat

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   - d {
         "query": "C",
         "suggestionTypes": ["CONTENT"]
       }
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
     }]
   }
   
   

Remarque : Si vous spécifiez suggestionTypes comme CONTENT, tous les paramètres boostSpec, queryModel ou includeTailSuggestions de votre commande curl sont ignorés.

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ête correspondantes sont répertoriées de la plus récente à la plus ancienne. Pour utiliser la recherche récente, le pseudo-identifiant utilisateur doit être fourni.

Exemple

Un employé interroge le site intranet de son entreprise pour obtenir des informations sur prendre des vacances. 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 récupérez 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 pas définir ce champ sur le même identifiant pour plusieurs utilisateurs. Cela combinerait leurs historiques de requêtes. À ne pas faire inclure des informations permettant d'identifier l'utilisateur dans ce champ.

   Exemple de commande et de résultat

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)"
   -H "Content-Type: application/json"
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/completionConfig:completeQuery"
   - d '{
         "query": "C",
         "suggestionTypes": ["RECENT_SEARCH"],
         "userPseudoId: "test_user"
       }
   
   {
     "contentSuggestions": [{
       "suggestion": "critical crash in payment module",
       "document": {
         "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/branches/0/documents/10000",
         "derivedStructData": {
           "title": "Critical Crash in Payment Module",
           "uri": "https://cymballabs.atlassian.net/browse/CPT-1",
           "source_type": "jira",
           "entity_type": "issue"
         }
       },
       "dataStore": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store"
     }]
   }
   

Remarque : Si vous spécifiez suggestionTypes comme RECENT_SEARCH, tous les paramètres boostSpec, queryModel ou includeTailSuggestions de votre commande curl sont ignorés.

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. C'est important si votre application est une application de recherche combinée. Créez une liste de blocage pour chaque data store connecté à 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.