Configurer la saisie semi-automatique

Cette page décrit la fonctionnalité de saisie semi-automatique de base de Vertex AI Search. La saisie semi-automatique génère des suggestions de requête basées sur les premiers caractères saisi pour la requête.

Remarques:

Pour en savoir plus sur l'affichage instantané des résultats pour les applications de recherche de médias, consultez Obtenir des résultats d'affichage instantané des résultats pour une application multimédia

Pour utiliser la saisie semi-automatique avec les applications de recherche connectées à plusieurs données magasins (mélangés de recherche) ou si vous disposez de documents avec contrôle des accès ou pour optimiser des dans la saisie semi-automatique, consultez la page Configurer saisie semi-automatique avancée.

Les suggestions générées par la saisie semi-automatique varient en fonction du type de données utilisé par l'application de recherche :

• Données structurées et non structurées Par défaut, la saisie semi-automatique génère des suggestions basées sur le contenu des documents dans le data store. Après l'importation de documents, par défaut, la saisie semi-automatique ne commence à générer de suggestions qu'une fois que suffisamment de données de qualité sont disponibles, généralement au bout de quelques jours. Si vous envoyez des requêtes de saisie semi-automatique via l'API, la saisie semi-automatique peut générer des suggestions basées sur l'historique de recherche ou les événements utilisateur.

• Données sur le site Web : Par défaut, la saisie semi-automatique génère des suggestions de l'historique des recherches. La saisie semi-automatique nécessite un véritable trafic de recherche. Après le trafic de recherche commence, la saisie semi-automatique prend un ou deux jours des suggestions. Des suggestions peuvent être générées à partir de données explorées sur le Web à partir de sites publics avec le modèle de données de documents avancé expérimental.

• Données de santé Par défaut, une source de données médicales canonique est utilisée pour générer des suggestions de saisie semi-automatique pour les data stores de santé. Pour la recherche dans le secteur de la santé, la saisie semi-automatique est une fonctionnalité en preview.

Le modèle de données de saisie semi-automatique détermine le type de données utilisé par la saisie semi-automatique pour générer des suggestions. Il existe quatre modèles de saisie semi-automatique :

• Document. Le modèle de document génère des suggestions à partir de les documents importés par l'utilisateur. Ce modèle n'est pas disponible pour les données de site Web ni pour les données de santé.

• Champs à compléter. Le modèle de champs à compléter suggère du texte extrait directement des champs de données structurées. Seuls les champs annotés avec completable sont utilisés pour les suggestions de saisie semi-automatique. Ce modèle n'est disponible que pour les données structurées.

• Historique des recherches. Le modèle d'historique des recherches génère des suggestions à partir de l'historique des appels d'API SearchService.search. N'utilisez pas ce modèle si aucun trafic n'est disponible pour la méthode servingConfigs.search. Ce modèle n'est pas disponibles pour les données de santé.

• Événement utilisateur. Le modèle d'événement utilisateur génère des suggestions à partir des événements de recherche importés par l'utilisateur. Ce modèle n'est pas disponibles pour les données de santé.

Les requêtes Autocomplete sont envoyées à l'aide de la méthode dataStores.completeQuery.

Le tableau suivant indique les types de modèles de saisie semi-automatique disponibles pour chaque type de données.

Modèle de données de saisie semi-automatique	Source de données	Site Web données	Structuré données	Non structurées données
Document	Importé par l'utilisateur		✔* (par défaut)	✔ (par défaut)
À compléter champs	Importé par utilisateur		✔
Historique des recherches	Automatiquement collectées	✔ (par défaut)	✔	✔
Événements utilisateur	Importés par l'utilisateur ou collectés automatiquement par le widget	✔	✔	✔
Explorée sur le Web contenu	Analyse du contenu des sites Web publics spécifiés par l'utilisateur	✔^†

* : Le schéma de document doit contenir des champs title ou description, ou des champs qui ont été spécifiés comme propriétés de clé title ou description. Consultez Mettre à jour un schéma pour les données structurées.

^† : Le contenu exploré sur le Web ne peut être utilisé comme source de données que si le modèle de données de document avancé expérimental pour la saisie semi-automatique est activé. Consultez le modèle de données de document avancé.

