鱼皮AI导航
鱼皮AI导航
  • 主页
  • 社区
  • AI工具
  • AI知识库
  • AI提示词
  • MCP
  • Skills
  • AI学习资源
  • AI资讯
  • GitHub开源
登录/注册

agentdb-vector-search

提供超高速语义向量检索能力,支持基于嵌入的相似性匹配、混合元数据过滤及上下文感知查询,适用于构建 RAG 系统、智能知识库和语义搜索引擎,具备亚毫秒级响应与高效内存压缩特性。

数据与分析研究
访问 GitHub
文档Skills.MD
name
AgentDB Vector Search
description
Implement semantic vector search with AgentDB for intelligent document retrieval, similarity matching, and context-aware querying. Use when building RAG systems, semantic search engines, or intelligent knowledge bases.

AgentDB Vector Search

What This Skill Does

Implements vector-based semantic search using AgentDB's high-performance vector database with 150x-12,500x faster operations than traditional solutions. Features HNSW indexing, quantization, and sub-millisecond search (<100µs).

Prerequisites

  • Node.js 18+
  • AgentDB v1.0.7+ (via agentic-flow or standalone)
  • OpenAI API key (for embeddings) or custom embedding model

Quick Start with CLI

Initialize Vector Database

▼
bash
复制代码
# Initialize with default dimensions (1536 for OpenAI ada-002) npx agentdb@latest init ./vectors.db # Custom dimensions for different embedding models npx agentdb@latest init ./vectors.db --dimension 768 # sentence-transformers npx agentdb@latest init ./vectors.db --dimension 384 # all-MiniLM-L6-v2 # Use preset configurations npx agentdb@latest init ./vectors.db --preset small # <10K vectors npx agentdb@latest init ./vectors.db --preset medium # 10K-100K vectors npx agentdb@latest init ./vectors.db --preset large # >100K vectors # In-memory database for testing npx agentdb@latest init ./vectors.db --in-memory

Query Vector Database

▼
bash
复制代码
# Basic similarity search npx agentdb@latest query ./vectors.db "[0.1,0.2,0.3,...]" # Top-k results npx agentdb@latest query ./vectors.db "[0.1,0.2,0.3]" -k 10 # With similarity threshold (cosine similarity) npx agentdb@latest query ./vectors.db "0.1 0.2 0.3" -t 0.75 -m cosine # Different distance metrics npx agentdb@latest query ./vectors.db "[...]" -m euclidean # L2 distance npx agentdb@latest query ./vectors.db "[...]" -m dot # Dot product # JSON output for automation npx agentdb@latest query ./vectors.db "[...]" -f json -k 5 # Verbose output with distances npx agentdb@latest query ./vectors.db "[...]" -v

Import/Export Vectors

▼
bash
复制代码
# Export vectors to JSON npx agentdb@latest export ./vectors.db ./backup.json # Import vectors from JSON npx agentdb@latest import ./backup.json # Get database statistics npx agentdb@latest stats ./vectors.db

Quick Start with API

▼
typescript
复制代码
import { createAgentDBAdapter, computeEmbedding } from 'agentic-flow/reasoningbank'; // Initialize with vector search optimizations const adapter = await createAgentDBAdapter({ dbPath: '.agentdb/vectors.db', enableLearning: false, // Vector search only enableReasoning: true, // Enable semantic matching quantizationType: 'binary', // 32x memory reduction cacheSize: 1000, // Fast retrieval }); // Store document with embedding const text = "The quantum computer achieved 100 qubits"; const embedding = await computeEmbedding(text); await adapter.insertPattern({ id: '', type: 'document', domain: 'technology', pattern_data: JSON.stringify({ embedding, text, metadata: { category: "quantum", date: "2025-01-15" } }), confidence: 1.0, usage_count: 0, success_count: 0, created_at: Date.now(), last_used: Date.now(), }); // Semantic search with MMR (Maximal Marginal Relevance) const queryEmbedding = await computeEmbedding("quantum computing advances"); const results = await adapter.retrieveWithReasoning(queryEmbedding, { domain: 'technology', k: 10, useMMR: true, // Diverse results synthesizeContext: true, // Rich context });

