Voyage AI向量工具

技能简介

Voyage AI Skill 是基于 Node.js 的 CLI 工具，集成 Voyage AI 的嵌入生成与重排序能力，可直接对接 MongoDB Atlas Vector Search 实现完整的向量数据流水线。无需 Python 环境，通过 vai 命令即可完成从文本向量化到相似性检索的全流程操作。

能做什么

• 调用 Voyage AI 模型生成文本嵌入向量
• 对候选文档进行语义重排序，提升检索质量
• 将嵌入结果存储至 MongoDB Atlas 集合并创建向量索引
• 执行向量相似性搜索，支持预过滤条件
• 批量导入数据并自动生成嵌入
• 对比两段文本的语义相似度
• 交互式演示与学习 AI 概念

使用说明

安装步骤

1. 全局安装 CLI 工具：
   npm install -g voyageai-cli
2. 配置环境变量（必需）：
   export VOYAGE_API_KEY="pa-your-key"
   可选配置 MongoDB 连接串：
   export MONGODB_URI="mongodb+srv://..."
3. 验证安装：
   vai ping

常用命令示例

• 生成嵌入：vai embed "查询文本" --model voyage-4-large
• 存储并索引：vai store --db mydb --collection docs --field embedding --text "内容"
• 向量搜索：vai search --query "关键词" --db mydb --collection docs --index vector_index
• 批量导入：vai ingest --file corpus.jsonl --db mydb --collection docs --field embedding

输入与输出

见下方输入与输出表格。

风险提示

• API 密钥需妥善保管，避免硬编码提交至代码仓库
• 批量导入时注意请求速率限制，建议调整 --batch-size 参数
• 向量索引创建后修改维度或相似度算法需重建索引
• MongoDB URI 包含凭据时需确保传输层加密

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mrlynn/voyageai-skill/SKILL.md
来源类型：GitHub 开源技能