构建、优化和调试 RAG 管道，包括分块策略、检索调优、评估指标以及生产监控。
何时使用 用户想要执行、 改进或故障排除 Retrieval- 增强生成系统
功能概述
何时使用 用户想要执行、 改进或故障排除 Retrieval- 增强生成系统是一项面向实际任务的技能，主要用于@ @ info: whatsthis。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。
核心要点
- 使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
- 该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
- 从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。
适用场景
用户希望实现、优化或排查 Retrieval-Augmented Generation（RAG）系统的问题。
快速参考
| 主题 | 文件 |
|---|---|
| 流水线组件与架构 | architecture.md |
| 实现模式与代码 | implementation.md |
| 评估指标与调试方法 | evaluation.md |
| 安全与合规性 | security.md |
核心能力
- 架构设计 — 根据需求选择嵌入模型（embedding model）、向量数据库（vector DB）及分块策略（chunking strategy）
- 实现开发 — 编写数据摄取流水线（ingestion pipeline）、查询处理器（query handler）和更新逻辑（update logic）
- 检索优化 — 调优 top-k 值、重排序（reranking）策略、混合搜索（hybrid search）参数
- 效果评估 — 构建测试数据集，度量召回率（recall）与准确率（precision），定位失败原因
- 生产运维 — 监控质量漂移（quality drift）、配置告警机制、诊断性能退化问题
- 安全防护 — 识别个人身份信息（PII）、实施访问控制、满足合规性要求
决策检查清单
在推荐架构前，请确认以下问题：
- 文档类型与总量是多少？
- 延迟要求如何？（实时对话 vs 批处理）
- 文档更新频率如何？（文档多久变更一次？）
- 是否有访问控制需求？（谁可以查看哪些内容？）
- 是否存在合规性约束？（如 GDPR、HIPAA、SOC2）
- 预算限制如何？（托管服务 vs 自托管，嵌入成本等）
关键规则
- 绝不跳过访问控制 — 必须在检索阶段进行过滤，而非检索后过滤
- 始终启用分块重叠 — 重叠比例建议为 10–20%，以避免边界处上下文丢失
- 先评估，再优化 — 先构建评估数据集，再开展调优工作
- 查询与文档必须使用同一嵌入模型 — 确保语义空间一致性
- 持续监控相似度分数 — 平均相似度下降可能预示数据漂移或系统异常
- 提前规划文档删除机制 — GDPR 删除请求要求具备重新嵌入（re-embedding）能力
常见故障模式
| 现象 | 可能原因 | 解决方案 |
|---|---|---|
| 检索到错误文档 | 查询过于宽泛、分块质量差 | 采用查询扩展（query expansion）、减小分块尺寸 |
| 遗漏相关文档 | 文档未被索引、相似度得分过低 | 检查数据摄取流程、引入混合搜索 |
| 生成幻觉答案（hallucinated answers） | 上下文长度不足 | 增大 top-k 值、改进重排序策略 |
| 响应缓慢 | 分块过大、未启用缓存 | 优化分块大小、缓存嵌入向量 |
| 结果不一致 | 重排序过程非确定性（non-deterministic reranking） | 设置随机种子（seed）、采用稳定排序算法 |
相关专题
本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集，涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案，助你快速定位并解决Uvicorn运行中的各类问题。
2026.11.02
0
14
本专题汇总了Uvicorn使用教程与启动运行指南，涵盖其作为Python ASGI服务器的定位与特点，以及命令行启动（uvicorn main:app --reload）、参数配置（host/port/workers）、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧，助你快速掌握Uvicorn的运行与配置。
2026.11.02
0
17
本专题汇总了Uvicorn的安装配置教程与部署指南，涵盖通过pip安装Uvicorn、启动FastAPI/Starlette应用、开发模式热重载（--reload）及多进程工作模式配置等核心操作。同时整理了结合Gunicorn的生产部署方案、HTTPS与反向代理配置及性能调优技巧，助你快速完成Uvicorn服务的安装与上线部署。
2026.11.02
0
17
Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章，帮助读者完成上线流程。
2026.10.28
0
16
Vite搭配Vue.js专题汇集创建Vue 3项目、配置开发环境、路径别名、Vue插件、代理、多环境构建与调试的已审核文章，帮助读者完成从初始化到日常开发的配置。
2026.10.28
0
15
Vite项目目录专题汇集入口文件、src源码、public静态资源、路径别名、项目根目录和构建输出目录相关的已审核文章，帮助读者理解各文件夹的用途与引用方式。
2026.10.28
0
10
本专题介绍Gradle插件开发的基本流程，涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法，帮助你理解插件如何组织构建逻辑，减少多个项目之间的重复配置。
2026.10.22
0
11
本专题介绍Gradle Wrapper的基本作用，涵盖文件组成、生成方法、版本配置和任务调用，帮助你理解项目如何使用指定的Gradle版本，减少不同开发环境带来的构建差异。
2026.10.22
0
10
本专题整理Golangci-lint常用Linters的用途与配置方法，覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查，帮助项目合理选规则。
2026.10.22
0
15
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习
最新文章