Core Features

1. Vector Storage

▼
typescript
复制代码
// Store with automatic embedding await db.storeWithEmbedding({ content: "Your document text", metadata: { source: "docs", page: 42 } });

2. Similarity Search

▼
typescript
复制代码
// Find similar documents const similar = await db.findSimilar("quantum computing", { limit: 5, minScore: 0.75 });

3. Hybrid Search (Vector + Metadata)

▼
typescript
复制代码
// Combine vector similarity with metadata filtering const results = await db.hybridSearch({ query: "machine learning models", filters: { category: "research", date: { $gte: "2024-01-01" } }, limit: 20 });

Advanced Usage

RAG (Retrieval Augmented Generation)

▼
typescript
复制代码
// Build RAG pipeline async function ragQuery(question: string) { // 1. Get relevant context const context = await db.searchSimilar( await embed(question), { limit: 5, threshold: 0.7 } ); // 2. Generate answer with context const prompt = `Context: ${context.map(c => c.text).join('\n')} Question: ${question}`; return await llm.generate(prompt); }

Batch Operations

▼
typescript
复制代码
// Efficient batch storage await db.batchStore(documents.map(doc => ({ text: doc.content, embedding: doc.vector, metadata: doc.meta })));

MCP Server Integration

▼
bash
复制代码
# Start AgentDB MCP server for Claude Code npx agentdb@latest mcp # Add to Claude Code (one-time setup) claude mcp add agentdb npx agentdb@latest mcp # Now use MCP tools in Claude Code: # - agentdb_query: Semantic vector search # - agentdb_store: Store documents with embeddings # - agentdb_stats: Database statistics

Performance Benchmarks

▼
bash
复制代码
# Run comprehensive benchmarks npx agentdb@latest benchmark # Results: # ✅ Pattern Search: 150x faster (100µs vs 15ms) # ✅ Batch Insert: 500x faster (2ms vs 1s for 100 vectors) # ✅ Large-scale Query: 12,500x faster (8ms vs 100s at 1M vectors) # ✅ Memory Efficiency: 4-32x reduction with quantization

Quantization Options

AgentDB provides multiple quantization strategies for memory efficiency:

Binary Quantization (32x reduction)

