【免费下载链接】graphrag-workbenchInteractive 3D visualization of knowledge graphs generated by Microsoft GraphRAG. Explore entities, relationships, and communities with immersive visual analytics.项目地址https://gitcode.com/gh_mirrors/gr/graphrag-workbench点击查看免费下载GraphRAG Workbench 是一个开源的本地工作台可将文档转化为可交互的 3D 知识图谱其底层封装了 Microsoft GraphRAG 引擎。本文以新手视角完整讲解 GraphRAG Workbench 的 OpenAI 云端大模型接入方法API 密钥如何安全存储、密钥在构建流程中如何被使用以及常见报错的快速排查技巧。一、GraphRAG Workbench 的两种推理模式GraphRAG Workbench 提供两套开箱即用的模型预设二者可以同时保留、互不干扰预设特点默认模型Local / Ollama本地推理无 token 费用模型不出机器gemma4:latestembeddinggemma:latest768 维Cloud / OpenAI云端推理速度更快、抽取模型更强消耗 tokengpt-5.6-lunatext-embedding-3-small1536 维这两组绑定是工作台全局设置所有 GraphRAG 项目共享。每次索引构建时需要显式点击Run with Ollama或Run with OpenAI来指定使用哪一套。下图是 Projects 工作区构建引擎的日志会实时滚动显示在右侧 Terminal 中二、OpenAI 一键配置步骤整个配置过程不需要写配置文件全部在界面中完成打开Projects → Build providers切换到Cloud / OpenAI标签页配置界面源码见 ProviderSetupDialog.tsx填入你的 OpenAI API Key形如sk-...在 OpenAI 官方的 API Keys 页面创建按需修改两个模型名Completion model负责实体抽取、社区报告默认gpt-5.6-lunaEmbedding model负责向量化默认text-embedding-3-small其 1536 维向量宽度会自动与 LanceDB 表结构对齐无需手动设置点击保存即可。此时界面输入框中的 Key 会被立即清空只留下已保存的状态标记。 如果此时某次构建没有完成绑定工作台会自动在缺失的步骤处弹出配置窗口无需手动排查。三、API 密钥的安全存储机制 这是新手最关心的问题Key 填进去之后到底存在哪会不会泄露GraphRAG Workbench 在四个层面做了防护独立文件收紧权限Key 写入工作台根目录的.graphrag/providers.json。创建时目录权限为0700文件权限被显式chmod为0600——即只有当前操作系统账户能读写其他用户一律拒绝。相关实现见 providerConfig.ts 中的saveCloudConfig。与项目隔离永不进 Git该文件位于所有项目目录之外且被 Git 排除不会随代码仓库一起提交或被打包分享。浏览器侧拿不到明文状态查询接口app/api/providers/route.ts只返回keyStored布尔值和模型名API Key 本身从不回传给前端浏览器代码里看不到密钥明文。删除即彻底移除界面中移除 Key 会触发DELETE /api/providers服务端调用removeCloudKey直接删掉该配置块而不是保留旧值。四、构建时密钥如何被使用 ⚡保存之后Key 只在每次索引构建时由服务端临时解析为环境变量注入 GraphRAG 子进程核心逻辑在 providerConfig.ts 的resolveProviderEnv将GRAPHRAG_API_KEY、GRAPHRAG_COMPLETION_MODEL、GRAPHRAG_API_BASE等变量填入 settings.yaml 中的${...}占位符引擎配置文件本身不含任何密钥OpenAI 构建默认GRAPHRAG_CONCURRENT_REQUESTS 4个并行请求Ollama 为 1本地服务器串行执行反而更快可在.env中调整缓存按提供者物理隔离缓存目录名为cache/provider-sha256签名前12位签名由 provider 与模型组合计算确保本地模型的结果永远不会被回放到云端构建反之亦然若忘记填 Key 就选择云端构建会收到明确的CLOUD_NOT_CONFIGURED报错并自动弹出配置窗口。五、常见报错快速排查 构建期间引擎日志会实时 tail 到 Terminal。遇到致命级 provider 错误额度耗尽、Key 被拒、模型不存在时构建会立即停止并在终端中直接给出原因与恢复建议。高频问题对照如下报错特征原因处理方法429 insufficient_quotaOpenAI 额度/余额不足为项目充值或改用Run with Ollama重建401 permission间歇性并行请求过多被限流在.env中调低GRAPHRAG_CONCURRENT_REQUESTS模型找不到填了不存在的模型名回到 Build providers 检查模型名拼写CLOUD_NOT_CONFIGUREDKey 未保存重新在 Cloud / OpenAI 标签页填入并保存值得说明的是settings.yaml 中配置了指数退避重试最多 5 次可自动吸收 OpenAI 账户偶尔的BadRequestError抖动但AuthenticationError这类真坏了的错误被列入了不重试清单避免浪费时间反复撞墙。六、构建成果与成本提醒OpenAI 索引会把文档内容发送到云端token 消耗通常不小——大文档库建议先用小批量验证效果。构建完成后你可以在全屏 3D 图谱中检查实体、关系与社区结构下图展示了构建完成后的社区隔离与 Inspector 面板左侧社区报告由云端模型生成整体数据流为PDF → 本地文本抽取 → GraphRAG 3.1云端/本地模型→ parquet LanceDB → 本地 JSON 转换 → Three.js 3D 图谱。密钥与文档均保存在本地文件系统构建可随时取消关闭 Builder 也不会中断索引任务。小结GraphRAG Workbench 的 OpenAI 配置只需填 Key、选模型、点构建三步密钥以0600权限隔离在工作台配置中不进 Git、不进浏览器构建时由服务端按需注入兼顾了易用性与安全性。更多版本细节可查阅 CHANGELOG.md。赞分享【免费下载链接】graphrag-workbenchInteractive 3D visualization of knowledge graphs generated by Microsoft GraphRAG. Explore entities, relationships, and communities with immersive visual analytics.项目地址https://gitcode.com/gh_mirrors/gr/graphrag-workbench点击查看免费下载相关推荐PokeClaw接入云端大模型OpenAI兼容API配置与多模型热切换指南PokeClaw接入云端大模型OpenAI兼容API配置与多模型热切换指南 PokeClawPocketClaw是一款运行在 Android 手机上、能直人工智能大模型AI Agent本地部署GUI 自动化Lottie 动画导出到 Web 渲染完整指南AE 动画快速上网页Lottie 动画导出到 Web 渲染完整指南AE 动画快速上网页 设计师在 After Effects 里做好动画要原封不动跑到网页上靠手写动画或录视频前端图形学Denova 模型配置完全指南一键接入 OpenAI 与自定义 API 端点Denova 模型配置完全指南一键接入 OpenAI 与自定义 API 端点 Denova 是一个面向小说写作与 AI 角色扮演游戏的 AI 创作平台。要在其上一篇v-charts 快速开始Vue 2 项目中完整引入与按需引入的实战指南下一篇高阶组件实战:react-redux-jwt-auth-example中requireAuthentication路由守卫的实现原理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考