Voyage AI

Voyage AI EmbeddingFunction 是 seekdb 为支持多样化 AI 生态而设计的嵌入适配器之一。seekdb 作为一款 AI 原生混合搜索数据库，其核心优势在于统一支持向量、全文、结构化与半结构化数据的存储与检索。通过此类嵌入函数，开发者可以便捷地调用外部优秀的嵌入服务（如 VoyageAI），为 seekdb 注入强大的语义理解能力，从而构建更精准的 RAG 系统、智能体记忆库等应用。

提示

使用 Voyage AI 服务需要遵循 Voyage AI 的收费规则，可能产生相应费用。请在继续前，访问其官网或查阅相关文档，确认并接受其收费标准。如不同意，请勿继续操作。

依赖与鉴权

• 已安装 @seekdb/voyageai 软件包。

• 有效的 Voyage AI API 密钥，用于身份验证。

示例：创建 Voyage AI Embedding Function

调用 new VoyageAIEmbeddingFunction() 构造函数，并传入配置对象来初始化嵌入函数。

用环境变量中的 VOYAGE_API_KEY 来指定模型，voyage-4-large 模型是 Voyage AI 的旗舰通用模型，支持长上下文和高精度检索。

import { VoyageAIEmbeddingFunction } from "@seekdb/voyageai";

// 使用 voyage-4-large 大模型
const ef = new VoyageAIEmbeddingFunction({
modelName: "voyage-4-large",
// inputType: "document",
// truncation: true,
});

配置项说明：

• modelName：VoyageAI 模型名称，默认值为 voyage-4-large。

• apiKey：可选，API 密钥，可通过环境变量提供。

• apiKeyEnvVar：API Key 所在的环境变量名，默认值为 VOYAGE_API_KEY。

• input_type：输入类型提示，用于优化检索效果。常见取值：

  • documents：用于文档入库（documents）。

  • metadatas：用于查询（query texts）。

• truncation：可选，当输入文本超过模型的上下文窗口时（如 voyage-4-large 支持 32K tokens），此参数决定是否自动截断超长部分。