REST Resource: projects.locations.dataStores.servingConfigs

string

不可變動。完整名稱 projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}

string

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

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

enum (SolutionType)

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

string

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

如果 SolutionType 為 SOLUTION_TYPE_RECOMMENDATION，則為必填屬性。

string

建議模型結果中要使用的多樣性程度，例如 medium-diversity 或 high-diversity。目前支援的值：

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

如未指定，我們會根據建議模型類型選擇預設值。預設值為 no-diversity。

只有在 SolutionType 為 SOLUTION_TYPE_RECOMMENDATION 時，才能設定。

object (EmbeddingConfig)

使用自有嵌入設定。這項設定用於搜尋語意檢索。檢索作業會根據 SearchRequest.EmbeddingSpec.EmbeddingVector.vector 的點積和這個 EmbeddingConfig 提供的文件嵌入項目進行。如果提供 SearchRequest.EmbeddingSpec.EmbeddingVector.vector，系統會覆寫這個 ServingConfig.embedding_config。

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)。

object (GuidedSearchSpec)

引導式搜尋設定。

object (CustomFineTuningSpec)

自訂微調設定。如果已設定 SearchRequest.custom_fine_tuning_spec，該設定的優先順序會高於此處設定的配置。

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"。

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"。

string

在放送路徑中使用的篩選器控制項。系統會套用所有觸發的篩選器控制項。篩選器控制項必須與服務設定位於同一個資料存放區。最多 20 個篩選器控制項。

string

在放送路徑中使用的升幅控制項。系統會套用所有觸發的升級控制選項。提升控制項必須與服務設定位於相同的資料存放區。最多可設定 20 個提高排名控制項。

string

重新導向控制項的 ID。即使有多個適用，系統也只會套用第一個觸發的重新導向動作。最多只能有 100 項規格。

只有在 SolutionType 為 SOLUTION_TYPE_SEARCH 時，才能設定。

string

條件同義詞規格。如果符合多個同義字條件，系統會執行清單中所有相符的同義字控制項。最多只能有 100 項規格。

只有在 SolutionType 為 SOLUTION_TYPE_SEARCH 時，才能設定。

string

單向同義詞的條件規格。如果符合多個單向同義字條件，系統會執行清單中所有相符的單向同義字控制選項。最多只能有 100 項規格。

只有在 SolutionType 為 SOLUTION_TYPE_SEARCH 時，才能設定。

string

條件不會關聯規格。如果多個不關聯條件相符，系統會執行清單中所有相符的不關聯控制選項。順序沒有影響。最多只能有 100 項規格。

只有在 SolutionType 為 SOLUTION_TYPE_SEARCH 時，才能設定。

string

條件更換規格。系統會依清單中的順序套用規則。先前取代的字詞無法再次取代。最多只能有 100 項規格。

只有在 SolutionType 為 SOLUTION_TYPE_SEARCH 時，才能設定。

string

忽略條件規格。如果符合多個忽略條件，系統會執行清單中所有相符的忽略控制項。順序沒有影響。最多只能有 100 項規格。

string

條件促銷規格。

最多只能有 100 項規格。

object (PersonalizationSpec)

個人化規格的規格。

請注意，如果同時設定 ServingConfig.personalization_spec 和 SearchRequest.personalization_spec，SearchRequest.personalization_spec 會覆寫 ServingConfig.personalization_spec。

object (AnswerGenerationSpec)

(選用步驟) 生成答案的規格。

object (MediaConfig)

供應設定的 MediaConfig。

object (GenericConfig)

供應設定的 GenericConfig。