Redis、向量库与对象存储

Redis 用于验证码、短期缓存、分布式锁/队列和工作流缓存；生产必须配置密码、持久化策略、内存上限和淘汰策略。Agent session 队列切换为 Redis 后要验证重复投递和同 session 顺序。

Milvus/Elasticsearch 的 collection/index 维度必须与 Embedding 模型一致；更换模型或维度前先建新索引、双写或重建，不能直接覆盖在线索引。MinIO/OSS 保存文件内容和导出物，数据库只保存对象键、大小、哈希和权限元数据。

智能体会话与 Redis 队列

Redis 作为 session 队列或缓存时，要明确 key 前缀、tenant/session 维度、TTL、最大长度和消费确认方式。共享队列必须防止同一 session 同时被两个实例执行；失败消息要有重试上限和死信。Redis 锁只解决约定范围内的互斥，JSONL 恢复仍需校验 runVersion 和 checkpoint。

向量和对象存储切换

更换 Embedding 模型、维度或分段器时，先建立新 collection/index，批量重建并抽样验证 Dataset/tenant filter、命中率和引用，再切换 RagConfig。对象存储迁移要保留 object key、content hash、版本和 ACL，迁移期间同时验证 FileRoom 下载、预览、Artifact 和 Sandbox 挂载。