Vectra — 适用于 Ruby 的统一向量数据库客户端

Source: Dev.to

Vectra — 统一的 Ruby 向量数据库客户端（支持 Pinecone、Qdrant、Weaviate、pgvector 等）

如果你曾经在 Ruby 中构建 AI 应用——语义搜索、RAG、推荐系统或嵌入查询——就会知道同时支持多个向量数据库是多么繁琐。每个供应商都有自己的 API、客户端和细节。

Vectra 通过提供一个统一的 API 来解决这个问题，让你摆脱供应商锁定。只需编写一次代码，即可轻松切换后端——Pinecone、Qdrant、Weaviate，甚至是带有 pgvector 的 PostgreSQL。

• GitHub 仓库: https://github.com/stokry/vectra/
• 文档: https://vectra-docs.netlify.app/

为什么选择 Vectra？

• 供应商无关的 API – 一套方法（upsert、query、delete 等）可在所有供应商之间通用。
• 支持多种数据库 – Pinecone、Qdrant、Weaviate、pgvector，全部使用同一个客户端。
• 生产就绪 – 重试逻辑、可配置的退避、通过指标进行可观测性，以及为生产工作负载准备好的类。
• Rails 集成 – 为 ActiveRecord 模型提供 has_vector DSL；嵌入字段可以自动建立索引并进行搜索。
• 文档完善的 gem – 指南、YARD 文档以及每个供应商的示例。

示例用法

require 'vectra'

# 初始化任意供应商的客户端
client = Vectra::Client.new(
  provider: :pinecone,
  api_key: ENV['PINECONE_API_KEY'],
  environment: 'us-west-4'
)

# 插入嵌入向量
client.upsert(
  vectors: [
    { id: 'doc-1', values: [0.1, 0.2, 0.3], metadata: { title: 'Hello' } }
  ]
)

# 查询相似向量
results = client.query(vector: [0.1, 0.2, 0.3], top_k: 5)
results.each { |m| puts "#{m.id}: #{m.score}" }

# 删除
client.delete(ids: ['doc-1'])

如果将客户端切换为 Qdrant、Weaviate 或 pgvector，API 完全保持不变。

Vectra 的适用场景

• 构建语义搜索应用
• 使用嵌入实现 RAG（检索增强生成）
• 避免向量数据库之间的供应商锁定
• 为所有向量数据库提供一致的 Ruby API 接口

获取方式

• GitHub: https://github.com/stokry/vectra/
• 文档: https://vectra-docs.netlify.app/