Agent Skills
返回列表
RAGFlow 知识库数据库助手

RAGFlow 知识库数据库助手

知识管理 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3bdd14fe/3039dc63-d846-4c9d-a392-35c306448cfb。

技能介绍

要解决的问题

RAGFlow 作为开源 RAG 知识库系统，通常会把文档上传、知识库维护、检索调用和 LLM 上下文拼装分散在多个脚本里。ragflow-knowledge-db 要解决的是这类重复胶水代码：既要调用 RAGFlow API 管理知识库、上传 PDF、DOCX、PPTX、XLSX、TXT、MD、JSON、CSV 和图片文档，又要把同步后的文档、研究任务和研究报告落到 SQLite 或 MySQL，供后续查询、追踪和复用。

技能如何工作

技能提供两个客户端：scripts/ragflow_client.py 负责 RAGFlow API 操作，scripts/db_client.py 负责数据库交互。使用前配置 RAGFlow 地址、API Key，以及数据库连接信息。核心能力包括：

  • 知识库管理：列出、创建、删除知识库，适合维护多个业务域文档集。
  • 文档管理：上传和删除文档，覆盖常见办公文档、文本和图片格式。
  • 知识检索与对话：执行简单检索，或调用 simple_chat 返回格式化上下文和提示词，便于接入 LLM。
  • 数据库管理：初始化数据库、从 RAGFlow 同步文档、管理研究任务和研究报告，把外部 RAG 状态沉淀为可查询记录。

关键步骤通常是从 RAGFlow 获取知识库与文档状态，写入数据库，再基于检索结果拼装提示词，减少手动重复调用 API 和拼接字段。

适用边界与注意点

它更适合作为 RAGFlow 周边工具，而不是替代 RAGFlow 自身。使用时需要注意：

  • 始终检查 client.available 并捕获 API 异常，避免把网络或服务故障误判为业务错误。
  • API Key 应放在环境变量中，不要提交到代码仓库。
  • 大文件上传可能耗时，需要合理设置超时。
  • 文档命名要有业务含义，否则后续同步、检索和排查都会更难。

使用场景

  • 接入 RAGFlow 服务后，批量创建知识库并上传 PDF、Word、Excel 文档，用于项目资料归档。
  • 维护 RAGFlow 文档集合，列出知识库文档并删除过期合同、旧版说明材料。
  • 调用 simple_chat 获取知识库检索上下文和提示词，再交给 LLM 生成回答。
  • 把 RAGFlow 同步的文档、研究任务和研究报告写入 SQLite，便于后续查询。

适合人员

  • 维护 RAGFlow 知识库的工程师，需要批量上传文档并清理过期资料。
  • 构建 RAG 应用的开发者，需要获取检索上下文和提示词以接入 LLM。
  • 管理研究数据的产品或运营，需要把任务、报告同步到 SQLite 查询。
  • 做知识管理集成的后端工程师，需要把 RAGFlow API 状态落到数据库。