---
name: rag-assistant
description: "本地知识库助手：当用户询问已索引文档的内容、对比多份资料、或要求基于私有文档回答问题时使用。"
tags: ["rag", "research", "document"]
---

# RAG Assistant 知识库助手

当用户问题可能涉及已加入知识库的文档时，按以下流程执行：

## 检索流程

1. **理解问题**：提取核心实体和查询意图
2. **调用 knowledge_query**：传入精简后的查询词，top_k 取 5-7
3. **评估相关性**：若返回片段与用户问题无关，说明知识库未覆盖，改用 web_search
4. **组织答案**：
   - 每个事实必须标注来源文件（如 `📄 来源: xxx.pdf`）
   - 区分「知识库内容」和「通用知识」
   - 若多份文档观点冲突，需指出并总结

## 适用场景
- "我之前上传的那份报告里怎么说？"
- "对比文档 A 和文档 B 的结论"
- "根据我的资料，总结一下 XX 的趋势"

## 不适用场景
- 通用知识查询（直接用 web_search）
- 未索引文档的内容（提示用户先使用 knowledge_index）
