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 で使用されます。

このフィールドは、長さの上限が 128 文字の UTF-8 でエンコードされた文字列にする必要があります。それ以外の場合は、INVALID_ARGUMENT エラーが返されます。
solutionType

enum (SolutionType)

必須。変更不可。サービス構成を関連付けることができるソリューション タイプを指定します。
modelId

string

サービス提供時に使用するモデルの ID。現在サポートされているのは RecommendationModels のみです。変更できますが、互換性のあるモデル（関連商品のおすすめのクリック率から関連商品のおすすめのコンバージョン率など）にのみ変更できます。

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)

出力専用。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"。
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

 この dataStore にリンクされているすべての ServingConfig を一覧表示します。

patch

 ServingConfig を更新します。

recommend

 コンテキスト ユーザー イベントを必要とするレコメンデーションを作成します。
検索を実行します。

searchLite

 検索を実行します。

streamAnswer

 クエリへの回答を生成するメソッド（ストリーミング）。