REST Resource: projects.locations.evaluations

리소스: 평가

평가는 평가 프로세스의 단일 실행입니다. 평가 상태와 결과 데이터를 캡슐화합니다.

JSON 표현 
{
  "name": string,
  "evaluationSpec": {
    object (EvaluationSpec)
  },
  "qualityMetrics": {
    object (QualityMetrics)
  },
  "state": enum (State),
  "error": {
    object (Status)
  },
  "createTime": string,
  "endTime": string,
  "errorSamples": [
    {
      object (Status)
    }
  ]
}
필드
name

string

식별자입니다. Evaluation의 전체 리소스 이름입니다(projects/{project}/locations/{location}/evaluations/{evaluation} 형식).

이 필드는 UTF-8로 인코딩된 문자열이어야 하며 길이는 1,024자(영문 기준)로 제한됩니다.
evaluationSpec

object (EvaluationSpec)

필수 항목입니다. 평가의 명세.
qualityMetrics

object (QualityMetrics)

출력 전용입니다. 평가에서 생성된 측정항목으로, SampleQuerySet의 모든 SampleQuery에 대해 평균을 낸 값입니다.

평가 상태가 SUCCEEDED인 경우에만 채워집니다.
state

enum (State)

출력 전용입니다. 평가의 상태입니다.
error

object (Status)

출력 전용입니다. 평가 중에 발생한 오류입니다. 평가 상태가 실패인 경우에만 채워집니다.
createTime

string (Timestamp format)

출력 전용입니다. Evaluation가 생성된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
endTime

string (Timestamp format)

출력 전용입니다. Evaluation가 완료된 타임스탬프입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
errorSamples[]

object (Status)

출력 전용입니다. 요청을 처리하는 중에 발생한 오류 샘플입니다.

EvaluationSpec

평가 사양을 설명합니다.

