NaturalLanguageQueryUnderstandingSpec

規格：為搜尋要求啟用自然語言理解功能。

JSON 表示法 
{
  "filterExtractionCondition": enum (FilterExtractionCondition),
  "geoSearchQueryDetectionFieldNames": [
    string
  ],
  "extractedFilterBehavior": enum (ExtractedFilterBehavior),
  "allowedFieldNames": [
    string
  ]
}
欄位
filterExtractionCondition

enum (FilterExtractionCondition)

篩選器擷取作業的發生條件。伺服器行為預設為 DISABLED。
geoSearchQueryDetectionFieldNames[]

string

用於位置篩選的欄位名稱，系統會在自然語言搜尋查詢中偵測到地理位置篩選條件。只有在 FilterExtractionCondition 設為 ENABLED 時才有效。

如果設定此欄位，系統會覆寫 ServingConfig.geo_search_query_detection_field_names 中設定的欄位名稱。
extractedFilterBehavior

enum (ExtractedFilterBehavior)

(選用步驟) 控制如何將擷取的篩選器套用至搜尋。預設行為取決於要求。如果是單一資料儲存庫結構化搜尋，預設值為 HARD_FILTER。如果是多資料存放區搜尋，預設行為為 SOFT_BOOST。系統一律會將位置篩選器套用為硬性篩選器，且 SOFT_BOOST 設定不會影響這類篩選器。只有在 [SearchRequest.natural_language_query_understanding_spec.filter_extraction_condition][] 設為 FilterExtractionCondition.ENABLED 時，才會使用此欄位。
allowedFieldNames[]

string

(選用步驟) 可用於擷取自然語言篩選條件的欄位許可清單。如果未指定，所有可建立索引的欄位預設都會符合自然語言篩選器擷取條件 (但不保證會使用)。如果 allowedFieldNames 中指定了任何欄位，只有在結構定義中標示為可建立索引，且位於允許清單中的欄位，才能擷取自然語言篩選器。注意：目前不支援多資料存放區搜尋，系統會忽略這項設定。

FilterExtractionCondition

列舉，說明應在何種條件下擷取篩選器。

列舉
CONDITION_UNSPECIFIED 伺服器行為預設為 DISABLED。
DISABLED 停用 NL 篩選器擷取作業。
ENABLED 啟用 NL 篩選器擷取功能。

ExtractedFilterBehavior

列舉說明如何將擷取的篩選器套用至搜尋。

列舉
EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED EXTRACTED_FILTER_BEHAVIOR_UNSPECIFIED 會使用預設行為擷取篩選器。如果是單一資料儲存區搜尋，預設會套用硬性篩選器。如果是多資料儲存庫搜尋，預設會套用為軟性加成。
HARD_FILTER 將所有擷取的篩選條件套用至結果，做為硬性篩選條件。如果結果未通過擷取的篩選條件，就不會傳回結果集。
SOFT_BOOST 將所有擷取的篩選條件套用為軟性加成。通過篩選條件的結果會在結果集中獲得較高的排名。