Qdrant客户端v1.14.1版本发布:本地推理与搜索增强
Qdrant是一个高性能向量搜索引擎,其Python客户端库提供了与Qdrant向量数据库交互的便捷接口。最新发布的v1.14.1版本带来了一系列重要改进,特别是在本地推理支持和搜索功能增强方面。
核心特性解析
原生本地推理支持
本次更新最显著的改进是通过与Fastembed的无缝集成,为QdrantClient的所有方法提供了原生推理支持。这意味着开发者现在可以直接在客户端进行向量化操作,而无需依赖外部服务。具体体现在:
- 废弃了原有的
add和query方法,推荐使用新的本地推理方式 - 支持在客户端直接处理文本到向量的转换,简化了应用架构
- 提高了开发效率,特别是在原型开发和小规模应用场景中
搜索功能增强
v1.14.1版本对搜索相关功能进行了多项改进:
-
服务器端分数增强:新增了对搜索结果进行服务器端分数调整的能力,使开发者可以更灵活地控制排序逻辑。
-
新增推荐策略:引入了
sum_score推荐策略,为推荐系统提供了更多算法选择。 -
地理多边形支持修复:解决了之前版本中地理多边形查询可能存在的问题,使地理位置相关搜索更加可靠。
架构优化与兼容性改进
依赖项精简
- 移除了grpcio-tools依赖,现在仅需要protobuf
- 优化了依赖管理,减少了不必要的包引入
类型提示增强
对类型提示系统进行了全面改进,提供了更准确的代码提示和静态检查支持,有助于:
- 提高开发效率
- 减少运行时错误
- 改善IDE支持
严格模式扩展
扩展了严格模式设置选项,为开发者提供了更细粒度的控制能力,可以根据项目需求调整严格性级别。
重要修复与行为变更
-
删除操作优化:现在尝试删除不存在的点不会抛出错误(本地模式下),使错误处理更加友好。
-
条件查询简化:在本地模式下,现在允许直接传递单个条件而不需要包装成列表,简化了查询构造。
-
请求限制处理:改进了对"太多请求"异常的处理,提高了高负载情况下的稳定性。
-
偏移量传播修正:偏移量不再传播到预取操作中,解决了某些边界情况下的行为不一致问题。
向后兼容性说明
-
Pydantic版本支持变更:不再支持Pydantic 2.0到2.2.1之间的版本,现在支持的版本为v1.10.x和>=2.21。
-
API弃用:原有的
add和query方法已被标记为弃用,建议开发者迁移到新的本地推理API。
实际应用建议
对于正在使用或考虑采用Qdrant的开发者,建议:
-
评估本地推理功能:对于中小规模应用或需要快速原型开发的项目,新的本地推理支持可以显著简化架构。
-
测试新的推荐策略:
sum_score策略可能在某些推荐场景下表现更好,值得进行对比测试。 -
规划迁移路径:如果使用了将被弃用的API,应制定迁移计划以避免未来兼容性问题。
-
利用类型提示改进:更新代码以充分利用增强的类型提示,提高代码质量和可维护性。
这个版本标志着Qdrant客户端在易用性和功能性上的重要进步,特别是本地推理支持的引入,为开发者提供了更大的灵活性和更简单的开发体验。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0213
cann-learning-hubCANN 学习中心仓,支持在线互动运行、边学边练,提供教程、示例与优化方案,一站式助力昇腾开发者快速上手。Jupyter Notebook0138
uni-appA cross-platform framework using Vue.jsJavaScript08
GLM-5.2智谱开源 GLM-5.2,这是针对长文本任务的最新旗舰模型。相较于前代产品 GLM-5.1,它在长文本任务处理能力上实现了显著飞跃,并且首次在稳定的 100 万 token 上下文中提供这一能力。Jinja00
SwanLab⚡️SwanLab - an open-source, modern-design AI training tracking and visualization tool. Supports Cloud / Self-hosted use. Integrated with PyTorch / Transformers / LLaMA Factory / veRL/ Swift / Ultralytics / MMEngine / Keras etc.Python00
tiny-universe《大模型白盒子构建指南》:一个全手搓的Tiny-UniverseJupyter Notebook03