JSON 표현 
{
  "querySetSpec": {
    object (QuerySetSpec)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "searchRequest": {
    object (SearchRequest)
  }
  // End of mutually exclusive fields.
}
필드
querySetSpec

object (QuerySetSpec)

선택사항입니다. 질문 세트의 사양입니다.
검색 사양입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
searchRequest

object (SearchRequest)

필수 항목입니다. 평가를 수행하는 데 사용되는 검색 요청입니다.

SearchRequest 내에서는 다음 필드만 지원됩니다. 다른 필드를 제공하면 UNSUPPORTED 오류가 반환됩니다.
상호 배타적 필드의 끝입니다.

SearchRequest

SearchService.Search 메서드의 요청 메시지입니다.

JSON 표현 
{
  "servingConfig": string,
  "branch": string,
  "query": string,
  "pageCategories": [
    string
  ],
  "imageQuery": {
    object (ImageQuery)
  },
  "pageSize": integer,
  "pageToken": string,
  "offset": integer,
  "oneBoxPageSize": integer,
  "dataStoreSpecs": [
    {
      object (DataStoreSpec)
    }
  ],
  "numResultsPerDataStore": integer,
  "filter": string,
  "canonicalFilter": string,
  "orderBy": string,
  "userInfo": {
    object (UserInfo)
  },
  "languageCode": string,
  "regionCode": string,
  "facetSpecs": [
    {
      object (FacetSpec)
    }
  ],
  "boostSpec": {
    object (BoostSpec)
  },
  "params": {
    string: value,
    ...
  },
  "queryExpansionSpec": {
    object (QueryExpansionSpec)
  },
  "spellCorrectionSpec": {
    object (SpellCorrectionSpec)
  },
  "userPseudoId": string,
  "useLatestData": boolean,
  "contentSearchSpec": {
    object (ContentSearchSpec)
  },
  "embeddingSpec": {
    object (EmbeddingSpec)
  },
  "rankingExpression": string,
  "rankingExpressionBackend": enum (RankingExpressionBackend),
  "safeSearch": boolean,
  "userLabels": {
    string: string,
    ...
  },
  "naturalLanguageQueryUnderstandingSpec": {
    object (NaturalLanguageQueryUnderstandingSpec)
  },
  "searchAsYouTypeSpec": {
    object (SearchAsYouTypeSpec)
  },
  "customFineTuningSpec": {
    object (CustomFineTuningSpec)
  },
  "displaySpec": {
    object (DisplaySpec)
  },
  "crowdingSpecs": [
    {
      object (CrowdingSpec)
    }
  ],
  "session": string,
  "sessionSpec": {
    object (SessionSpec)
  },
  "relevanceThreshold": enum (RelevanceThreshold),
  "relevanceFilterSpec": {
    object (RelevanceFilterSpec)
  },
  "personalizationSpec": {
    object (PersonalizationSpec)
  },
  "relevanceScoreSpec": {
    object (RelevanceScoreSpec)
  },
  "searchAddonSpec": {
    object (SearchAddonSpec)
  },
  "customRankingParams": {
    object (CustomRankingParams)
  },
  "entity": string
}
필드
servingConfig

string

필수 항목입니다. 검색 서비스 구성의 리소스 이름(예: projects/*/locations/global/collections/default_collection/engines/*/servingConfigs/default_serving_config 또는 projects/*/locations/global/collections/default_collection/dataStores/default_data_store/servingConfigs/default_serving_config). 이 필드는 검색을 수행하는 데 사용되는 모델 집합인 서빙 구성 이름을 식별하는 데 사용됩니다.
branch

string

브랜치 리소스 이름입니다(예: projects/*/locations/global/collections/default_collection/dataStores/default_data_store/branches/0).

default_branch를 브랜치 ID로 사용하거나 이 필드를 비워 기본 브랜치에서 문서를 검색합니다.
query

string

원시 검색어입니다.
pageCategories[]

string

선택사항입니다. 카테고리 페이지와 연결된 카테고리입니다. 양질의 검색 결과를 얻으려면 카테고리 탐색 쿼리에 설정해야 합니다. 형식은 PageInfo.page_category와 같아야 합니다. 이 필드는 탐색 (탐색) 쿼리의 쿼리와 동일합니다. 쿼리가 비어 있을 때 탐색 모델에서 사용됩니다.

필드가 비어 있으면 탐색 모델에서 사용되지 않습니다. 필드에 요소가 두 개 이상 포함된 경우 첫 번째 요소만 사용됩니다.

카테고리의 전체 경로를 나타내려면 '>' 문자를 사용하여 다양한 계층 구조를 구분합니다. '>'가 카테고리 이름에 포함된 경우 다른 문자로 바꿉니다. 예를 들어 'RTX > 4090'이 한 수준을 나타내는 Graphics Cards > RTX>4090 > Founders Edition는 Graphics Cards > RTX_4090 > Founders Edition로 다시 작성할 수 있습니다.
imageQuery

object (ImageQuery)

원시 이미지 쿼리입니다.
pageSize

integer

반환할 최대 Document 수입니다. 최대 허용 값은 데이터 유형에 따라 다릅니다. 최댓값을 초과하는 값은 최댓값으로 변환됩니다.

  • 기본 색인 생성이 있는 웹사이트: 기본값 10, 최댓값 25
  • 고급 색인 생성이 있는 웹사이트: 기본값 25, 최댓값 50
  • 기타: 기본값 50, 최댓값 100

이 필드가 음수이면 INVALID_ARGUMENT가 반환됩니다.
pageToken

string

이전 SearchService.Search 호출에서 받은 페이지 토큰입니다. 후속 페이지를 검색하려면 이를 입력합니다.

페이지를 매길 때 SearchService.Search에 제공된 다른 모든 매개 변수는 페이지 토큰을 제공한 호출과 일치해야 합니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
offset

integer

검색 결과에서 현재 오프셋(즉, API에서 관련 있는 것으로 간주되는 Document 중 시작 결과 위치)을 지정하는 0부터 시작하는 정수입니다. 이 필드는 pageToken이 설정되지 않은 경우에만 고려됩니다.

이 필드가 음수이면 INVALID_ARGUMENT가 반환됩니다.

큰 오프셋은 적절한 기준점으로 제한될 수 있습니다.
oneBoxPageSize

integer

OneBox에 반환할 최대 결과 수입니다. 이는 각 OneBox 유형에 개별적으로 적용됩니다. 기본값은 10입니다.
dataStoreSpecs[]

object (DataStoreSpec)

검색할 특정 DataStore와 해당 데이터 스토어의 구성을 정의하는 사양입니다. 데이터 스토어가 여러 개인 Engine에만 적용됩니다. 데이터 스토어가 하나 있는 엔진의 경우 SearchRequest 바로 아래의 사양을 사용해야 합니다.
numResultsPerDataStore

integer

선택사항입니다. 각 데이터 스토어에서 가져올 최대 결과 수입니다. 지정하지 않으면 제공된 경우 SearchRequest.DataStoreSpec.num_results가 사용되고, 그렇지 않으면 제한이 없습니다.
filter

string

필터 구문은 필터링되는 문서의 필드 하나 이상에서 조건자를 구성하기 위한 표현식 언어로 구성됩니다. 필터 표현식은 대소문자를 구분합니다.

이 필드를 인식할 수 없으면 INVALID_ARGUMENT가 반환됩니다.

Vertex AI Search의 필터링은 LHS 필터 키를 Vertex AI Search 백엔드에 정의된 키 속성에 매핑하여 실행됩니다. 이 매핑은 고객이 스키마에 정의합니다. 예를 들어 미디어 고객의 스키마에는 'name' 필드가 있을 수 있습니다. 이 경우 필터는 filter --> name:'ANY("king kong")'입니다.

구문 및 필터 연산자를 포함한 필터링에 대한 자세한 내용은 필터를 참조하세요.
canonicalFilter

string

사용자가 검색 페이지에서 필터를 선택하지 않고 검색을 수행할 때 적용되는 기본 필터입니다.

검색어 확장과 같은 품질 개선이 필요한 경우 모든 검색 요청에 적용되는 필터입니다. 쿼리에 결과가 부족하면 이 필터를 사용하여 검색어 확장 흐름을 사용 설정할지 여부를 결정합니다. 검색어 확장 검색에는 원래 필터가 계속 사용됩니다. 높은 검색 품질을 달성하려면 이 필드를 사용하는 것이 좋습니다.

필터 구문에 대한 자세한 내용은 SearchRequest.filter를 참조하세요.
orderBy

string

문서가 반환되는 순서입니다. 문서는 Document 객체의 필드별로 정렬될 수 있습니다. 관련성별로 정렬하는 경우 설정하지 않은 상태로 둡니다. orderBy 표현식은 대소문자를 구분합니다.

웹사이트 검색 결과를 정렬하는 방법에 대한 자세한 내용은 웹 검색 결과 정렬을 참조하세요. 의료 검색 결과를 정렬하는 방법에 대한 자세한 내용은 의료 검색 결과 정렬을 참조하세요. 이 필드를 인식할 수 없으면 INVALID_ARGUMENT가 반환됩니다.
userInfo

object (UserInfo)

최종 사용자에 대한 정보입니다. 분석 및 맞춤설정에 권장됩니다. UserInfo.user_agent는 분석을 위해 deviceType을 추론하는 데 사용됩니다.
languageCode

string

BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 표준 필드를 참조하세요. 이 필드는 쿼리를 더 잘 해석하는 데 도움이 됩니다. 값을 지정하지 않으면 쿼리 언어 코드가 자동으로 감지되지만 정확하지 않을 수 있습니다.
regionCode

string

위치를 나타내는 Unicode 국가/지역 코드(CLDR)입니다(예: 'US', '419'). 자세한 내용은 표준 필드를 참조하세요. 설정된 경우 결과가 제공된 regionCode를 기반으로 부스팅됩니다.
facetSpecs[]

object (FacetSpec)

패싯 검색을 위한 패싯 사양입니다. 비어 있으면 패싯이 반환되지 않습니다.

값은 최대 100개까지 허용됩니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
boostSpec

object (BoostSpec)

특정 문서를 부스팅하는 부스트 사양입니다. 부스팅 방법에 대한 자세한 내용은 부스팅을 참조하세요.
params

map (key: string, value: value (Value format))

추가 검색 파라미터입니다.

공개 웹사이트 검색의 경우에만 지원되는 값은 다음과 같습니다.

  • user_country_code: 문자열입니다. 기본값은 비어 있습니다. 비어 있지 않은 값으로 설정하면 제공된 위치에 따라 결과가 제한되거나 부스팅됩니다. 예를 들면 user_country_code: "au"입니다.

사용 가능한 코드는 국가 코드를 참조하세요.

  • searchType: 배정밀도입니다. 기본값은 비어 있습니다. 값에 따라 웹페이지가 아닌 검색을 사용 설정합니다. 유일하게 유효한 비기본값은 1이며 이 값은 이미지 검색을 사용 설정합니다. 예를 들면 searchType: 1입니다.
queryExpansionSpec

object (QueryExpansionSpec)

검색어 확장이 발생하는 조건을 지정하는 검색어 확장 사양입니다.
spellCorrectionSpec

object (SpellCorrectionSpec)

맞춤법 교정이 적용되는 모드를 지정하는 맞춤법 교정 사양입니다.
userPseudoId

string

선택사항. 방문자 추적을 위한 고유 식별자입니다. 예를 들어 단일 기기에서 방문자를 고유하게 식별할 수 있는 HTTP 쿠키를 사용하여 이를 구현할 수 있습니다. 이 고유 식별자는 방문자가 웹사이트에 로그인 또는 로그아웃해도 변경되지 않아야 합니다.

이 필드에는 unknown_visitor와 같은 고정 값이 있어서는 안 됩니다.

UserEvent.user_pseudo_id 및 CompleteQueryRequest.user_pseudo_id와 동일한 식별자여야 합니다.

필드는 UTF-8로 인코딩된 문자열이어야 하며 길이는 128자(영문 기준)로 제한됩니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
useLatestData

boolean

데이터베이스에서 새로 읽어온 Engine, ServingConfig 및 Control을 사용합니다.

참고: 이렇게 하면 구성 캐시가 건너뛰고 데이터베이스에 대한 종속성이 도입되어 API 지연 시간이 크게 늘어날 수 있습니다. 테스트에만 사용해야 하며 최종 사용자에게 제공해서는 안 됩니다.
contentSearchSpec

object (ContentSearchSpec)

콘텐츠 검색 동작을 구성하기 위한 사양입니다.
embeddingSpec

object (EmbeddingSpec)

제공된 임베딩을 사용하여 추가 시맨틱 문서 검색을 수행합니다. 검색은 SearchRequest.EmbeddingSpec.EmbeddingVector.vector 및 SearchRequest.EmbeddingSpec.EmbeddingVector.field_path에 제공된 문서 임베딩의 내적을 기반으로 합니다.

SearchRequest.EmbeddingSpec.EmbeddingVector.field_path가 제공되지 않으면 ServingConfig.EmbeddingConfig.field_path가 사용됩니다.
rankingExpression

string

선택사항. 순위 표현식은 검색 문서의 맞춤설정된 순위를 제어합니다. 이렇게 하면 ServingConfig.ranking_expression이 재정의됩니다. 구문과 지원되는 기능은 rankingExpressionBackend 값에 따라 달라집니다. rankingExpressionBackend를 제공하지 않으면 기본값은 RANK_BY_EMBEDDING입니다.

rankingExpressionBackend가 제공되지 않거나 RANK_BY_EMBEDDING으로 설정된 경우 '+'로 조인된 함수 하나 또는 여러 개이어야 합니다.

  • rankingExpression = function, { " + ", function };

지원되는 함수:

  • double * relevanceScore
  • double * dotProduct(embedding_field_path)

함수 변수:

  • relevanceScore: 쿼리와 문서 간의 관련성을 측정하는 데 사용되는 사전 정의된 키워드입니다.
  • embedding_field_path: 쿼리 임베딩 벡터와 함께 사용되는 문서 임베딩 필드입니다.
  • dotProduct: embedding_field_path 및 쿼리 임베딩 벡터 간의 임베딩 함수입니다.

순위 표현식 예시:

문서에 임베딩 필드 doc_embedding이 있는 경우 순위 표현식은 0.5 * relevanceScore + 0.3 * dotProduct(doc_embedding)일 수 있습니다.

rankingExpressionBackend가 RANK_BY_FORMULA로 설정된 경우 다음 표현식 유형(및 + 또는 * 연산자로 연결된 조합)이 지원됩니다.

  • double
  • signal
  • log(signal)
  • exp(signal)
  • rr(signal, double > 0) -- 두 번째 인수가 분모 상수인 상호 순위 변환입니다.
  • isNan(signal) -- 신호가 NaN이면 0을, 그렇지 않으면 1을 반환합니다.
  • fillNan(signal1, signal2 | double) -- signal1이 NaN이면 signal2 | double을, 그렇지 않으면 signal1을 반환합니다.

다음은 지원되는 순위 표현식 유형을 사용하는 순위 공식의 몇 가지 예시입니다.

  • 0.2 * semanticSimilarityScore + 0.8 * log(keywordSimilarityScore) -- 주로 keywordSimilarityScore의 로그별로 순위를 지정하며 semantic_smilarity_score가 약간 조정됩니다.
  • 0.2 * exp(fillNan(semanticSimilarityScore, 0)) + 0.3 * isNan(keywordSimilarityScore) -- semanticSimilarityScore 지수별로 순위를 지정합니다. NaN인 경우 값을 0으로 채우고 semanticSimilarityScore가 NaN인 경우 최종 점수에 상수 0.3 조정을 추가합니다.
  • 0.2 * rr(semanticSimilarityScore, 16) + 0.8 * rr(keywordSimilarityScore, 16) - semantic_smilarity_score의 상호 순위를 약간 조정한 keywordSimilarityScore의 상호 순위별로 대부분 순위를 지정합니다.

다음 신호가 지원됩니다.

  • semanticSimilarityScore: Google의 독점 모델에서 생성된 임베딩을 통해 계산된 시맨틱 유사성 조정입니다. 이 점수는 검색 쿼리가 문서와 의미상 유사한 정도를 나타냅니다.
  • keywordSimilarityScore: 키워드 일치 조정은 Best Match 25(BM25) 순위 함수를 사용합니다. 이 점수는 확률 모델을 사용하여 문서가 특정 쿼리와 관련이 있을 확률을 추정함으로써 계산됩니다.
  • relevanceScore: 독점 Google 모델을 사용하여 문서의 콘텐츠와 관련하여 사용자 질문의 의미와 의도를 파악하는 의미론적 관련성 조정입니다.
  • pctrRank: 순위로 사용되는 예상 전환율 조정은 예상 클릭률(pCTR)을 사용하여 사용자 관점에서 검색 결과의 관련성과 매력도를 측정합니다. pCTR이 높을수록 결과에서 사용자의 질문과 의도를 충족할 가능성이 높으므로 순위 지정에 유용한 신호가 됩니다.
  • freshnessRank: 순위로 표시되는 최신 상태 조정
  • documentAge: 문서가 마지막으로 업데이트된 후 경과된 시간(단위: 시간)으로, 부동 소수점 숫자입니다(예: 0.25는 15분을 의미함).
  • topicalityRank: 순위로 표시되는 주제 관련성 조정입니다. 독점 Google 모델을 사용하여 쿼리와 문서 간의 키워드 기반 중복을 확인합니다.
  • baseRank: 결과의 기본 순위입니다.
  • mediaActorMatch: 미디어 행위자가 쿼리와 일치하는지 여부
  • mediaDirectorMatch: 미디어 디렉터가 쿼리와 일치하는지 여부
  • mediaGenreMatch: 미디어 장르가 질문과 일치하는지 여부
  • mediaLanguageMatch: 미디어 언어가 쿼리와 일치하는지 여부
  • mediaTitleMatch: 미디어 제목이 쿼리와 일치하는지 여부
  • mediaPrefixSimilarityRank: 미디어 결과의 접두사 유사성 순위
  • mediaSemanticSimilarityRank: 미디어 결과의 의미 유사성 순위
rankingExpressionBackend

enum (RankingExpressionBackend)

선택사항입니다. 순위 표현식 평가에 사용할 백엔드입니다.
userLabels

map (key: string, value: string)

리소스에 적용된 사용자 라벨은 다음 요구사항을 충족해야 합니다.

  • 각 리소스는 여러 개의 라벨(최대 64개)을 가질 수 있습니다.
  • 각 라벨은 키-값 쌍이어야 합니다.
  • 키를 비워 둘 수 없으며 최소 길이는 1자(영문 기준)이고 최대 길이는 63자(영문 기준)입니다. 값을 비워 둘 수 있으며 최대 길이는 63자(영문 기준)입니다.
  • 키와 값에는 소문자, 숫자, 밑줄, 대시만 사용할 수 있습니다. 모든 문자는 UTF-8 인코딩을 사용해야 하며 국제 문자가 허용됩니다.
  • 라벨의 키 부분은 고유해야 합니다. 그러나 리소스 여러 개에 같은 키를 사용할 수 있습니다.
  • 키는 소문자나 국제 문자로 시작해야 합니다.

자세한 내용은 Google Cloud 문서를 참조하세요.
naturalLanguageQueryUnderstandingSpec

object (NaturalLanguageQueryUnderstandingSpec)

선택사항. 쿼리에서 정형 필드 필터 추출과 같은 자연어 쿼리 이해 기능의 구성입니다. 자세한 내용은 이 문서를 참조하세요. naturalLanguageQueryUnderstandingSpec이 지정되지 않으면 추가 자연어 쿼리 이해가 수행되지 않습니다.
searchAsYouTypeSpec

object (SearchAsYouTypeSpec)

입력 시 검색 구성입니다. IndustryVertical.MEDIA 카테고리에서만 지원됩니다.
customFineTuningSpec

object (CustomFineTuningSpec)

맞춤 미세 조정 구성입니다. 설정된 경우 ServingConfig.custom_fine_tuning_spec에 설정된 구성보다 우선순위가 높습니다.
displaySpec

object (DisplaySpec)

선택사항입니다. 검색 결과의 일치 항목 강조 표시와 같은 표시 기능의 구성입니다.
crowdingSpecs[]

object (CrowdingSpec)

선택사항입니다. 결과 다양성을 개선하기 위한 크라우딩 사양입니다. 여러 CrowdingSpec이 지정된 경우 field 값의 각 고유 조합에 대해 혼잡도가 평가되며 maxCount는 모든 CrowdingSpec에서 maxCount의 최댓값이 됩니다. 예를 들어 첫 번째 CrowdingSpec의 field = 'color', maxCount = 3이고 두 번째 CrowdingSpec의 field = 'size', maxCount = 2인 경우 동일한 색상과 크기를 공유하는 문서 3개가 반환된 후에는 후속 문서를 삭제하거나 강등해야 합니다.
session

string

세션 리소스 이름입니다. 선택사항.

세션을 사용하면 사용자가 멀티턴/검색 API 호출을 수행하거나 /검색 API 호출과 /답변 API 호출 간에 조정을 수행할 수 있습니다.

예시 1(멀티턴/검색 API 호출): 첫 번째 호출에서 생성된 세션 ID로 /검색 API를 호출합니다. 여기서는 이전 검색어가 쿼리 순위에 고려됩니다. 즉, 첫 번째 질문이 '2022년 Alphabet의 실적은 어땠어?'이고 현재 질문이 '2023년은 어때?'인 경우 현재 질문은 '2023년 Alphabet의 실적은 어땠어?'로 해석됩니다.

예시 2(/검색 API 호출과 /답변 API 호출 간에 조정): 첫 번째 호출에서 생성된 세션 ID로 /답변 API를 호출합니다. 여기서는 첫 번째 검색 호출의 검색 결과 컨텍스트에서 답변이 생성됩니다.
sessionSpec

object (SessionSpec)

세션 사양입니다.

session이 설정된 경우에만 사용할 수 있습니다.
relevanceThreshold

enum (RelevanceThreshold)

검색 결과의 전역 관련성 기준점입니다.

정밀도와 재현율의 균형을 활용하여 매우 정확한 결과와 관련 정보의 포괄적인 범위를 제공하는 Google 정의 기준점을 기본값으로 사용합니다.

더 세부적인 관련성 필터링이 필요한 경우 relevanceFilterSpec를 대신 사용하세요.

의료 검색에는 이 기능이 지원되지 않습니다.
relevanceFilterSpec

object (RelevanceFilterSpec)

선택사항입니다. 세부 관련성 필터링 사양입니다.

지정하지 않으면 모든 하위 검색에 전역 relevanceThreshold이 사용됩니다. 지정된 경우 이 설정은 전역 relevanceThreshold를 재정의하여 하위 검색별로 기준을 사용합니다.

이 기능은 현재 맞춤 검색 및 사이트 검색에만 지원됩니다.
personalizationSpec

object (PersonalizationSpec)

맞춤설정 사양입니다.

ServingConfig.personalization_spec 및 SearchRequest.personalization_spec이 모두 설정된 경우 SearchRequest.personalization_spec에서 ServingConfig.personalization_spec을 재정의합니다.
relevanceScoreSpec

object (RelevanceScoreSpec)

선택사항. 관련성 점수 반환 사양입니다.
searchAddonSpec

object (SearchAddonSpec)

선택사항. SearchAddonSpec은 새로운 가격 재산정 모델에 따라 검색 부가기능을 사용 중지하는 데 사용됩니다. 이 필드는 검색 요청에만 지원됩니다.
customRankingParams

object (CustomRankingParams)

선택사항입니다. 맞춤 순위 기능의 선택적 구성입니다.
entity

string

선택사항입니다. 여러 다른 법인, 도메인, 사이트 또는 지역을 운영할 수 있는 고객의 법인입니다(예: 'Google 미국', 'Google Ads', 'Waymo', 'google.com', 'youtube.com'). 이 값이 설정된 경우 법인별 검색 결과가 향상되도록 UserEvent.entity와 정확히 일치해야 합니다.

ImageQuery

이미지 쿼리 입력을 지정합니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "imageBytes": string
  // End of mutually exclusive fields.
}
필드
이미지 바이트를 지정합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
imageBytes

