CompletionConfig

Configuration permettant de personnaliser la réponse de l'API Autocomplete pour les moteurs et les datastores. Certains champs ne s'appliquent qu'à l'un d'eux.

Représentation JSON 
{
  "name": string,
  "matchingOrder": string,
  "maxSuggestions": integer,
  "minPrefixLength": integer,
  "queryModel": string,
  "queryFrequencyThreshold": integer,
  "numUniqueUsersThreshold": integer,
  "shouldServeContentSuggestions": boolean,
  "filterPiiSuggestionsUsingDlp": boolean,
  "enableMode": enum (EnableMode)
}
Champs
name

string

Obligatoire. Immuable. Nom complet projects/*/locations/*/dataStores/*/completionConfig projects/*/locations/*/collections/*/dataStores/*/completionConfig projects/*/locations/*/collections/*/engines/*/completionConfig
matchingOrder

string

Ordre de correspondance pour les suggestions de saisie semi-automatique. Par exemple, une requête composée de sh avec out-of-order spécifié suggère women's shoes, tandis qu'une requête red s avec exact-prefix spécifié suggère red shoes. Valeurs actuellement acceptées :

  • out-of-order
  • exact-prefix

Valeur par défaut : exact-prefix.
maxSuggestions

integer

Nombre maximal de suggestions de saisie semi-automatique renvoyées par terme.

maxSuggestions doit être compris entre 1 et 20. Si cette valeur n'est pas définie ou est définie sur 0, elle est définie par défaut sur 20 suggestions.
minPrefixLength

integer

Nombre minimal de caractères à saisir pour obtenir des suggestions.

minPrefixLength doit être compris entre 1 et 20. Si cette valeur n'est pas définie ou est définie sur 0, elle est définie par défaut sur 1 caractère.
queryModel

string

Modèle de données des suggestions de requêtes pour la diffusion.

Valeurs actuellement acceptées :

  • automatic : le backend de saisie semi-automatique sélectionne ou combine automatiquement des suggestions provenant de différents modèles.
  • document : utilisation des suggestions générées à partir de documents importés par l'utilisateur.
  • search-history : utilisation des suggestions générées à partir de l'historique des appels d'API SearchService.Search. Ne l'utilisez pas s'il n'y a pas de trafic pour l'API Search.
  • user-event : utilisation des suggestions générées à partir d'événements de recherche importés par l'utilisateur.
  • document-completable : utilisation des suggestions extraites directement des champs de document importés par l'utilisateur et marqués comme pouvant être complétés.

Si le modèle de requête est vide, la diffusion applique le modèle "automatique" par défaut.
queryFrequencyThreshold

integer

Ce champ n'est pertinent que pour les suggestions générées à partir d'événements utilisateur ou de l'historique de recherche. Si une requête s'affiche moins que ce seuil, cela peut indiquer qu'elle est rarement recherchée et qu'elle ne sera donc pas générée en tant que suggestion. Ce champ peut être utile pour empêcher que les requêtes contenant des informations personnelles identifiables ne deviennent des suggestions, car ces requêtes sont généralement recherchées de manière unique. Si cette valeur n'est pas définie, la valeur par défaut 8 est utilisée dans le pipeline de génération.
numUniqueUsersThreshold

integer

Ce champ n'est pertinent que pour les suggestions générées à partir d'événements utilisateur ou de l'historique de recherche, auxquels des ID utilisateur peuvent être associés. Si le nombre d'utilisateurs uniques ayant recherché une requête est inférieur à ce seuil, la requête ne sera pas générée en tant que suggestion. Ce champ peut être utile pour empêcher que les requêtes contenant des informations personnelles identifiables ne deviennent des suggestions, car ces requêtes sont généralement recherchées de manière unique. Si cette valeur n'est pas définie, la valeur par défaut 3 est utilisée dans le pipeline de génération.
shouldServeContentSuggestions

boolean

Indique s'il faut générer et diffuser des suggestions de contenu. Cela permet de diffuser des suggestions de contenu en plus des suggestions de requêtes.
filterPiiSuggestionsUsingDlp
(deprecated)

boolean

Obsolète : ce champ n'a aucun effet. Depuis mai 2025, le filtrage des suggestions contenant des informations personnelles identifiables à l'aide de DLP est toujours activé pour tous les datastores et ne peut pas être configuré par data store.
enableMode

enum (EnableMode)

Mode d'activation des pipelines de génération de saisie semi-automatique. Si ce champ n'est pas défini, le comportement du serveur est défini par défaut sur CompletionConfig.EnableMode.AUTOMATIC. S'applique uniquement à DataStore. Ignoré pour Engine.

EnableMode

Spécifie le mode d'activation des pipelines de génération de saisie semi-automatique.

Enums
ENABLE_MODE_UNSPECIFIED Lorsque le mode d'activation de la saisie semi-automatique n'est pas spécifié, le mode AUTOMATIC est appliqué par défaut.
AUTOMATIC La saisie semi-automatique est activée lorsque le data store répond aux critères.
MANUAL La saisie semi-automatique est activée, quels que soient les exigences en matière de données UCS.