RAG架构设计器
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/jf-rag-architect。
技能介绍
要解决的具体问题
RAG系统设计常面临三重困境:文档结构复杂导致切分粒度难把控,嵌入模型与业务场景不匹配影响检索精度,混合检索策略缺乏统一评估标准导致质量波动。具体表现为:
- 长文档切分后语义断裂,关键信息被切割到不同块中
- 单纯向量检索无法覆盖关键词精确匹配需求
- 重排模型引入后召回率与响应速度的矛盾
- 评估环节依赖人工抽检,缺乏可量化的质量基准
技能如何工作
核心能力拆解
- 语义感知切分
- 支持按语义边界或固定长度动态确定块大小
- 自动计算重叠区域(overlap)防止信息丢失
- 输出结构化切分方案供人工校验
- 嵌入工程优化
- 提供模型选型决策树(精度/速度/成本三角权衡)
- 批处理嵌入生成与向量存储方案设计
- 支持增量更新机制设计
- 混合检索策略
- 向量检索(ANN算法)与关键词检索(BM25)并行
- 引入重排模型(如cross-encoder)进行二次排序
- 输出融合策略参数(如权重分配、截断阈值)
- 质量评估体系
- 召回率计算(精确率/召回率/F1值)
- 相关性人工抽检模板(含标注指南)
- 质量退化检测机制(如嵌入漂移监控)
关键工作流
- 输入解析
- 接收自然语言需求(含约束条件)
- 解析代码片段中的现有实现
- 支持结构化RagDesign输入做二次优化
- 分步执行
- 按切分→嵌入→检索→评估顺序生成方案
- 每阶段输出中间结果供确认
- 异常路径处理(如切分失败回退策略)
- 输出规范
- 结构化工件RagDesign(含chunk_size, embed_model, store等字段)
- 自然语言摘要(含改进建议与质量自检结果)
- 完整方案模板(含工作流要点、陷阱警示)
适用边界与注意点
明确不适用场景
- 需要领域适配的模型微调(应使用
fine-tuning-expert技能) - 向量库集群运维(如
Milvus分片策略调优) - 实时性要求极高的场景(需额外优化延迟)
关键注意点
- 切分策略验证
- 必须进行语义连贯性测试(可通过BERTScore等指标量化)
- 重叠区域需小于块大小的20%防止信息冗余
- 嵌入模型选择
- 中文场景优先测试bge-large-zh系列模型
- 需评估max_seq_length与业务文档长度的匹配度
- 混合检索调优
- 初期建议采用vector_weight=0.7的基线策略
- 重排模型需进行top_k参数敏感性测试
- 评估闭环设计
- 必须建立至少包含50个标注样本的基准测试集
- 定期进行嵌入空间可视化分析(如t-SNE降维)
典型陷阱警示
- 过度追求小块切分导致上下文碎片化
- 盲目采用最新嵌入模型忽视部署成本
- 重排模型过深导致推理延迟超标
- 评估环节完全依赖人工标注不可持续
通过结构化工作流与明确质量基准,该技能将RAG系统设计从经验驱动转变为数据驱动,在保证技术可行性的同时提升工程可维护性。
使用场景
- 搭建企业知识库问答时,需确定文档切块策略与嵌入模型组合
- 优化法律文书检索时,需配置混合检索参数并评估召回相关性
- 构建技术文档问答系统时,需设计重排模型与向量存储方案
- 重构现有RAG管道时,需分析召回率退化并生成改进建议
适合人员
- 正在实施RAG系统的后端工程师,需要具体技术决策依据
- 负责知识库搭建的架构师,关注检索质量与运维成本平衡
- 优化搜索效果的算法工程师,需要评估指标与调优方法论
- 维护问答系统的技术负责人,需处理召回质量退化问题