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. The choice depends on whether vector magnitude matters for your data.

QUIC sync commonly fails because UDP port 4433 is blocked by a firewall or peers are unreachable. Allow the port with your firewall tool, verify peer connectivity with ping, and run with DEBUG=agentdb:quic to inspect logs.

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