string

Base64로 인코딩된 이미지 바이트입니다. 지원되는 이미지 형식: JPEG, PNG, BMP.
상호 배타적 필드의 끝입니다.

FacetSpec

패싯 검색을 수행할 패싯 사양입니다.

JSON 표현 
{
  "facetKey": {
    object (FacetKey)
  },
  "limit": integer,
  "excludedFilterKeys": [
    string
  ],
  "enableDynamicPosition": boolean
}
필드
facetKey

object (FacetKey)

필수 항목입니다. 패싯 키 사양입니다.
limit

integer

이 패싯에 대해 반환되는 최대 패싯 값입니다. 지정하지 않으면 기본값은 20입니다. 허용되는 최댓값은 300입니다. 300을 초과하는 값은 300으로 변환됩니다. 의료 검색의 집계에서 [FacetKey.key] 가 'healthcare_aggregation_key'인 경우 여기에 설정된 값과 관계없이 한도가 내부적으로 10,000으로 재정의됩니다.

이 필드가 음수이면 INVALID_ARGUMENT가 반환됩니다.
excludedFilterKeys[]

string

패싯 생성 시 제외할 키 목록입니다.

기본적으로 FacetKey.key은 이 필드에 나열되지 않는 한 필터에서 제외되지 않습니다.

