AgentDB Advanced Features

Configure QUIC synchronization, hybrid search, and multi-database management for AgentDB vector stores.

1|1|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/33may/robotics --skill agentdb-advanced-features-33may
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: AgentDB Advanced Features
Source: https://github.com/33may/robotics/tree/main/humanoid/.claude/skills/agentdb-advanced
Command: npx skills add https://github.com/33may/robotics --skill agentdb-advanced-features-33may

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires agentdb, agentic-flow.

What problem does it solve? Building distributed AI systems with vector databases requires solving cross-node synchronization, redundant search results, and metadata filtering challenges that basic vector search setups cannot handle. ## Core Features & Use Cases - QUIC Synchronization: Synchronize AgentDB instances across network nodes with sub-millisecond latency, TLS 1.3 encryption, and automatic retry. - Hybrid Search: Combine vector similarity with metadata filters (price ranges, categories, dates) and weighted scoring for precise retrieval. - Multi-Database Management & MMR: Shard databases by domain, pool connections, and use Maximal Marginal Relevance to diversify search results. - Use Case: Deploy a three-node cluster where learned patterns replicate across all peers in under 1ms, then run hybrid searches filtering research papers by year, category, and citation count. ## Quick Start Set up AgentDB with QUIC synchronization enabled across two peer nodes and run a hybrid vector search filtered by metadata.

Frequently Asked Questions about AgentDB Advanced Features

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable QUIC synchronization between AgentDB instances?▼

Enable QUIC sync by setting enableQUICSync to true in createAgentDBAdapter, specifying a syncPort and a list of syncPeers. You can also configure it via environment variables AGENTDB_QUIC_SYNC, AGENTDB_QUIC_PORT, and AGENTDB_QUIC_PEERS.

How to combine vector search with metadata filters in AgentDB?▼

Use retrieveWithReasoning with a filters object supporting operators like $gte, $lte, $in, and $contains. You can also set hybridWeights to balance vector similarity against metadata match scores.

Which distance metric should I use for vector search?▼

Cosine similarity suits text embeddings and semantic search, euclidean distance fits spatial and image data, and dot product works best for pre-normalized vectors. Choose based on whether vector magnitude matters for your embeddings.

Why is AgentDB QUIC sync not working between nodes?▼

QUIC sync commonly fails because the firewall blocks UDP port 4433 or peers are unreachable. Allow the port with ufw, verify connectivity with ping, and enable debug logging via DEBUG=agentdb:quic.

What does MMR do in vector search results?▼

MMR (Maximal Marginal Relevance) diversifies results to reduce redundancy among similar matches. The mmrLambda parameter controls the trade-off: 0 maximizes relevance, 1 maximizes diversity, and 0.5 balances both.