跳转至

GraphRAG 操作指南

读者对象：知识库维护者、需要 RAG 能力的工程师
预计阅读时间：1.5 小时
版本：v0.1 | 2026-08-13

1. GraphRAG 简介

1.1 什么是 GraphRAG？

GraphRAG 是平台的知识库增强检索方案。相比传统「切块 + 向量检索」，GraphRAG 还会：

  1. 从文档中抽取实体与关系
  2. 构建知识图谱
  3. 结合图谱与文本进行更精准的问答

适合：技术规范、设计手册、标准文档、项目资料等结构化/半结构化知识。

1.2 适用场景

场景 说明
规范查询 「LLC 设计中对谐振电容的要求是什么？」
跨文档综合 综合多份设计指南给出建议
团队知识沉淀 将内部文档变为可问答知识库
Agent RAG 在 Agent 节点绑定知识库工具

2. 知识库模块入口

点击左侧 「知识库」，包含三个子模块：

子模块 功能
问答 基于个人/公共知识库对话
个人知识库 上传、管理私人文档
公共知识库 浏览已审核的团队文档

3. 个人知识库管理

3.1 上传文档

  1. 个人知识库 → 「添加内容」
  2. 步骤 1 - 上传：拖拽或点击上传
  3. 为每个文件选择 分类（默认或自定义）
  4. 步骤 2 - 数据处理：确认后触发索引构建

支持格式与限制：

项目 限制
格式 PDF、TXT、DOC 等
数量 最多 300 个文件
单文件大小 不超过 100MB
PDF 页数 最多 500 页

任务对话中上传还支持 docx、md、csv 等；知识库模块以界面提示为准。

3.2 文件列表

上传并索引成功后，文件列表显示：

  • 文件名、大小、类型图标
  • 所属 分类
  • 操作按钮（见下节）

双击文件可查看内容。

3.3 文件操作

操作 说明
日志 查看该分类的构建日志
重新构建 删除该分类下全部索引内容，仅重建当前分类
清空库 删除个人知识库全部内容（需确认）
分享至公共库 提交管理员审核
删除 删除单个文件

3.4 重新构建说明

重新构建 会：

  1. 删除该分类下已有索引
  2. 对该分类全部文件重新抽取与建图

适用于：文档更新后、索引异常时。

清空库 会删除所有个人知识库内容，操作不可逆，请谨慎使用。

4. 索引构建

4.1 构建流程

上传文件 → 选择分类 → 数据处理（index）→ 构建完成 → 可问答/看图谱

4.2 查看构建状态

  • 数据处理步骤界面显示进度
  • 文件列表 「日志」 可查看详细构建日志
  • API 层面对应 graph_rag?cmd=status

4.3 构建失败排查

现象 可能原因 处理
长时间无完成 文件过大或数量多 查看日志，分批上传
日志报错 格式不支持或文件损坏 换格式或修复文件
问答无结果 未构建或分类不对 确认索引已完成

5. 知识图谱

5.1 查看图谱

个人知识库 → 切换到 「图谱」 标签。

公共知识库也有独立图谱视图。

5.2 图谱内容

  • 节点：从文档抽取的实体（概念、器件、参数等）
  • 边：实体间关系
  • 支持交互式浏览（缩放、拖拽）

5.3 图谱的价值

  • 理解文档知识结构
  • 发现跨文档关联
  • 辅助验证索引质量（实体是否合理）

6. RAG 问答

6.1 知识库问答入口

知识库 → 「问答」 标签。

6.2 选择知识源

模式 说明
基于个人知识库 仅检索您上传的文档
基于公共知识库 检索团队公开文档

6.3 提问技巧

好的问题：

根据知识库，Buck 电路 CCM 模式下电感选型需要考虑哪些因素？

不好的问题：

电感

建议：具体、带领域上下文、说明期望答案类型。

6.4 在 Agent 中使用

建 Agent 时，在普通节点的 工具 中：

  1. 类型选择 「知识库」
  2. 选择对应知识库

Agent 执行时会自动 RAG 检索并注入上下文。

任务对话中也可使用 RAG 相关节点（视 Agent 配置而定）。

7. 分享至公共知识库

7.1 分享流程

  1. 个人知识库文件列表 → 「分享至公共库」
  2. 确认提示：需管理员审核，通过后才会公开
  3. 提交申请

7.2 审核

  • 管理员在 消息中心 收到「申请把文档分享至公共知识库」
  • 审核通过后，文档出现在 公共知识库
  • 全员可在「基于公共知识库」模式中检索

7.3 规范建议

  • 上传前去除敏感信息
  • 统一分类命名（如「Buck设计」「LLC规范」）
  • 定期更新并重新构建索引

8. 公共知识库

8.1 浏览

知识库 → 公共知识库 → 文件列表 / 图谱。

8.2 使用

  • 问答模式选择「基于公共知识库」
  • Agent 绑定公共知识库工具
  • 参考团队沉淀的标准与案例

9. 最佳实践

9.1 文档预处理

  • PDF 尽量文字可选中（非纯扫描）
  • 长文档按主题拆分分类
  • 文件名要有意义：LLC设计指南_v2.pdf

9.2 分类规划

建议按领域划分：

默认
Buck设计
LLC设计
PFC规范
器件选型

9.3 维护节奏

频率 动作
新增文档后 上传并构建
文档更新后 重新构建对应分类
每季度 清理过时文档，检查公共库质量

10. 故障排查

问题 处理
问答回答「找不到相关信息」 确认已 index；问题是否与文档主题相关
图谱为空 等待构建完成；检查文档是否有可抽取内容
分享后公共库看不到 确认审核已通过
构建日志报错 保存日志联系管理员

11. 延伸阅读