이 필드에 패싯 키를 나열하면 검색 결과에서 필터링된 경우에도 해당 값이 패싯 결과로 표시됩니다. 이 필드를 사용해도 반환되는 검색 결과에는 영향을 미치지 않습니다.

예를 들어 색상 패싯이 'Red'인 문서가 100개 있고 색상 패싯이 'Blue'인 문서가 200개 있다고 가정해 보겠습니다. 'color:ANY("Red")' 필터가 포함되어 있고 'color'가 FacetKey.key인 쿼리는 기본적으로 검색 결과에서 'Red' 문서만 반환하고 'Red'를 개수 100의 유일한 색상 패싯으로 반환합니다. 파란색 문서도 있지만 '파란색'은 사용 가능한 패싯 값으로 표시되지 않습니다.

'color'가 'excludedFilterKeys'에 나열된 경우 이제 'color' 키가 필터에서 제외되므로 쿼리는 개수가 100인 'Red'와 개수가 200인 'Blue'를 모두 반환합니다. 이 필드는 검색 결과에 영향을 미치지 않으므로 검색 결과는 'Red' 문서만 반환하도록 올바르게 필터링됩니다.

값은 최대 100개까지 허용됩니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다.
enableDynamicPosition

boolean

이 측면에 대한 동적 위치 지정을 가능하게 합니다. true로 설정하면 응답의 모든 패싯 중에서 이 패싯의 위치가 자동으로 결정됩니다. 동적 패싯이 사용 설정된 경우 함께 정렬됩니다. 이 값을 false로 설정하면 응답에서 이 패싯의 위치는 요청에서의 위치와 동일하며, 동적 위치 지정이 활성화된 패싯 및 모든 동적 패싯보다 순위가 높습니다.

