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)
  },

  // 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)。
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 查詢方法。

get

 取得 ServingConfig。

list

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

patch

 更新 ServingConfig。

recommend

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

searchLite

 執行搜尋。

streamAnswer

 Answer query method (streaming)。