Si vous ne souhaitez pas utiliser le modèle par défaut pour votre type de données, vous pouvez spécifier un autre modèle lorsque vous envoyez votre requête de saisie semi-automatique. Saisie semi-automatique sont envoyées à l'aide de la méthode dataStores.completeQuery. Pour consultez la section Instructions pour l'API: Envoyer une requête de saisie semi-automatique pour choisir un modèle différent.

Fonctionnalités de saisie semi-automatique

Vertex AI Search prend en charge les fonctionnalités de saisie semi-automatique suivantes pour vous montrer les prédictions les plus utiles lors de la recherche:

Caractéristique	Description	Exemple ou informations supplémentaires
Supprimer les caractères spéciaux	Supprimez les caractères non standards des données de suggestion et des requêtes saisies. Le tiret - est le seul caractère standard conservé dans les données de suggestion et dans les requêtes saisies.	Mt. Everest & Mt. Kilimanjaro → Mt Everest Mt Kilimanjaro.
Corriger les fautes de frappe	Corriger les fautes d'orthographe	Milc → Milk.
Supprimer les termes dangereux	Avec Google SafeSearch. Supprimez les requêtes inappropriées. Disponible en anglais (en), français (fr), allemand (de), italien (it), polonais (pl), portugais (pt), russe (ru), espagnol (es) et ukrainien (uk).	Texte choquant, comme du contenu pornographique, à caractère sexuel, vulgaire ou violent
Liste de refus	Supprimez les termes figurant dans la liste de blocage.	Pour en savoir plus, consultez Utiliser la saisie semi-automatique pour les listes de blocage.
Dédupliquer les termes	Il s'appuie sur une compréhension sémantique basée sur l'IA. Pour les termes presque identiques, l'un d'eux est mis en correspondance, mais seul le plus populaire est suggéré.	Shoes for Women, Womens Shoes et Womans Shoes sont dédupliqués, et seule la plus populaire est suggérée.
Suggestions de correspondances de queue	Non disponible dans les emplacements multirégionaux des États-Unis et de l'UE. Paramètre facultatif. Si aucune correspondance de saisie semi-automatique n'est trouvée pour l'intégralité de la requête, ne suggérez des correspondances que pour le dernier mot de la requête. Non disponible pour la recherche dans le domaine de la santé.	Pour en savoir plus, consultez Suggestions de correspondances de la queue.

Suggestions de correspondances de queue

Les suggestions de correspondance en fin de chaîne sont générées à l'aide d'une correspondance exacte de préfixe avec le dernier mot d'une chaîne de requête.

Par exemple, dites "chansons avec lui" est envoyé dans une requête de saisie semi-automatique. Lorsque la correspondance de queue est activée, la saisie semi-automatique peut déterminer que le préfixe complet "chansons avec lui" n'a aucune correspondance. Toutefois, le dernier mot de la requête, "il", présente une correspondance exacte de préfixe avec "hello world" et "hello kitty". Dans ce les suggestions renvoyées sont "chansons avec hello world". et "chansons avec bonjour chaton » car aucune suggestion de correspondance complète n'est proposée.