예를 들어 항상 대답에 평가 패싯이 반환되기를 원하지만 평가 패싯을 항상 상단에 표시할 필요는 없습니다. 이 경우 응답에서 평점 패싯의 위치가 자동으로 결정되도록 enableDynamicPosition을 true로 설정할 수 있습니다.

또 다른 예로 요청에 다음 패싯이 있다고 가정해 보겠습니다.

  • 'rating', enableDynamicPosition = true

  • 'price', enableDynamicPosition = false

  • 'brands', enableDynamicPosition = false

또한 동적 패싯이 사용 설정되어 있어 패싯 gender가 생성됩니다. 그런 다음 응답의 최종 상품 속성 순서는 API가 '성별' 및 '평점' 상품 속성을 정렬하는 방식에 따라 ("가격", "브랜드", "평점", "성별") 또는 ("가격", "브랜드", "성별", "평점")이 될 수 있습니다. 하지만 'price'와 'brands'는 enableDynamicPosition이 false이므로 항상 1위와 2위로 표시됩니다.

FacetKey

패싯을 계산하는 방법을 지정합니다.

JSON 표현 
{
  "key": string,
  "intervals": [
    {
      object (Interval)
    }
  ],
  "restrictedValues": [
    string
  ],
  "prefixes": [
    string
  ],
  "contains": [
    string
  ],
  "caseInsensitive": boolean,
  "orderBy": string
}
필드
key

string

필수 항목입니다. Document 객체에서 지원되는 텍스트 및 숫자 패싯 키로, 이 키를 기준으로 패싯 값이 계산됩니다. 패싯 키는 대소문자를 구분합니다.
intervals[]

object (Interval)

값을 간격으로 버킷팅해야 하는 경우에만 설정합니다. 숫자 값이 있는 패싯에 설정해야 합니다. 텍스트 값이 있는 패싯에 설정하면 안 됩니다. 최대 간격 수는 30입니다.
restrictedValues[]

string

지정된 제한된 값에 대한 패싯만 가져옵니다. 텍스트 필드에서만 지원됩니다. 예를 들어 'category'에 'Action > 2022', 'Action > 2021', 'Sci-Fi > 2022'라는 세 가지 값이 있다고 가정해 보겠습니다. 'restrictedValues'를 'Action > 2022'로 설정하면 'category' 패싯에는 'Action > 2022'만 포함됩니다. 텍스트 필드에서만 지원됩니다. 최댓값은 10입니다.
prefixes[]

string

지정된 문자열 프리픽스로 시작하는 패싯 값만 가져옵니다. 예를 들어 'category'에 'Action > 2022', 'Action > 2021', 'Sci-Fi > 2022'라는 세 가지 값이 있다고 가정해 보겠습니다. "접두사"를 "액션"으로 설정하면 "카테고리" 패싯에는 "액션 > 2022"와 "액션 > 2021"만 포함됩니다. 텍스트 필드에서만 지원됩니다. 최댓값은 10입니다.
contains[]

string

지정된 문자열이 포함된 패싯 값만 가져옵니다. 예를 들어 'category'에 'Action > 2022', 'Action > 2021', 'Sci-Fi > 2022'라는 세 가지 값이 있다고 가정해 보겠습니다. 'contains'를 '2022'로 설정하면 'category' 패싯에는 'Action > 2022' 및 'Sci-Fi > 2022'만 포함됩니다. 텍스트 필드에서만 지원됩니다. 최댓값은 10입니다.
caseInsensitive

boolean

접두사 또는 포함 관계를 사용하여 패싯 값을 가져올 때 패싯 키의 대소문자를 구분하지 않으려면 true로 설정하고, 그렇지 않으면 false로 설정합니다.
orderBy

string

문서가 반환되는 순서입니다.

허용되는 값은 다음과 같습니다.

설정하지 않으면 텍스트 값은 일반적인 순서로 정렬되고, 숫자 간격은 FacetSpec.FacetKey.intervals에 의해 지정된 순서로 정렬됩니다.

간격

부동 소수점 간격입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "minimum": number,
  "exclusiveMinimum": number
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "maximum": number,
  "exclusiveMaximum": number
  // End of mutually exclusive fields.
}
필드

