REST Resource: projects.locations.dataStores.servingConfigs

리소스: ServingConfig

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

JSON 표현 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "embeddingConfig": {
    object (EmbeddingConfig)
  },
  "rankingExpression": string,
  "guidedSearchSpec": {
    object (GuidedSearchSpec)
  },
  "customFineTuningSpec": {
    object (CustomFineTuningSpec)
  },
  "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)
  },

  // Union field vertical_config can be only one of the following:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of list of possible types for union field vertical_config.
}
필드
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)일 수 있습니다.
guidedSearchSpec

object (GuidedSearchSpec)

가이드 검색 구성입니다.
customFineTuningSpec

object (CustomFineTuningSpec)

맞춤 미세 조정 구성입니다. SearchRequest.custom_fine_tuning_spec이 설정된 경우 여기에 설정된 구성보다 우선순위가 높습니다.
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)

(선택사항) 답변 생성 사양입니다.
통합 필드 vertical_config. 업종 카테고리별 구성입니다. vertical_config는 다음 중 하나여야 합니다.
mediaConfig

object (MediaConfig)

제공 구성의 MediaConfig입니다.
genericConfig

object (GenericConfig)

제공 구성의 GenericConfig입니다.

메서드

answer

 답변 쿼리 메서드입니다.

create

 ServingConfig를 만듭니다.

delete

 ServingConfig를 삭제합니다.

get

 ServingConfig를 가져옵니다.

list

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

patch

 ServingConfig를 업데이트합니다.

recommend

 추천을 생성하며, 이를 위해서는 컨텍스트 기반 사용자 이벤트가 필요합니다.
검색을 수행합니다.

searchLite

 검색을 수행합니다.

streamAnswer

 쿼리 답변 메서드(스트리밍).