用途:介绍 AgentDB 的高级能力,面向分布式系统、多数据库协调、自定义距离度量、混合搜索(向量+元数据)与生产部署场景。
前置条件:Node.js 18+;AgentDB v1.0.7+(通过 agentic-flow 获取);QUIC 同步需了解分布式系统;需具备向量搜索基础。
主要能力:
- QUIC 同步:跨节点同步延迟低于 1ms,支持多路复用流、TLS 1.3 内置加密、自动重试与恢复、基于事件的广播。通过 createAgentDBAdapter 的 enableQUICSync、syncPort、syncPeers 等参数启用,或用 AGENTDB_QUIC_SYNC、AGENTDB_QUIC_PORT、AGENTDB_QUIC_PEERS 环境变量启动多节点。
- 距离度量:cosine(归一化向量、语义相似)、euclidean(空间与图像数据)、dot(预归一化向量),CLI 用 npx agentdb@latest query ./vectors.db "[...]" -m 指定;也支持自定义距离函数。
- 混合搜索:向量相似度结合元数据过滤,支持 $gte、$lte、$in、$contains 等条件,可用 hybridWeights 调整向量与元数据权重。
- 多数据库与分片:按领域建立独立数据库或按分片键路由查询。
- MMR:用 useMMR、mmrLambda 控制相关性与多样性平衡;上下文合成用 synthesizeContext 从多条记忆生成连贯上下文。
- 生产实践:连接池单例、错误处理(DIMENSION_MISMATCH、DATABASE_LOCKED)、性能监控与统计;CLI 支持 export/import/merge/reindex,并可用 VACUUM、ANALYZE 优化。
限制与说明:文档未提供价格、授权或平台支持范围;QUIC 需开放 UDP 端口(如 4433);自定义距离度量需自行实现。预计学习时间 45-60 分钟,难度为高级。