간격의 하한입니다. min 필드가 모두 설정되지 않은 경우 하한값은 음수의 무한대입니다.

이 필드는 최대값을 초과할 수 없습니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
minimum

number

하한값을 포함합니다.
exclusiveMinimum

number

하한값을 제외합니다.
상호 배타적 필드의 끝입니다.

간격의 상한입니다. max 필드가 모두 설정되지 않은 경우 상한값은 양수의 무한대입니다.

이 필드 값은 최소값보다 작아서는 안 됩니다. 그렇지 않으면 INVALID_ARGUMENT 오류가 반환됩니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
maximum

number

상한값을 포함합니다.
exclusiveMaximum

number

상한값을 제외합니다.
상호 배타적 필드의 끝입니다.

QueryExpansionSpec

쿼리 확장이 수행되는 조건을 결정하는 사양입니다.

JSON 표현 
{
  "condition": enum (Condition),
  "pinUnexpandedResults": boolean
}
필드
condition

enum (Condition)

쿼리 확장이 수행되는 조건입니다. 기본값은 Condition.DISABLED입니다.
pinUnexpandedResults

boolean

펼쳐지지 않은 결과를 고정할지 여부입니다. 이 필드를 true로 설정하면 비확장 제품이 항상 검색 결과 상단에 표시되고 그 아래에 확장된 결과가 표시됩니다.

조건

쿼리 확장이 수행되는 조건을 설명하는 열거형입니다.

열거형
CONDITION_UNSPECIFIED 지정되지 않은 검색어 확장 조건입니다. 이 경우 서버 동작은 기본적으로 Condition.DISABLED로 설정됩니다.
DISABLED 검색어 확장이 사용 중지되었습니다. SearchResponse.total_size가 0이더라도 정확한 검색어만 사용됩니다.
AUTO Search API에서 빌드한 자동 검색어 확장입니다.

SpellCorrectionSpec

쿼리 맞춤법 수정 사양입니다.

JSON 표현 
{
  "mode": enum (Mode)
}
필드
mode

enum (Mode)

맞춤법 교정으로 원래 검색어를 대체하는 모드입니다. 기본값은 Mode.AUTO입니다.

모드

맞춤법 교정이 어떤 모드로 이루어져야 하는지를 설명하는 열거형입니다.

열거형
MODE_UNSPECIFIED 지정되지 않은 맞춤법 교정 모드입니다. 이 경우 서버 동작은 기본적으로 Mode.AUTO로 설정됩니다.
SUGGESTION_ONLY Search API는 맞춤법 제안을 찾으려고 시도합니다. 제안이 발견되면 SearchResponse.corrected_query에 추가됩니다. 맞춤법 제안은 검색어로 사용되지 않습니다.
AUTO Search API에서 빌드한 자동 맞춤법 수정입니다. 수정된 쿼리가 있는 경우 해당 쿼리를 기반으로 검색이 진행됩니다.

EmbeddingSpec

이 사양은 사용자 정의 쿼리 임베딩 벡터를 사용하여 의미론적 문서 검색을 수행합니다.

JSON 표현 
{
  "embeddingVectors": [
    {
      object (EmbeddingVector)
    }
  ]
}
필드
embeddingVectors[]

object (EmbeddingVector)

검색에 사용되는 임베딩 벡터. 1로 제한

EmbeddingVector

임베딩 벡터.

JSON 표현 
{
  "fieldPath": string,
  "vector": [
    number
  ]
}
필드
fieldPath

string

스키마에 필드 경로 포함.
vector[]

number

임베딩 벡터를 쿼리합니다.

RankingExpressionBackend

순위 표현식 평가에 사용할 백엔드입니다.

열거형
RANKING_EXPRESSION_BACKEND_UNSPECIFIED 지정되지 않은/알 수 없는 값의 기본 옵션입니다.
BYOE

지원 중단됨: 대신 RANK_BY_EMBEDDING을 사용하세요. 맞춤 임베딩 모델을 사용한 순위 지정으로, 순위 표현식을 평가하는 기본 방식입니다. 기존 열거형 옵션입니다. 대신 RANK_BY_EMBEDDING를 사용해야 합니다.
CLEARBOX

지원 중단됨: 대신 RANK_BY_FORMULA을 사용하세요. 맞춤 수식으로 순위를 지정합니다. 기존 열거형 옵션입니다. 대신 RANK_BY_FORMULA를 사용해야 합니다.
RANK_BY_EMBEDDING 맞춤 임베딩 모델을 사용한 순위 지정으로, 순위 표현식을 평가하는 기본 방식입니다.
RANK_BY_FORMULA 맞춤 수식으로 순위를 지정합니다.

NaturalLanguageQueryUnderstandingSpec

검색 요청에 자연어 이해 기능을 사용 설정하기 위한 사양입니다.

JSON 표현 
{
  "filterExtractionCondition": enum (FilterExtractionCondition),
  "geoSearchQueryDetectionFieldNames": [
    string
  ],
  "extractedFilterBehavior": enum (ExtractedFilterBehavior),
  "allowedFieldNames": [
    string
  ]
}
필드
filterExtractionCondition

enum (FilterExtractionCondition)

필터 추출이 수행되는 조건입니다. 서버 동작은 기본적으로 DISABLED로 설정됩니다.
geoSearchQueryDetectionFieldNames[]

string

자연어 검색 쿼리에서 위치정보 필터가 감지되는 경우 위치 기반 필터링에 사용되는 필드 이름입니다. FilterExtractionCondition이 ENABLED로 설정된 경우에만 유효합니다.
extractedFilterBehavior

enum (ExtractedFilterBehavior)

선택사항입니다. 추출된 필터가 검색에 적용되는 방식을 제어합니다. 기본 동작은 요청에 따라 달라집니다. 단일 데이터 스토어 구조화된 검색의 경우 기본값은 HARD_FILTER입니다. 다중 데이터 스토어 검색의 경우 기본 동작은 SOFT_BOOST입니다. 위치 기반 필터는 항상 하드 필터로 적용되며 SOFT_BOOST 설정은 이러한 필터에 영향을 미치지 않습니다. 이 필드는 SearchRequest.NaturalLanguageQueryUnderstandingSpec.FilterExtractionCondition이 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 추출된 모든 필터를 소프트 부스트로 적용합니다. 필터를 통과한 결과는 결과 세트에서 더 높은 순위로 올라갑니다.

SearchAsYouTypeSpec

검색 요청에서 입력 시 검색 사양입니다.

JSON 표현 
{
  "condition": enum (Condition)
}
필드
condition

enum (Condition)

실시간 검색이 수행되는 조건입니다. 기본값은 Condition.DISABLED입니다.

조건

입력 시 검색이 수행되는 조건을 설명하는 열거형입니다.