▼
typescript
复制代码
const adapter = await createAgentDBAdapter({ quantizationType: 'binary', // 768-dim → 96 bytes });

Scalar Quantization (4x reduction)

▼
typescript
复制代码
const adapter = await createAgentDBAdapter({ quantizationType: 'scalar', // 768-dim → 768 bytes });

Product Quantization (8-16x reduction)

▼
typescript
复制代码
const adapter = await createAgentDBAdapter({ quantizationType: 'product', // 768-dim → 48-96 bytes });

Distance Metrics

▼
bash
复制代码
# Cosine similarity (default, best for most use cases) npx agentdb@latest query ./db.sqlite "[...]" -m cosine # Euclidean distance (L2 norm) npx agentdb@latest query ./db.sqlite "[...]" -m euclidean # Dot product (for normalized vectors) npx agentdb@latest query ./db.sqlite "[...]" -m dot

Advanced Features

HNSW Indexing

  • O(log n) search complexity
  • Sub-millisecond retrieval (<100µs)
  • Automatic index building

Caching

  • 1000 pattern in-memory cache
  • <1ms pattern retrieval
  • Automatic cache invalidation

MMR (Maximal Marginal Relevance)

  • Diverse result sets
  • Avoid redundancy
  • Balance relevance and diversity

Performance Tips

  1. Enable HNSW indexing: Automatic with AgentDB, 10-100x faster
  2. Use quantization: Binary (32x), Scalar (4x), Product (8-16x) memory reduction
  3. Batch operations: 500x faster for bulk inserts
  4. Match dimensions: 1536 (OpenAI), 768 (sentence-transformers), 384 (MiniLM)
  5. Similarity threshold: Start at 0.7 for quality, adjust based on use case
  6. Enable caching: 1000 pattern cache for frequent queries

Troubleshooting

Issue: Slow search performance

▼
bash
复制代码
# Check if HNSW indexing is enabled (automatic) npx agentdb@latest stats ./vectors.db # Expected: <100µs search time

Issue: High memory usage

▼
bash
复制代码
# Enable binary quantization (32x reduction) # Use in adapter: quantizationType: 'binary'

Issue: Poor relevance

▼
bash
复制代码
# Adjust similarity threshold npx agentdb@latest query ./db.sqlite "[...]" -t 0.8 # Higher threshold # Or use MMR for diverse results # Use in adapter: useMMR: true

Issue: Wrong dimensions

▼
bash
复制代码
# Check embedding model dimensions: # - OpenAI ada-002: 1536 # - sentence-transformers: 768 # - all-MiniLM-L6-v2: 384 npx agentdb@latest init ./db.sqlite --dimension 768

Database Statistics

▼
bash
复制代码
# Get comprehensive stats npx agentdb@latest stats ./vectors.db # Shows: # - Total patterns/vectors # - Database size # - Average confidence # - Domains distribution # - Index status

Performance Characteristics

  • Vector Search: <100µs (HNSW indexing)
  • Pattern Retrieval: <1ms (with cache)
  • Batch Insert: 2ms for 100 vectors
  • Memory Efficiency: 4-32x reduction with quantization
  • Scalability: Handles 1M+ vectors efficiently
  • Latency: Sub-millisecond for most operations

Learn More

  • GitHub: https://github.com/ruvnet/agentic-flow/tree/main/packages/agentdb
  • Documentation: node_modules/agentic-flow/docs/AGENTDB_INTEGRATION.md
  • MCP Integration: npx agentdb@latest mcp for Claude Code
  • Website: https://agentdb.ruv.io
  • CLI Help: npx agentdb@latest --help
  • Command Help: npx agentdb@latest help <command>
数据与分析
研究

快捷安装

复制到终端去安装 Skill

npxskillsaddruvnet/claude-flow--skill"agentdb-vector-search"
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
站长:程序员鱼皮 老鱼简历 商务合作 增值电信业务经营许可证
2026 鱼皮AI导航 | 沪ICP备19026706号-6
🔥热门工具
朱雀AI检测朱雀AI检测
朱雀AI检测助手朱雀AI检测助手
LovartLovart
老鱼简历老鱼简历
WritePass官网WritePass官网
面多多面多多
CursorCursor
星月写作星月写作
朱雀AI检测助手朱雀AI检测助手
零感AI零感AI
Skills 推荐
definition-of-done-generator
自动生成项目完成标准的规范定义与配置文件,提供符合企业级工作流要求的最佳实践指导,输出可直接投入生产环境的代码和验证结果,适用于需要标准化流程审批、合规审查及跨系统集成的复杂项目管理场景。
sagemaker-endpoint-deployer
自动化部署机器学习模型至云端服务端点,支持从配置生成到生产验证的全流程,适用于模型上线、服务监控与推理优化等场景,确保部署方案符合工业级标准。
docx
支持专业级 Word 文档的全生命周期处理,包括从零创建结构化文档、精准编辑内容、管理修订痕迹与批注、提取纯文本或原始 XML 数据、转换为 PDF 或图像用于视觉分析,适用于法律、学术及企业场景下的高保真文档协作与自动化处理。
skills-search
提供对 Claude Code 技能生态的全周期管理能力,支持按功能关键词检索技能、查看详细信息、安装或卸载指定技能,并区分用户级与项目级作用域,覆盖发现、评估、部署及维护各环节。
moai-foundation-core
构建高质量、可扩展的AI开发工作流,通过领域驱动设计与模块化架构实现需求规范先行,结合自动化质量门禁、精细化上下文管理与渐进式知识呈现,在保障安全与可维护性的同时提升开发效率与协作清晰度。