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 추출된 모든 필터를 소프트 부스트로 적용합니다. 필터를 통과한 결과는 결과 세트에서 더 높은 순위로 올라갑니다.