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

這是必要旗標，使用者可理解的供應設定顯示名稱。用於探索使用者介面。

這個欄位必須是 UTF-8 編碼的字串，長度上限為 128 個字元。否則會傳回 INVALID_ARGUMENT 錯誤。
solutionType

enum (SolutionType)

這是必要旗標，不可變動。指定供應設定可關聯的解決方案類型。
modelId

string

在放送時使用的模型 ID。目前僅支援 RecommendationModel。可以變更，但只能變更為相容的模型 (例如「您可能喜歡的其他項目」點閱率模型變更為「您可能喜歡的其他項目」轉換率模型)。

如果 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 的時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「Z」以外的偏移量。範例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
updateTime

string (Timestamp format)

僅供輸出。供應設定更新時間戳記。

使用 RFC 3339，產生的輸出內容一律會經過 Z 正規化，並使用 0、3、6 或 9 個小數位數，也接受「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

 Answer 查詢方法。

create

 建立 ServingConfig。

delete

 刪除 ServingConfig。

get

 取得 ServingConfig。

list

 列出連結至這個資料儲存庫的所有 ServingConfig。

patch

 更新 ServingConfig。

recommend

 提供建議，這需要情境式使用者事件。
執行搜尋。

searchLite

 執行搜尋。

streamAnswer

 Answer query 方法 (串流)。