NaturalLanguageQueryUnderstandingSpec

Spécification permettant d'activer les fonctionnalités de compréhension du langage naturel pour les demandes de recherche.

Représentation JSON
{
  "filterExtractionCondition": enum (FilterExtractionCondition),
  "geoSearchQueryDetectionFieldNames": [
    string
  ],
  "extractedFilterBehavior": enum (ExtractedFilterBehavior),
  "allowedFieldNames": [
    string
  ]
}
Champs
filterExtractionCondition

enum (FilterExtractionCondition)

Condition dans laquelle l'extraction du filtre doit avoir lieu. Le comportement du serveur est défini par défaut sur DISABLED.

geoSearchQueryDetectionFieldNames[]

string

Noms de champs utilisés pour le filtrage basé sur la localisation, lorsque des filtres de géolocalisation sont détectés dans les requêtes de recherche en langage naturel. Valide uniquement lorsque FilterExtractionCondition est défini sur ENABLED.

Si ce champ est défini, il remplace les noms de champs définis dans ServingConfig.geo_search_query_detection_field_names.

extractedFilterBehavior

enum (ExtractedFilterBehavior)

Facultatif. Contrôle le comportement d'application des filtres extraits à la recherche. Le comportement par défaut dépend de la demande. Pour la recherche structurée dans un seul datastore, la valeur par défaut est HARD_FILTER. Pour la recherche multidépôt de données, le comportement par défaut est SOFT_BOOST. Les filtres basés sur la localisation sont toujours appliqués en tant que filtres stricts. Le paramètre SOFT_BOOST n'a aucune incidence sur eux. Ce champ n'est utilisé que si [SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition][] est défini sur FilterExtractionCondition.ENABLED.

allowedFieldNames[]

string

Facultatif. Liste d'autorisation des champs pouvant être utilisés pour l'extraction de filtres en langage naturel. Par défaut, si ce paramètre n'est pas spécifié, tous les champs indexables peuvent être utilisés pour l'extraction de filtres en langage naturel (mais leur utilisation n'est pas garantie). Si des champs sont spécifiés dans allowedFieldNames, seuls les champs marqués comme indexables dans le schéma et spécifiés dans la liste d'autorisation pourront faire l'objet d'une extraction de filtres en langage naturel. Remarque : Pour la recherche multidatastore, cette option n'est pas encore disponible et sera ignorée.

FilterExtractionCondition

Énumération décrivant la condition dans laquelle l'extraction du filtre doit avoir lieu.

Enums
CONDITION_UNSPECIFIED Le comportement du serveur est défini par défaut sur DISABLED.
DISABLED Désactive l'extraction des filtres de langage naturel.
ENABLED Active l'extraction des filtres de langage naturel.

ExtractedFilterBehavior

Énumération décrivant comment les filtres extraits sont appliqués à la recherche.

Enums
EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED utilisera le comportement par défaut pour les filtres extraits. Pour une recherche unique dans le datastore, l'option par défaut consiste à appliquer des filtres stricts. Pour la recherche multidatastore, la valeur par défaut consiste à appliquer des boosts faibles.
HARD_FILTER Applique tous les filtres extraits en tant que filtres stricts sur les résultats. Les résultats qui ne respectent pas les filtres extraits ne seront pas renvoyés dans l'ensemble de résultats.
SOFT_BOOST Applique tous les filtres extraits en tant que boosts modérés. Les résultats qui passent les filtres seront mis en avant et apparaîtront plus haut dans l'ensemble de résultats.