열거형
CONDITION_UNSPECIFIED 서버 동작은 기본적으로 Condition.DISABLED로 설정됩니다.
DISABLED 입력 중 검색 기능을 비활성화합니다.
ENABLED 입력과 동시에 검색을 사용 설정합니다.
AUTO 입력과 동시에 검색 모드와 일반 검색 모드 간 자동 전환으로, 단일 API 구현 (예: 디바운싱)에 적합합니다.

DisplaySpec

경기 하이라이트 표시와 같은 표시 기능을 지정합니다.

JSON 표현 
{
  "matchHighlightingCondition": enum (MatchHighlightingCondition)
}
필드
matchHighlightingCondition

enum (MatchHighlightingCondition)

일치 항목 강조 표시가 수행되는 조건입니다.

MatchHighlightingCondition

일치 항목 강조 표시가 발생해야 하는 조건을 설명하는 열거형입니다.

열거형
MATCH_HIGHLIGHTING_CONDITION_UNSPECIFIED 서버 동작은 MATCH_HIGHLIGHTING_DISABLED과 동일합니다.
MATCH_HIGHLIGHTING_DISABLED 모든 문서에서 일치 항목 강조 표시를 비활성화합니다.
MATCH_HIGHLIGHTING_ENABLED 모든 문서에서 일치 항목 강조 표시를 사용 설정합니다.

CrowdingSpec

혼잡도에 대한 사양. 검색 결과의 다양성을 높이기 위해, 동일한 필드 값을 공유하는 결과의 수를 제한하는 크라우딩(Crowding) 기법이 사용됩니다. 예를 들어 maxCount가 3이고 모드가 DROP_CROWDED_RESULTS인 색상 필드의 크라우딩은 모든 페이지에서 동일한 색상의 결과를 최대 3개 반환합니다.

JSON 표현 
{
  "field": string,
  "maxCount": integer,
  "mode": enum (Mode)
}
필드
field

string

혼잡도에 사용할 필드입니다. 문서는 Document 객체의 필드별로 정렬될 수 있습니다. 혼잡도 필드는 대소문자를 구분합니다.
maxCount

integer

해당 필드 값별로 보관할 최대 문서 수입니다. orderBy에 지정된 순서에 따라 지정된 필드의 값이 동일한 이전 결과가 maxCount개 이상 있으면 값이 동일한 후속 결과는 '밀려납니다'. 지정하지 않으면 기본값은 1입니다.
mode

enum (Mode)

문서가 빽빽하게 쌓여 있을 때 사용하는 모드입니다.

모드

문서가 밀집되어 있는 경우 사용할 모드를 설명하는 열거형입니다. 삭제되거나 뒷 페이지로 밀려날 수 있습니다.

열거형
MODE_UNSPECIFIED 지정되지 않은 혼잡 모드입니다. 이 경우 서버 동작은 기본적으로 Mode.DROP_CROWDED_RESULTS로 설정됩니다.
DROP_CROWDED_RESULTS 검색 결과가 너무 많으면 제외하세요.
DEMOTE_CROWDED_RESULTS_TO_END 혼잡한 결과를 뒷페이지로 강등합니다.

SessionSpec

세션 사양입니다.

JSON 표현 
{
  "queryId": string,
  "searchResultPersistenceCount": integer
}
필드
queryId

string

설정된 경우 검색 결과는 이 질문 ID로 지정된 '턴'에 저장됩니다.

예를 들어 세션이 다음과 같다고 가정해 보겠습니다. session { name: ".../sessions/xxx" turns { query { text: "What is foo?" queryId: ".../questions/yyy" } answer: "Foo is ..." } turns { query { text: "How about bar then?" queryId: ".../questions/zzz" } } }

사용자는 다음과 같은 요청으로 /search API를 호출할 수 있습니다.

session: ".../sessions/xxx" sessionSpec { queryId: ".../questions/zzz" }

그런 다음 API는 마지막 턴과 연결된 검색 결과를 저장합니다. 저장된 검색 결과는 세션 ID와 질문 ID가 지정된 후속 /answer API 호출에서 사용될 수 있습니다. 또한 같은 세션 ID 및 질문 ID로 /search와 /answer를 동시에 호출할 수 있습니다.
searchResultPersistenceCount

integer

유지할 상위 검색 결과 수입니다. 유지되는 검색 결과는 후속 /answer API 호출에 사용될 수 있습니다.

이 필드는 SearchRequest.ContentSearchSpec.SummarySpec.summary_result_count의 summaryResultCount 필드와 유사합니다.

결과는 문서 모드의 경우 최대 10개, 청크 모드의 경우 최대 50개까지 표시됩니다.

RelevanceThreshold

검색 결과의 관련성 기준점입니다. 관련성 기준이 높을수록 더 관련성 있는 결과가 표시되고 반환되는 결과 수는 줄어듭니다.

열거형
RELEVANCE_THRESHOLD_UNSPECIFIED 기본값 이 경우 서버 동작은 Google에서 정의한 임계값을 기본값으로 사용합니다.
LOWEST 관련성 기준이 가장 낮습니다.
LOW 관련성 기준이 낮습니다.
MEDIUM 관련성 기준이 보통입니다.
HIGH 관련성 기준이 높습니다.

RelevanceFilterSpec

관련성 필터링 사양.

JSON 표현 
{
  "keywordSearchThreshold": {
    object (RelevanceThresholdSpec)
  },
  "semanticSearchThreshold": {
    object (RelevanceThresholdSpec)
  }
}
필드
keywordSearchThreshold

object (RelevanceThresholdSpec)

선택사항입니다. 키워드 검색에 대한 관련성 필터링 임계값 설정.
semanticSearchThreshold

object (RelevanceThresholdSpec)

선택사항입니다. 시맨틱 검색의 관련성 필터링 기준점 사양입니다.

RelevanceThresholdSpec

특정 하위 검색의 관련성 필터링 사양입니다.

JSON 표현 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "relevanceThreshold": enum (RelevanceThreshold),
  "semanticRelevanceThreshold": number
  // End of mutually exclusive fields.
}
필드
관련성 임계값을 결정하는 방법을 구성합니다. 다음은 상호 배타적인 필드 목록입니다. 응답에는 다음 필드 중 최대 하나가 설정됩니다.
relevanceThreshold

enum (RelevanceThreshold)

하위 검색에 대한 사전 정의된 관련성 임계값.
semanticRelevanceThreshold

number

하위 검색에 대한 사용자 지정 관련성 임계값입니다. 값은 [0.0, 1.0] 범위 내에 있어야 합니다.
상호 배타적 필드의 끝입니다.

RelevanceScoreSpec

문서 관련성 점수 반환 사양입니다.

JSON 표현 
{
  "returnRelevanceScore": boolean
}
필드
returnRelevanceScore

