agentdb vector search

用途

AgentDB Vector Search 用于实现基于向量的语义搜索，面向智能文档检索、相似度匹配和上下文感知查询等任务，适用于构建 RAG（检索增强生成）等需要语义检索能力的场景。

主要能力

向量存储：可存储文档及其嵌入向量与元数据。
相似度搜索：支持查找相似文档并设置结果数量与最低分数。
混合搜索：结合向量相似度与元数据过滤。
高级检索：支持 MMR（最大边际相关性）以获得多样化结果，并可合成上下文。
距离度量：支持 cosine（默认）、euclidean（L2）、dot（点积）。
量化：支持 binary（32 倍内存压缩）、scalar（4 倍）、product（8-16 倍）等策略以降低内存占用。
索引与缓存：HNSW 索引带来 O(log n) 搜索复杂度与亚毫秒检索；内置缓存支持 1000 条模式的内存缓存。
批处理：高效的批量存储操作。
导入导出与统计：支持向量的导出、导入以及数据库统计信息查询。
MCP 服务器集成：可启动 AgentDB MCP 服务器并接入 Claude Code，使用 agentdb_query、agentdb_store、agentdb_stats 等工具。

使用方式

前置条件：Node.js 18+、AgentDB v1.0.7+（通过 agentic-flow 或独立方式）、OpenAI API 密钥（用于嵌入）或自定义嵌入模型。

CLI 快速开始：

初始化向量数据库：npx agentdb@latest init ./vectors.db；可指定维度（如 --dimension 768、--dimension 384）或使用预设（--preset small/medium/large），也可使用 --in-memory 进行内存测试。
查询：npx agentdb@latest query ./vectors.db "[0.1,0.2,0.3,...]"；可设置 top-k（-k 10）、相似度阈值（-t 0.75）、距离度量（-m cosine/euclidean/dot）、JSON 输出（-f json）以及详细输出（-v）。
导入导出与统计：npx agentdb@latest export ./vectors.db ./backup.json、npx agentdb@latest import ./backup.json、npx agentdb@latest stats ./vectors.db。

API 快速开始：从 agentic-flow/reasoningbank 引入 createAgentDBAdapter 与 computeEmbedding，创建适配器（可配置 dbPath、enableLearning、enableReasoning、quantizationType、cacheSize），随后通过 insertPattern 存储带嵌入向量的文档，并通过 retrieveWithReasoning 进行语义搜索（可启用 useMMR 与 synthesizeContext）。

核心功能示例包括：storeWithEmbedding 自动嵌入存储、findSimilar 相似文档检索、hybridSearch 向量与元数据结合搜索。

高级用法：可构建 RAG 管线（先检索相关上下文再生成答案）、使用 batchStore 进行批量存储、通过 npx agentdb@latest mcp 启动 MCP 服务器并执行 claude mcp add agentdb npx agentdb@latest mcp 接入 Claude Code。

适用场景

智能文档检索与语义搜索。
相似度匹配与上下文感知查询。
RAG（检索增强生成）管线构建。
需要多样化结果的检索（MMR）。
大规模向量检索（资料称可高效处理 100 万以上向量）。
与 Claude Code 通过 MCP 集成使用。

限制与注意事项

前置依赖：需 Node.js 18+、AgentDB v1.0.7+、OpenAI API 密钥或自定义嵌入模型。
维度需与所选嵌入模型匹配：OpenAI ada-002 为 1536，sentence-transformers 为 768，all-MiniLM-L6-v2 为 384。
相似度阈值可从 0.7 起步，按用例调整。
性能表现以资料给出的基准为准（如向量搜索 <100µs、批量插入 100 个向量约 2ms），实际表现可能因环境而异。
说明文档中未提供价格、付费方案与完整平台支持信息。

性能特征（资料提供）

向量搜索：<100µs（HNSW 索引）。
模式检索：<1ms（带缓存）。
批量插入：100 个向量 2ms。
内存效率：量化可减少 4-32 倍。
可扩展性：可高效处理 100 万以上向量。
延迟：大多数操作为亚毫秒级。

技能介绍

用途