AgentDB Advanced Features

Enable QUIC sync by setting enableQUICSync to true in createAgentDBAdapter, specifying a syncPort and a list of syncPeers. Alternatively, set the AGENTDB_QUIC_SYNC, AGENTDB_QUIC_PORT, and AGENTDB_QUIC_PEERS environment variables before starting each node.

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

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

QUIC sync commonly fails because the firewall blocks UDP traffic on port 4433. Allow the port with your firewall tool, verify peers are reachable via ping, and run with DEBUG=agentdb:quic to inspect sync logs.

MMR (Maximal Marginal Relevance) diversifies retrieved results to reduce redundancy. The mmrLambda parameter controls the trade-off: 0 maximizes relevance, 1 maximizes diversity, and 0.5 provides a balanced default.