vector-index-tuning

向量索引调优

面向生产性能的向量索引优化指南。

适用场景

• 调整 HNSW 参数
• 实现量化
• 优化内存使用
• 降低搜索延迟
• 平衡召回率与速度
• 扩展到数十亿向量

不适用场景

• 仅需在小数据集上进行精确搜索（使用扁平索引）
• 缺少工作负载指标或真值来验证召回率
• 需要超出索引调优范围的端到端检索系统设计

操作步骤

1. 收集工作负载目标（延迟、召回率、QPS）、数据规模和内存预算。
2. 选择索引类型，并使用默认参数建立基线。
3. 使用真实查询对参数扫描进行基准测试，并跟踪召回率、延迟和内存。
4. 在预发布数据集上验证变更，然后再推广到生产环境。

详细的模式、检查清单和模板请参阅 resources/implementation-playbook.md。

安全注意事项

• 没有回滚方案时，避免在生产环境重新索引。
• 在真实负载下验证变更，然后再全局应用。
• 跟踪召回率回退情况，若质量下降则回滚。

资源

• resources/implementation-playbook.md，包含详细的模式、检查清单和模板。

局限性

• 仅当任务明确符合上述范围时才使用本技能。
• 不要将输出视为特定环境验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请停止并请求澄清。