Vous pouvez utiliser cette fonctionnalité pour réduire le nombre de suggestions vides et augmenter la diversité des suggestions, ce qui est particulièrement utile lorsque les sources de données (nombre d'événements utilisateur, historique des recherches et couverture des documents) est limitée. Toutefois, l'activation des suggestions de correspondance finale peut réduire la qualité globale des suggestions. Étant donné que la correspondance de fin ne correspond qu'au dernier mot du préfixe, certaines suggestions renvoyées peuvent ne pas avoir de sens. Par exemple, une requête telle que "chansons avec lui" peut recevoir une suggestion de correspondance de queue telle que "chansons avec assistants" "guides de référence".

Les suggestions de correspondance de fin ne sont renvoyées que si :

1. include_tail_suggestions est défini sur true dans la requête dataStores.completeQuery.

2. Aucune suggestion de correspondance de préfixe complète pour la requête.

Activer ou désactiver la saisie semi-automatique pour un widget

Pour activer ou désactiver la saisie semi-automatique pour un widget, procédez comme suit:

Console

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

   Agent Builder

2. Cliquez sur le nom de l'application que vous souhaitez modifier.

3. Cliquez sur Configurations.

4. Cliquez sur l'onglet UI (Interface utilisateur).

5. Activez l'option Afficher les suggestions de saisie semi-automatique pour activer la saisie semi-automatique. des suggestions pour le widget. Lorsque vous activez la saisie semi-automatique, vous devrez peut-être attendre un ou deux jours avant que les suggestions ne commencent. Santé la saisie semi-automatique est une fonctionnalité en preview.

Modifier les paramètres de saisie semi-automatique

Pour configurer les paramètres de saisie semi-automatique, procédez comme suit:

Console

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

   Agent Builder

2. Cliquez sur le nom de l'application que vous souhaitez modifier.

3. Cliquez sur Configurations.

4. Cliquez sur l'onglet Saisie semi-automatique.

5. Saisissez ou sélectionnez de nouvelles valeurs pour les paramètres de saisie semi-automatique que vous souhaitez mettre à jour :

   • Nombre maximal de suggestions : nombre maximal de suggestions de saisie semi-automatique pouvant être proposées pour une requête.
   • Longueur minimale pour déclencher : nombre minimal de caractères que vous pouvez saisir avant que des suggestions de saisie semi-automatique ne soient proposées.
   • Ordre de correspondance : emplacement dans une chaîne de requête à partir duquel la saisie semi-automatique peut commencer à faire correspondre ses suggestions.
   • Modèle de saisie automatique : modèle de données de saisie automatique utilisé pour générer les suggestions récupérées. Vous pouvez remplacer cette valeur dans dataStores.completeQuery à l'aide du paramètre queryModel.

   • Activer la saisie semi-automatique: par défaut, la saisie semi-automatique ne commence pas jusqu'à ce qu'il dispose de données de qualité suffisante, généralement jours. Si vous souhaitez remplacer cette valeur par défaut et commencer à obtenir suggestions de saisie semi-automatique plus tôt, sélectionnez Maintenant.

     Même si vous sélectionnez Maintenant, la génération de suggestions peut prendre une journée. Certaines suggestions de saisie semi-automatique seront toujours manquantes ou de mauvaise qualité tant que vous n'aurez pas suffisamment de données de qualité.

6. Cliquez sur Enregistrer et publier. Les modifications prennent effet en quelques minutes pour les moteurs où la saisie semi-automatique est déjà activée.

Mettre à jour les annotations de champ completable dans le schéma

Pour activer la saisie semi-automatique pour les champs du schéma de données structurées, procédez comme suit :

Console

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

   Agent Builder

2. Cliquez sur le nom de l'application que vous souhaitez modifier. Il doit utiliser des données structurées.

3. Cliquez sur Data (Données).

4. Cliquez sur l'onglet Schéma.

5. Cliquez sur Modifier pour sélectionner les champs du schéma à marquer comme completable.

6. Cliquez sur Enregistrer pour enregistrer les configurations des champs mises à jour. Ces suggestions prennent environ une journée à générer et à renvoyer.

Envoyer des requêtes de saisie semi-automatique

Les exemples suivants montrent comment envoyer des requêtes de saisie semi-automatique.

REST

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

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

   1. Dans la console Google Cloud, accédez à la page Agent Builder. Dans le menu de navigation, cliquez sur Data stores (Magasins de données).

      Accéder à la page "Data stores"

   2. Cliquez sur le nom de votre data store.

   3. Sur la page Données de votre data store, obtenez l'ID du data store.

2. Appelez la méthode dataStores.completeQuery .

   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING"
   

   • PROJECT_ID: numéro ou ID de projet projet Google Cloud.

   • LOCATION : emplacement de votre entrepôt de données : us, eu ou global.

   • DATA_STORE_ID: ID du data store associé avec votre application.

   • QUERY_STRING : entrée de saisie semi-automatique utilisée pour extraire des suggestions.

Envoyer une requête de saisie semi-automatique à un autre modèle

Pour envoyer une requête de saisie semi-automatique avec un autre modèle de données de saisie semi-automatique, procédez comme suit :

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

   1. Dans la console Google Cloud, accédez à la page Agent Builder. Dans le menu de navigation, cliquez sur Data stores (Magasins de données).

      Accéder à la page "Data stores"

   2. Cliquez sur le nom de votre data store.

   3. Sur la page Données de votre data store, obtenez l'ID du data store.

2. Appelez la méthode dataStores.completeQuery.

   curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores/DATA_STORE_ID:completeQuery?query=QUERY_STRING&query_model=AUTOCOMPLETE_MODEL"
   

   • PROJECT_ID : numéro ou ID de votre projet Google Cloud.
   • LOCATION : emplacement de votre data store (us, eu ou) global
   • DATA_STORE_ID : ID unique du magasin de données associé à votre application.
   • QUERY_STRING : entrée de saisie semi-automatique utilisée pour extraire des suggestions.
   • AUTOCOMPLETE_MODEL: données de la saisie semi-automatique à utiliser pour la requête: document, document-completable, search-history ou user-event. Pour les données de santé, utilisez healthcare-default.

C#

Pour en savoir plus, consultez la documentation de référence de l'API C# 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.

using Google.Cloud.DiscoveryEngine.V1;

public sealed partial class GeneratedCompletionServiceClientSnippets
{
    /// <summary>Snippet for CompleteQuery</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CompleteQueryRequestObject()
    {
        // Create client
        CompletionServiceClient completionServiceClient = CompletionServiceClient.Create();
        // Initialize request argument(s)
        CompleteQueryRequest request = new CompleteQueryRequest
        {
            DataStoreAsDataStoreName = DataStoreName.FromProjectLocationDataStore("[PROJECT]", "[LOCATION]", "[DATA_STORE]"),
            Query = "",
            QueryModel = "",
            UserPseudoId = "",
            IncludeTailSuggestions = false,
        };
        // Make the request
        CompleteQueryResponse response = completionServiceClient.CompleteQuery(request);
    }
}

Go

Pour en savoir plus, consultez la documentation de référence de l'API Go 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.

package main

import (
	"context"

	discoveryengine "cloud.google.com/go/discoveryengine/apiv1"
	discoveryenginepb "cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := discoveryengine.NewCompletionClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &discoveryenginepb.CompleteQueryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/discoveryengine/apiv1/discoveryenginepb#CompleteQueryRequest.
	}
	resp, err := c.CompleteQuery(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

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 le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.discoveryengine.v1.CompleteQueryRequest;
import com.google.cloud.discoveryengine.v1.CompleteQueryResponse;
import com.google.cloud.discoveryengine.v1.CompletionServiceClient;
import com.google.cloud.discoveryengine.v1.DataStoreName;

public class SyncCompleteQuery {

  public static void main(String[] args) throws Exception {
    syncCompleteQuery();
  }

  public static void syncCompleteQuery() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CompletionServiceClient completionServiceClient = CompletionServiceClient.create()) {
      CompleteQueryRequest request =
          CompleteQueryRequest.newBuilder()
              .setDataStore(
                  DataStoreName.ofProjectLocationDataStoreName(
                          "[PROJECT]", "[LOCATION]", "[DATA_STORE]")
                      .toString())
              .setQuery("query107944136")
              .setQueryModel("queryModel-184930495")
              .setUserPseudoId("userPseudoId-1155274652")
              .setIncludeTailSuggestions(true)
              .build();
      CompleteQueryResponse response = completionServiceClient.completeQuery(request);
    }
  }
}

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.

