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

必須。人が読める形式のサービス構成の表示名。Discovery UI で使用されます。

このフィールドは、長さの上限が 128 文字の UTF-8 でエンコードされた文字列にする必要があります。それ以外の場合は、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)

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

 クエリへの回答を生成するメソッド。

get

 ServingConfig を取得します。

list

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

patch

 ServingConfig を更新します。

recommend

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

searchLite

 検索を実行します。

streamAnswer

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