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 规范化（即转换为 UTC 零时区格式并在末尾附加 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 规范化（即转换为 UTC 零时区格式并在末尾附加 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

 列出与相应数据存储区关联的所有 ServingConfig。

patch

 更新 ServingConfig。

recommend

 进行推荐，这需要情境用户事件。
执行搜索。

searchLite

 执行搜索。

streamAnswer

 回答查询方法（流式）。