/**
 * This snippet has been automatically generated and should be regarded as a code template only.
 * It will require modifications to work.
 * It may require correct/in-range values for request initialization.
 * TODO(developer): Uncomment these variables before running the sample.
 */
/**
 *  Required. The parent data store resource name for which the completion is
 *  performed, such as
 *  `projects/* /locations/global/collections/default_collection/dataStores/default_data_store`.
 */
// const dataStore = 'abc123'
/**
 *  Required. The typeahead input used to fetch suggestions. Maximum length is
 *  128 characters.
 */
// const query = 'abc123'
/**
 *  Specifies the autocomplete data model. This overrides any model specified
 *  in the Configuration > Autocomplete section of the Cloud console. Currently
 *  supported values:
 *  * `document` - Using suggestions generated from user-imported documents.
 *  * `search-history` - Using suggestions generated from the past history of
 *  SearchService.Search google.cloud.discoveryengine.v1.SearchService.Search 
 *  API calls. Do not use it when there is no traffic for Search API.
 *  * `user-event` - Using suggestions generated from user-imported search
 *  events.
 *  * `document-completable` - Using suggestions taken directly from
 *  user-imported document fields marked as completable.
 *  Default values:
 *  * `document` is the default model for regular dataStores.
 *  * `search-history` is the default model for site search dataStores.
 */
