自定义 Cortex Search Scoring¶

数字提升和时间衰减¶

您可以根据数值或时间戳元数据来对搜索结果应用提升或衰减。如果每个结果都有结构化元数据（例如流行度或时效性信号），而这有助于确定查询时文档的相关性，则此功能非常有用。在执行查询时，您可以指定两类排名信号：

提升和衰减元数据来自创建 Cortex Search Service 的源表中的列。在发出查询时需要指定用于加权或衰减的元数据列，但这些列必须在创建 Cortex Search Service 时包含进去。

查询 Cortex Search Service 时，在 scoring_config.functions 字段的可选 numeric_boosts 和 time_decays 字段中指定用于提升或衰减的列。您还可以指定每次提升或衰减的权重。

{
  "scoring_config": {
    "functions": {
      "numeric_boosts": [
        {
          "column": "column_name",
          "weight": 1
        },
        /* ... */
      ],
      "time_decays": [
        {
          "column": "column_name",
          "weight": 1,
          "limit_hours": 120
        },
        /* ... */
      ]
    }
  }
}

重新排名¶

默认情况下，对 Cortex Search Service 的查询利用 语义重新排名 来提高搜索结果的相关性。虽然重新排名可以显著提高结果相关性，但也会明显增加查询延迟。如果在您的业务用例中，您发现可以牺牲重新排名提供的质量优势，以换取更快的查询速度，则可以在任何 Cortex Search 查询中禁用重新排名。

在查询时，您可以在 scoring_config.reranker 字段中按照以下格式为单个查询禁用重新排名工具：

{
  "scoring_config": {
      "reranker": "none"
  }
}

组件权重¶

通过 scoring_config 对象中的 weights 字段，您可以在每个结果的总分中指定各个评分组件（vectors、texts、reranker）的权重。默认情况下，每个组件的权重设置为 1.0，对总分的贡献相等。

您可以按以下格式指定权重：

{
  "scoring_config": {
    "functions": {
      "weights": {
        "texts": 3,
        "vectors": 2,
        "reranker": 1
      }
    }
  }
}

{
  "scoring_config": {
    "functions": {
      "weights": {
        "texts": 3,
        "vectors": 1,
        "reranker": 2
      }
    }
  }
}

命名评分配置文件¶

提升/衰减和重新排序器设置共同形成一个 评分配置，在查询时可通过 scoring_config 参数指定。评分配置可以命名并附加到 Cortex Search Service。

使用命名评分配置文件，您可以轻松在不同应用程序和查询中使用同一评分配置，而无需每次都指定完整配置。如果您修改评分配置，只需在一个地方更新，而不必在每个查询中修改。

要向您的 Cortex Search Service 添加评分配置文件，请使用 ALTER CORTEX SEARCH SERVICE ... ADD SCORING PROFILE 命令，如下例所示：

ALTER CORTEX SEARCH SERVICE my_search_service
  ADD SCORING PROFILE heavy_comments_with_likes IF NOT EXISTS
  '{
    "functions": {
            "numeric_boosts": [
                { "column": "comments", "weight": 6 },
                { "column": "likes", "weight": 1 }
            ]
    }
  }'

评分配置文件的定义语法与查询时 scoring_config 参数使用的架构相同。

评分配置文件创建后无法修改；要更改配置文件，请将其删除并使用新的评分配置重新创建。要删除命名评分配置文件，请使用 ALTER CORTEX SEARCH SERVICE ... DROP SCORING PROFILE。

要使用命名评分配置文件查询 Cortex Search Service，请在查询时在 scoring_profile 参数中指定配置文件名称，如下例所示：

results = svc.search(
    query="technology",
    columns=["comments", "likes"],
    scoring_profile="heavy_comments_with_likes",
    limit=10
)

curl --location https://<account_url>/api/v2/databases/<db_name>/schemas/<schema_name>/cortex-search-services/<service_name>:query \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header "Authorization: Bearer $PAT" \
--data '{
  "query": "technology",
  "columns": ["DOCUMENT_CONTENTS", "LIKES", "COMMENTS"],
  "scoring_profile": "heavy_comments_with_likes",
  "limit": 10
}'

SELECT SNOWFLAKE.CORTEX.SEARCH_PREVIEW(
  'my_search_service',
  '{
    "query": "technology",
    "columns": ["comments", "likes"],
    "scoring_profile": "heavy_comments_with_likes",
    "limit": 10
  }'
);

要查看服务存储的评分配置文件，请查询 INFORMATION_SCHEMA 架构中的 CORTEX_SEARCH_SERVICE_SCORING_PROFILES 视图，如下例所示：

SELECT *
  FROM my_db.INFORMATION_SCHEMA.CORTEX_SEARCH_SERVICE_SCORING_PROFILES
  WHERE service_name = 'my_search_service';

组件分数¶

组件分数为搜索结果提供详细的评分信息。它们可帮助开发者了解搜索排名如何确定，并调试搜索性能。每个结果的分数在每个检索“组件”（文本、向量）的 @scores 字段中返回。组件分数在以下场景中非常有用：

• 建立阈值： 使用组件分数判断何时将结果传递给下游流程，例如代理。

• 调试搜索排名： 了解为什么某些文档在搜索结果中的排名高于其他文档。

{
  "results": [
    {
      "@scores": {
        "cosine_similarity": <cosine_similarity_score>,
        "text_match": <text_match_score>
      }
    }
  ]
}