boolean

선택사항입니다. 검색 결과의 관련성 점수를 반환할지 여부입니다. 점수가 높을수록 해당 문서가 질의에 더 관련성이 높다는 것을 의미합니다.

SearchAddonSpec

SearchAddonSpec은 새로운 가격 재산정 모델에 따라 검색 부가기능을 사용 중지하는 데 사용됩니다. 기본적으로 SearchAddonSpec이 지정되지 않은 경우 고객이 해당되는 모든 곳에서 이를 사용 설정하기를 원하는 것으로 간주합니다.

JSON 표현 
{
  "disableSemanticAddOn": boolean,
  "disableKpiPersonalizationAddOn": boolean,
  "disableGenerativeAnswerAddOn": boolean
}
필드
disableSemanticAddOn

boolean

선택사항입니다. true인 경우 시맨틱 부가기능이 사용 중지됩니다. 시맨틱 부가기능에는 임베딩과 Jetstream이 포함됩니다.
disableKpiPersonalizationAddOn

boolean

선택사항입니다. true인 경우 KPI를 최적화하고 결과를 개인화하기 위해 이벤트 재정렬 및 맞춤설정을 사용 중지합니다.
disableGenerativeAnswerAddOn

boolean

선택사항입니다. true인 경우 생성형 답변 부가기능이 사용 중지됩니다. 생성형 답변 부가기능에는 필터링 및 간단한 답변을 위한 자연어가 포함됩니다.

CustomRankingParams

맞춤 순위 기능의 구성 매개변수입니다.

JSON 표현 
{
  "expressionsToPrecompute": [
    string
  ]
}
필드
expressionsToPrecompute[]

string

선택사항입니다. 평가할 순위 표현식 목록입니다 (구문 문서는 rankingExpression 참고). 평가 결과는 SearchResponse.SearchResult.rank_signals.precomputed_expression_values 필드로 반환됩니다.

QuerySetSpec

쿼리 세트의 사양을 설명합니다.

JSON 표현 
{
  "sampleQuerySet": string
}
필드
sampleQuerySet

string

선택사항입니다. 평가에 사용된 SampleQuerySet의 전체 리소스 이름은 projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet} 형식입니다.

QualityMetrics

평가에서 생성된 측정항목을 설명합니다.

JSON 표현 
{
  "docRecall": {
    object (TopkMetrics)
  },
  "docPrecision": {
    object (TopkMetrics)
  },
  "docNdcg": {
    object (TopkMetrics)
  },
  "pageRecall": {
    object (TopkMetrics)
  },
  "pageNdcg": {
    object (TopkMetrics)
  }
}
필드
docRecall

object (TopkMetrics)

다양한 Top-K 컷오프 수준에서 문서당 재현율입니다.

재현율은 모든 관련 문서로부터 검색된 관련 문서의 비율입니다.

예 (상위 5개): * 단일 SampleQuery의 경우 상위 5개에서 5개의 관련 문서 중 3개가 검색되면 재현율@5 = 3/5 = 0.6
docPrecision

object (TopkMetrics)

다양한 Top-K 컷오프 수준에서 문서당 정밀도입니다.

정밀도는 관련성 있는 검색된 문서의 비율입니다.

예시 (상위 5개): * 단일 SampleQuery의 경우, 상위 5개 검색 문서 중 5개 중 4개가 관련성이 있다면, precision@5 = 4/5 = 0.8
docNdcg

object (TopkMetrics)

다양한 Top-K 컷오프 수준에서 문서당 정규화된 할인 누적 이득(NDCG)입니다.

NDCG는 순위 품질을 측정하고 최상위 결과에 높은 관련성을 부여합니다.

예 (상위 3개): 검색된 문서가 3개 (D1, D2, D3)이고 관련성 판단이 바이너리 (관련성 있는 경우 1, 관련성 없는 경우 0)인 경우 SampleQuery은 다음과 같습니다.

검색됨: [D3 (0), D1 (1), D2 (1)] 이상적: [D1 (1), D2 (1), D3 (0)]

각 SampleQuery의 NDCG@3을 계산합니다. * DCG@3: 0/log2(1+1) + 1/log2(2+1) + 1/log2(3+1) = 1.13 * 이상적인 DCG@3: 1/log2(1+1) + 1/log2(2+1) + 0/log2(3+1) = 1.63 * NDCG@3: 1.13/1.63 = 0.693
pageRecall

object (TopkMetrics)

다양한 Top-K 컷오프 수준에서 페이지당 재현율입니다.

재현율은 모든 관련 페이지 중에서 검색된 관련 페이지의 비율입니다.

예시 (상위 5개): * 단일 SampleQuery의 경우, 관련 페이지 5개 중 3개가 상위 5개에 포함되면 recall@5 = 3/5 = 0.6
pageNdcg

object (TopkMetrics)

다양한 Top-K 컷오프 수준에서 페이지당 정규화된 할인 누적 이득(NDCG)입니다

NDCG는 순위 품질을 측정하고 최상위 결과에 높은 관련성을 부여합니다.

예 (상위 3개): 검색된 페이지가 3개 (P1, P2, P3)이고 바이너리 관련성 판단 (관련성 있는 경우 1, 관련성 없는 경우 0)이 있는 SampleQuery를 가정해 보겠습니다.

가져온 항목: [P3 (0), P1 (1), P2 (1)] 이상적인 항목: [P1 (1), P2 (1), P3 (0)]

SampleQuery의 NDCG@3 계산: * DCG@3: 0/log2(1+1) + 1/log2(2+1) + 1/log2(3+1) = 1.13 * 이상적인 DCG@3: 1/log2(1+1) + 1/log2(2+1) + 0/log2(3+1) = 1.63 * NDCG@3: 1.13/1.63 = 0.693

TopkMetrics

특정 상위 k개 레벨의 메트릭 값을 저장합니다.

JSON 표현 
{
  "top1": number,
  "top3": number,
  "top5": number,
  "top10": number
}
필드
top1

number

상위 1개 값입니다.
top3

number

상위 3개 값입니다.
top5

number

상위 5개 값입니다.
top10

number

상위 10개 값입니다.

주

평가의 상태를 설명합니다.

열거형
STATE_UNSPECIFIED 평가가 지정되지 않았습니다.
PENDING 서비스가 평가 실행을 준비 중입니다.
RUNNING 평가가 진행 중입니다.
SUCCEEDED 평가가 성공적으로 완료되었습니다.
FAILED 평가가 실패했습니다.

메서드

create

 Evaluation를 만듭니다.

get

 Evaluation을 가져옵니다.

list

 Evaluation 목록을 가져옵니다.

listResults

 주어진 Evaluation에 대한 결과 목록을 가져옵니다.