// const queryModel = 'abc123'
/**
 *  A unique identifier for tracking visitors. For example, this could be
 *  implemented with an HTTP cookie, which should be able to uniquely identify
 *  a visitor on a single device. This unique identifier should not change if
 *  the visitor logs in or out of the website.
 *  This field should NOT have a fixed value such as `unknown_visitor`.
 *  This should be the same identifier as
 *  UserEvent.user_pseudo_id google.cloud.discoveryengine.v1.UserEvent.user_pseudo_id 
 *  and
 *  SearchRequest.user_pseudo_id google.cloud.discoveryengine.v1.SearchRequest.user_pseudo_id.
 *  The field must be a UTF-8 encoded string with a length limit of 128
 *  characters. Otherwise, an `INVALID_ARGUMENT` error is returned.
 */
// const userPseudoId = 'abc123'
/**
 *  Indicates if tail suggestions should be returned if there are no
 *  suggestions that match the full query. Even if set to true, if there are
 *  suggestions that match the full query, those are returned and no
 *  tail suggestions are returned.
 */
// const includeTailSuggestions = true

// Imports the Discoveryengine library
const {CompletionServiceClient} = require('@google-cloud/discoveryengine').v1;

// Instantiates a client
const discoveryengineClient = new CompletionServiceClient();

async function callCompleteQuery() {
  // Construct request
  const request = {
    dataStore,
    query,
  };

  // Run request
  const response = await discoveryengineClient.completeQuery(request);
  console.log(response);
}

callCompleteQuery();

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.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import discoveryengine_v1


def sample_complete_query():
    # Create a client
    client = discoveryengine_v1.CompletionServiceClient()

    # Initialize request argument(s)
    request = discoveryengine_v1.CompleteQueryRequest(
        data_store="data_store_value",
        query="query_value",
    )

    # Make the request
    response = client.complete_query(request=request)

    # Handle the response
    print(response)

Ruby

Pour en savoir plus, consultez la documentation de référence de l'API Ruby 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.

require "google/cloud/discovery_engine/v1"

##
# Snippet for the complete_query call in the CompletionService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::DiscoveryEngine::V1::CompletionService::Client#complete_query.
#
def complete_query
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::DiscoveryEngine::V1::CompletionService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::DiscoveryEngine::V1::CompleteQueryRequest.new

  # Call the complete_query method.
  result = client.complete_query request

  # The returned object is of type Google::Cloud::DiscoveryEngine::V1::CompleteQueryResponse.
  p result
end

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 dans la saisie semi-automatique des suggestions.

Prenons l'exemple d'une entreprise pharmaceutique. Si un médicament n'est plus approuvé par la FDA, mais qu'il est mentionné dans des documents de son entrepôt de données, il peut souhaiter empêcher ce médicament d'apparaître en tant que requête suggérée. L’entreprise vous pourriez ajouter le nom du médicament à une liste de blocage pour l'empêcher a été suggéré.

Les limites suivantes s'appliquent :

• Une liste de blocage par magasin de données
• L'importation d'une liste de blocage remplace toute liste de blocage existante pour ce data store
• Jusqu'à 1 000 termes par liste de blocage
• Les termes ne sont pas sensibles à la casse.
• Une fois qu'une liste de blocage a été importée, elle prend effet dans un délai de 1 à 2 jours.

Chaque entrée de votre liste de blocage se compose d'un blockPhrase et d'un matchOperator:

• blockPhrase : saisissez une chaîne comme terme de la liste de blocage. Les termes ne sont pas sensibles à la casse.
• matchOperator : accepte les valeurs suivantes :
  • EXACT_MATCH : empêche une correspondance exacte du terme de la liste de blocage d'apparaître en tant que requête suggérée.
  • CONTAINS : empêche l'affichage de toute suggestion contenant le terme de la liste de blocage.

Voici un exemple de liste de blocage avec quatre entrées:

