Redis 搜索
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/redis-agent-skills-redis-search。
技能介绍
你在纠结什么
给 Redis 上全文检索时,字段类型选错(用 TEXT 存类目却要做精确过滤)、查询命令选宽了(该用 FT.AGGREGATE 却堆在 FT.SEARCH 上),或向量维度和 DISTANCE_METRIC 与嵌入模型不一致——这些都会在生产里表现为空结果、慢查询或向量分数不可信。Redis 8.4 之后还有 FT.HYBRID 与老式「先查再客户端过滤」混为一谈的问题。
技能覆盖的能力
本技能把 Redis Search 当成同一套检索面来写:从 FT.CREATE / FT.ALTER 建索引,到 FT.SEARCH、FT.AGGREGATE、FT.HYBRID 的选用边界;字段上区分 TEXT、TAG、NUMERIC、GEO、GEOSHAPE、VECTOR 与 JSON $.path;向量侧讲 HNSW vs FLAT、维度与距离度量对齐、混合检索里的 filter-then-vector 与 lexical + vector fusion。另外包含 RAG 管线(分块、批量写入、属性预过滤、重排)、零停机换 schema(别名)、以及用 FT.EXPLAIN、FT.PROFILE、FT.INFO 排障。
适用边界
示例以 CLI / RESP 为主;各语言客户端需对照技能内 references/clients/。FT.HYBRID 与内置向量能力依赖 Redis ≥ 8.4(模块时代另有最低版本表)。技能是设计与查询指引,不包含 Redis 集群容量规划或嵌入模型训练。
使用场景
- 新建商品或文档索引时,要在 PREFIX、字段类型和 DIALECT 2 之间做一致选型
- 线上检索变慢或经常无结果,需要用 FT.PROFILE、FT.EXPLAIN 对照查询 DSL 与分词
- 搭建基于 Redis 的 RAG,需要 chunk、预过滤租户字段并选对 COSINE 与 HNSW 参数
- Redis 8.4 上线后,要把 BM25 与向量相似度用 FT.HYBRID 做融合排序
适合人员
- 维护 RediSearch 索引的后端工程师,需要改版 schema 且不能长时间停写
- 做语义搜索或推荐的同学,要在同一集群里混用词法过滤与向量 KNN
- 平台 SRE 负责检索 SLA,需要区分 TAG 与 TEXT 并优化聚合分页(WITHCURSOR)
- 在应用里接 redis-py / Jedis 的开发者,要把 CLI 查询翻译成客户端调用