REST Resource: projects.locations.collections.engines.servingConfigs

리소스: ServingConfig

서빙 시간 결과(예: 검색 결과 또는 추천 예측)를 생성하는 데 사용되는 메타데이터를 구성합니다. ServingConfig는 검색 및 예측 요청에 전달되어 결과를 생성합니다.

JSON 표현 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "embeddingConfig": {
    object (EmbeddingConfig)
  },
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "personalizationSpec": {
    object (PersonalizationSpec)
  },
  "answerGenerationSpec": {
    object (AnswerGenerationSpec)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of mutually exclusive fields.
}
필드
name

string

변경할 수 없습니다. 정규화된 이름 projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

필수 항목. 인간이 읽을 수 있는 서빙 구성 표시 이름입니다. Discovery UI에서 사용됩니다.

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

enum (SolutionType)

필수 항목. 변경할 수 없습니다. 서빙 구성이 연결될 수 있는 솔루션 유형을 지정합니다.
modelId

string

서빙 시 사용할 모델의 ID입니다. 현재는 RecommendationModel만 지원됩니다. 변경할 수 있지만 호환되는 모델로만 변경할 수 있습니다(예: 내가 좋아할 만한 기타 항목 CTR을 내가 좋아할 만한 기타 항목 CVR로).

SolutionType이 SOLUTION_TYPE_RECOMMENDATION일 경우 필수입니다.
diversityLevel

string

추천 모델 결과(예: medium-diversity 또는 high-diversity)에 사용할 다양성 정도입니다. 현재 지원되는 값은 다음과 같습니다.

  • no-diversity
  • low-diversity
  • medium-diversity
  • high-diversity
  • auto-diversity

지정하지 않으면 추천 모델 유형에 따라 기본값이 선택됩니다. 기본값은 no-diversity입니다.

SolutionType이 SOLUTION_TYPE_RECOMMENDATION인 경우에만 설정할 수 있습니다.
embeddingConfig

object (EmbeddingConfig)

자체 임베딩 구성을 가져옵니다. 이 구성은 검색 시맨틱 검색에 사용됩니다. 검색은 SearchRequest.EmbeddingSpec.EmbeddingVector.vector 및 이 EmbeddingConfig에서 제공하는 문서 임베딩의 내적을 기반으로 합니다. SearchRequest.EmbeddingSpec.EmbeddingVector.vector가 제공되면 이 ServingConfig.embedding_config가 재정의됩니다.
rankingExpression

string

순위 표현식은 검색 문서의 맞춤설정된 순위를 제어합니다. 이를 활용하려면 문서 임베딩이 필요합니다. ServingConfig의 순위 지정 표현식 설정은 서빙 구성에서 처리하는 모든 검색 요청에 적용됩니다. 하지만 SearchRequest.ranking_expression이 지정되면 ServingConfig 순위 표현식이 재정의됩니다.

순위 표현식은 '+'로 조인된 함수 하나 또는 여러 개입니다.

  • 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)일 수 있습니다.
createTime

string (Timestamp format)

출력 전용입니다. ServingConfig 생성 타임스탬프입니다.

생성된 출력은 항상 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"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. ServingConfig 업데이트 타임스탬프입니다.

생성된 출력은 항상 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"입니다.
filterControlIds[]

string

서빙 경로에서 사용할 필터 컨트롤입니다. 트리거된 모든 필터 컨트롤이 적용됩니다. 필터 컨트롤은 서빙 구성과 동일한 데이터 스토어에 있어야 합니다. 필터 컨트롤은 최대 20개 있습니다.
boostControlIds[]

string

서빙 경로에서 사용할 부스트 컨트롤입니다. 트리거된 모든 부스트 컨트롤이 적용됩니다. 부스트 컨트롤은 서빙 구성과 동일한 데이터 스토어에 있어야 합니다. 부스트 컨트롤은 최대 20개 있습니다.
redirectControlIds[]

string

리디렉션 컨트롤 ID입니다. 리디렉션이 여러 개 적용되더라도 첫 번째로 트리거된 리디렉션 작업만 적용됩니다. 최대 사양 수는 100개입니다.

SolutionType이 SOLUTION_TYPE_SEARCH인 경우에만 설정할 수 있습니다.
synonymsControlIds[]

string

조건 동의어 사양입니다. 동의어 조건 여러 개가 일치하는 경우 목록에 있는 일치하는 모든 동의어 컨트롤이 실행됩니다. 최대 사양 수는 100개입니다.

SolutionType이 SOLUTION_TYPE_SEARCH인 경우에만 설정할 수 있습니다.
onewaySynonymsControlIds[]

string

조건부 단방향 동의어 사양입니다. 단방향 동의어 조건 여러 개가 일치하면 목록에 있는 일치하는 모든 단방향 동의어 컨트롤이 실행됩니다. 최대 사양 수는 100개입니다.

SolutionType이 SOLUTION_TYPE_SEARCH인 경우에만 설정할 수 있습니다.
dissociateControlIds[]

string

조건이 사양과 연결되지 않습니다. 연결하지 않음 조건 여러 개가 일치하면 목록에 있는 일치하는 모든 연결하지 않음 컨트롤이 실행됩니다. 순서는 중요하지 않습니다. 최대 사양 수는 100개입니다.

SolutionType이 SOLUTION_TYPE_SEARCH인 경우에만 설정할 수 있습니다.
replacementControlIds[]

string

조건 대체 사양입니다. 목록의 순서에 따라 적용됩니다. 이전에 교체한 용어는 다시 교체될 수 없습니다. 최대 사양 수는 100개입니다.

SolutionType이 SOLUTION_TYPE_SEARCH인 경우에만 설정할 수 있습니다.
ignoreControlIds[]

string

조건 무시 사양입니다. 무시 조건 여러 개가 일치하면 목록에 있는 일치하는 모든 무시 컨트롤이 실행됩니다. 순서는 중요하지 않습니다. 최대 사양 수는 100개입니다.
promoteControlIds[]

string

조건부 승격 사양입니다.

최대 사양 수는 100개입니다.
personalizationSpec

object (PersonalizationSpec)

맞춤설정 사양의 사양입니다.

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

object (AnswerGenerationSpec)

선택사항. 답변 생성 사양입니다.
업종 카테고리별 구성입니다. 다음은 상호 배타적인 필드 목록입니다. 응답에서 필드가 최대 하나 설정됩니다.
mediaConfig

object (MediaConfig)

서빙 구성의 MediaConfig입니다.
genericConfig

object (GenericConfig)

서빙 구성의 GenericConfig입니다.
상호 배타적인 필드의 끝입니다.

메서드

answer

 답변 쿼리 메서드입니다.

create

 ServingConfig를 만듭니다.

delete

 ServingConfig를 삭제합니다.

get

 ServingConfig를 가져옵니다.

list

 이 dataStore에 연결된 모든 ServingConfig를 나열합니다.

patch

 ServingConfig를 업데이트합니다.

recommend

 상황별 사용자 이벤트가 필요한 추천을 만듭니다.
검색을 수행합니다.

searchLite

 검색을 수행합니다.

streamAnswer

 답변 질문 메서드(스트리밍)입니다.