{
    "entries": [
        {"blockPhrase":"Oranges","matchOperator":"CONTAINS"},
        {"blockPhrase":"bAd apples","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"Cool as A Cucumber","matchOperator":"EXACT_MATCH"},
        {"blockPhrase":"cherry pick","matchOperator":"CONTAINS"}
    ]
}

Avant d'importer une liste de blocage, vérifiez que les contrôles d'accès nécessaires sont définis pour l'accès des éditeurs du moteur de découverte.

Les listes de blocage peuvent être importées à partir de données JSON locales ou de Cloud Storage. Pour supprimer une liste de blocage d'un datastore, purgez-la.

Importer une liste de blocage à partir de données JSON locales

Pour importer une liste de blocage à partir d'un fichier JSON local contenant votre liste de blocage, procédez comme suit :

1. Créez votre liste de blocage dans un fichier JSON local au format suivant. Marque que chaque entrée de la liste de blocage se trouve sur une nouvelle ligne sans saut de ligne.

   {
       "inlineSource": {
           "entries": [
               { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" },
               { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }
           ]
       }
   }

2. Envoyez une requête POST à suggestionDenyListEntries:import, en indiquant le nom de votre fichier .

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @DENYLIST_FILE \
     "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   • DENYLIST_FILE: chemin d'accès local du fichier JSON contenant les termes de la liste de blocage.
   • PROJECT_ID : numéro ou ID de votre projet Google Cloud.
   • LOCATION : emplacement de votre entrepôt de données : us, eu ou global.
   • DATA_STORE_ID: ID du data store associées à votre application.

Une fois votre liste de blocage importée, il faut compter un à deux jours pour commencer à filtrer les suggestions.

Importer une liste de blocage depuis Cloud Storage

Pour importer une liste de blocage à partir d'un fichier JSON dans Cloud Storage, procédez comme suit :

1. Créez votre liste de blocage dans un fichier JSON au format suivant, puis importez-la dans un bucket Cloud Storage. Assurez-vous que chaque entrée de la liste de blocage figure sur une nouvelle ligne, sans saut de ligne.

   { "blockPhrase":"TERM_1","matchOperator":"MATCH_OPERATOR_1" }
   { "blockPhrase":"TERM_2","matchOperator":"MATCH_OPERATOR_2" }

2. Créez un fichier JSON local contenant l'objet gcsSource. Utilisez pour qu'il pointe vers l'emplacement de votre fichier de liste de blocage dans un bucket.

   {
       "gcsSource": {
           "inputUris": [ "DENYLIST_STORAGE_LOCATION" ]
       }
   }

   • DENYLIST_STORAGE_LOCATION: emplacement de votre liste de blocage dans Cloud Storage. Vous ne pouvez saisir qu'un seul URI. L'URI doit être saisi dans ce format: gs://BUCKET/FILE_PATH

3. Envoyez une requête POST à la méthode suggestionDenyListEntries:import, y compris l'objet gcsSource.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json; charset=utf-8" \
       --data @GCS_SOURCE_FILE \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataStores/DATA_STORE_ID/suggestionDenyListEntries:import"
   

   • GCS_SOURCE_FILE: chemin d'accès local du fichier contenant l'objet gcsSource qui pointe vers votre liste de blocage.
   • PROJECT_ID: numéro ou ID de projet projet Google Cloud.
   • LOCATION : emplacement de votre entrepôt de données : us, eu ou global.
   • DATA_STORE_ID: ID du data store associées à votre application.

Une fois la liste de blocage importée, le filtrage des suggestions commence dans un délai d'un à deux jours.

Supprimer définitivement une liste de blocage

Pour supprimer définitivement une liste de blocage de votre data store, procédez comme suit:

1. Envoyez une requête POST à la méthode suggestionDenyListEntries:purge.

   curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
      "https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataStores/DATA_STORE_ID/suggestionDenyListEntries:purge"
   

   • PROJECT_ID: numéro ou ID de projet projet Google Cloud.
   • LOCATION : emplacement de votre entrepôt de données : us, eu ou global.
   • DATA_STORE_ID : ID du magasin de données associé à votre application.

Modèle de données de document avancé

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.

Vertex AI Agent Builder fournit un modèle de données avancé pour la saisie semi-automatique. Basée sur des documents que vous importez, ce modèle de données génère une fonction de saisie semi-automatique de haute qualité à l'aide des grands modèles de langage (LLM) de Google.

Cette fonctionnalité n'est pas disponible actuellement. Si cette fonctionnalité vous intéresse, contacter l'équipe chargée de votre compte Google Cloud et lui demander de l'ajouter à la liste d'autorisation.

Cette fonctionnalité n'est pas disponible pour la recherche dans le secteur de la santé ni dans les ensembles multirégionaux des États-Unis et de l'UE.