Elasticsearch KNN搜索功能提升语法报错求助：boosts字段无效

错误原因：Elasticsearch的KNN查询参数中不存在boosts字段，官方语法不支持在knn对象内直接配置加权规则，必须通过function_score查询来结合字段权重调整。

修正后的代码 #

query = {
    "function_score": {
        "query": {
            "knn": {
                "field": "DescriptionVector",
                "query_vector": vector_of_input_keyword,
                "k": 2,
                "num_candidates": 500
            }
        },
        "functions": [
            {
                "field_value_factor": {
                    "field": "Ratings",
                    "factor": 0.1,
                    "modifier": "none",
                    "missing": 1
                }
            }
        ],
        "boost_mode": "multiply"
    }
}

res = es.search(
    index="all_products",
    query=query,
    _source=["ProductName", "Description"]
)

代码说明 #

• 用function_score包裹KNN查询，实现基础向量搜索+字段加权的综合评分
• field_value_factor函数基于Ratings字段值调整评分：
  • factor: 0.1：将Ratings值乘以0.1后参与评分（可根据需求调整系数）
  • modifier: "none"：保持Ratings原值不做额外转换
  • missing: 1：无Ratings字段的文档默认用1代替，避免评分异常
• boost_mode: "multiply"：将KNN原始相似度评分与Ratings加权值相乘，最终按综合得分排序

可选灵活方案（脚本评分） #

如果需要更复杂的加权逻辑（比如仅对Ratings≥3的文档加分），可以用script_score替代field_value_factor：

query = {
    "function_score": {
        "query": {
            "knn": {
                "field": "DescriptionVector",
                "query_vector": vector_of_input_keyword,
                "k": 2,
                "num_candidates": 500
            }
        },
        "functions": [
            {
                "script_score": {
                    "script": {
                        "source": "doc['Ratings'].value >= 3 ? doc['Ratings'].value * 0.2 : 1"
                    }
                }
            }
        ],
        "boost_mode": "multiply"
    }
}

内容的提问来源于stack exchange，提问作者Shyam