20333796/sdzx/knowledge-base

知识库技能

当用户要求基于项目知识库、内部资料、上传入库文档或知识图谱相关内容回答问题时，使用此技能。

可用工具

• list_kbs：列出当前会话可访问且已启用的知识库。
• query_kb：按 kb_id 在指定知识库中检索内容，返回 file_id 和相关片段。
• open_kb_document：按 kb_id 和 file_id 打开文档原文窗口，适合查看更完整上下文。
• find_kb_document：在已知文档内用关键词或正则定位段落。
• get_mindmap：查看知识库思维导图结构。
• search_file：按文件名关键词搜索知识库中的文件，支持指定知识库或跨知识库，返回文件列表与分页信息。
• download_kb_file：按 kb_id 和 file_id 下载知识库原始二进制（pdf/docx/xlsx 等）到沙盒 outputs 目录，返回沙盒内可见的 virtual_path。当后续需要用代码读取原始文件结构（如 openpyxl 读 xlsx 单元格、pdfplumber 重新解析版面）时使用；query_kb/open_kb_document 只返回文本切片，无法满足需要文件对象的场景。
• web_search：当知识库没有相关结果或结果不足时，搜索公开网页并返回带 URL 的来源。该工具需要部署环境配置联网搜索服务。

操作流程

1. 仅当用户明确要求使用知识库、校内资料、上传文件或项目文档时启用本技能；一般概念题和公开知识题不要检索知识库。
2. 需要先确认当前会话有哪些知识库可用；不确定时调用 list_kbs。知识库名称、描述或内容范围与问题明显不匹配时，停止知识库检索。
3. 针对用户问题选择最相关的知识库，使用 query_kb 检索；不得为了“试试看”查询不相关知识库。
4. 如果检索片段不足以回答，使用返回的 file_id 调用 open_kb_document 查看上下文。
5. 如果用户要求定位术语、指标、章节或原文证据，使用 find_kb_document 在候选文档内查找。
6. 当用户关心知识库结构、文件分类或知识框架时，使用 get_mindmap。
7. 如果 query_kb 没有相关结果、相关性低、结果不足以回答，或缺少课程/资源访问地址，继续调用 web_search；不要引用不相关片段。

关键约束

• 只能访问当前会话配置和用户权限允许的知识库。
• 不要编造 kb_id 或 file_id；优先从 list_kbs 和 query_kb 的返回结果中获取。
• 回答需要可追溯时，应说明依据来自哪个知识库、文件或检索片段。
• 推荐课程、课程资源或虚拟仿真平台时，必须从检索结果中提取“访问地址”或 URL，并为每条推荐输出可点击的 Markdown 链接：[资源名称](https://...)。
• 如果检索结果没有访问地址，明确标注“暂无可用访问地址”，不得编造、猜测或把知识库文件路径当作访问地址。
• 知识库与网页搜索都不可用时，明确说明当前无法完成联网检索，并区分“知识库未找到”和“联网搜索未配置/失败”。
• Dify 等外部只读知识库可能只支持检索，不一定支持打开全文或文档内查找；遇到工具返回限制说明时，应如实告知用户。