Configurer la saisie semi-automatique avancée

Cette page décrit la fonctionnalité de saisie semi-automatique avancée des applications d'IA.

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.

Avant de lire cette page, familiarisez-vous avec la saisie semi-automatique de base des applications d'IA. Consultez Configurer la saisie semi-automatique.

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

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

  • Recherche combinée : la saisie semi-automatique avancée peut être utilisée avec les applications de recherche combinée, c'est-à-dire les applications de recherche personnalisées qui sont 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 requêtes de recherche liées à des documents auxquels le chercheur 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 linguistique : 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 mises en avant. Pour en savoir plus, consultez Envoyer une requête de saisie semi-automatique avec un boost de langue.
  • Requêtes récentes : avec la saisie semi-automatique avancée, les utilisateurs peuvent obtenir leurs requêtes récentes qui correspondent au préfixe des lettres qu'ils saisissent, au lieu des suggestions de requêtes de saisie semi-automatique habituelles. Pour en savoir plus, consultez Envoyer une requête d'autocomplete et renvoyer les requêtes récentes.

Avant de commencer

Avant de commencer à utiliser la saisie semi-automatique avancée, procédez comme suit :

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

  • Pour les plus petits data stores, définissez Activer la saisie semi-automatique sur Maintenant. Nous vous recommandons de le faire, car les petits magasins de données peuvent ne pas contenir suffisamment de données pour fournir des suggestions précises.

  • Si vos magasins de données contiennent des informations permettant d'identifier personnellement l'utilisateur ou si vous utilisez le modèle de suggestions de requêtes d'historique des recherches ou d'événements utilisateur, consultez Se protéger contre les fuites d'informations permettant d'identifier personnellement l'utilisateur et configurez les mesures de protection contre la perte de données (DLP) qui pourraient être nécessaires pour éviter les fuites d'informations permettant d'identifier personnellement l'utilisateur.

Envoyer des requêtes de saisie semi-automatique

Vous trouverez ci-dessous la procédure à suivre pour envoyer des requêtes d'autocomplete avancé à 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. Trouvez l'ID de votre application. Si vous avez déjà votre ID d'application, passez à l'étape suivante.

    1. Dans la console Google Cloud , accédez à la page AI Applications.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.

  1. 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"
    }'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

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

    • QUERY_STRING : entrée de saisie semi-automatique utilisée pour récupérer les suggestions.

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

Vous pouvez mettre en avant ou masquer les suggestions de saisie semi-automatique en fonction du code de langue. Par exemple, vous pouvez faire en sorte que les suggestions de saisie semi-automatique dans certaines langues soient 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 "enfouies". Si vous définissez un nombre positif, la langue est mise en avant.

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

REST

Pour envoyer une requête de saisie semi-automatique incluant une valeur d'amélioration de la langue, procédez comme suit :

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

    1. Dans la console Google Cloud , accédez à la page AI Applications.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.

  1. 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
         }]
      }
    }'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

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

    • QUERY_STRING : saisie de saisie semi-automatique utilisée pour récupérer les suggestions.

    • LANG_CODE : code à deux lettres d'une ou plusieurs langues, entre guillemets. 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 les requêtes récentes

Renvoie, sous forme de suggestions, une liste des requêtes les plus récentes de l'utilisateur qui correspondent au préfixe de la requête dans 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?.

Désormais, 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. Trouvez l'ID de votre application. Si vous avez déjà votre ID d'application, passez à l'étape suivante.

    1. Dans la console Google Cloud , accédez à la page AI Applications.

      Accédez à "Applications".

    2. Sur la page Applications, recherchez le nom de votre application et récupérez son ID dans la colonne ID.

  1. 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"
    }'

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

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

    • QUERY_STRING : saisie de saisie semi-automatique utilisée pour récupérer les 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'incluez 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 refus sont au niveau du datastore. Cela est important si votre application est une application de recherche mixte. Créez une liste de refus pour chaque data store associé à l'application.

Pour savoir comment créer et utiliser des listes de blocage, consultez Utiliser la saisie semi-automatique pour les listes de blocage.

Utiliser une liste importée de suggestions de saisie semi-automatique

Vous pouvez choisir de fournir votre propre liste de suggestions de saisie semi-automatique au lieu d'utiliser celles générées à partir d'un modèle de données de saisie semi-automatique.

Pour savoir comment importer une liste, consultez Utiliser une liste importée de suggestions de saisie semi-automatique.