# 谷雨 G2rain 知识库 v1.0.0：从知识运营到带来源的问答

企业内部有操作手册、产品文档和客服 FAQ，但把文档接入模型只是开始。内容更新后如何审核，哪个版本可以用于回答，答案依据来自哪里，都需要明确的管理流程。

谷雨 G2rain 的知识库服务 g2rain-knowledge 与配套运营端 g2rain-knowledge-app 发布首个稳定版 v1.0.0，围绕知识接入、版本管理、审核处理、受控发布与效果验证提供一组前后端能力，面向知识运营、客服辅助和 Agent 知识接入场景。

本文介绍发布范围与体验方式。版本验证记录日期为 2026-10-19，完整技术发布说明见文末链接。

# 先体验知识问答与平台主应用

演示入口	地址	用户名	密码
知识对话	打开知识对话演示 (opens new window)	`admin`	`admin`
平台主应用	打开主应用演示 (opens new window)	`admin`	`admin`

可以从已有知识出发连续提问，观察回答中的参考来源，再结合知识运营页面理解版本与发布信息。

知识问答界面：连续提问并显示入门指南作为知识参考

本次服务端支持文件与 FAQ 两类知识，以及分类、标签、主题和版本管理。运营端按“知识内容 → 版本 → 审核 → 处理 → 发布 → 效果验证”组织入口，把内容维护与使用状态连接起来。

知识版本抽屉提供内容、审核、处理结果和切片等入口，同时支持原文受控下载。运营人员可以围绕同一份知识查看版本号、发布状态、标签与源文件。

知识版本管理界面：版本信息、发布状态、源文件与审核入口

知识内容以草稿提交审核，审核后进入处理，再执行版本发布或回滚。服务使用 Docling、Embedding、Milvus 与可选 Rerank 组织检索处理链路。

MySQL 维护知识元数据与发布状态，Milvus 作为可重建的检索投影。这样的职责划分让知识是否可用由业务状态决定，避免仅以向量索引中存在内容作为发布依据。

面向调用方，两个接口分别承担证据与回答职责：

运营端同时提供问答和检索效果验证页面，方便在发布后检查内容能否被检索，以及回答是否符合预期。

知识库属于 G2rain 的业务域扩展。运营端使用 Vue 3、TypeScript、Vite 与 qiankun，支持独立运行与主壳集成；集成模式通过 Auth Bridge 获取 Token。

页面和按钮展示配合平台资源，实际接口访问仍由 Gateway 与后端校验。知识服务结合入口准入与租户隔离判断访问边界，业务数据归属不能只靠前端隐藏按钮保证。更多关系可阅读企业权限模型。

对于 Agent，知识检索证据提供了可供对话编排消费的业务接口。中央集成设计约定 Runtime 通过检索契约请求证据，不直接读取知识数据库或向量索引。跨服务调用身份、权限传递、引用和失败处理仍需按实际集成验证，不能由单项目发布直接推定全部 Agent 场景已经完成。

执行追踪示例：用户请求、知识问答与结果路径

以上截图是独立示例，展示可见交互，不代表同一次请求或全部场景的验收结果。

项目	构建与运行条件
知识库服务	JDK 25、Maven 3.9+；配置 MySQL、知识文件持久化目录、Docling、Milvus 与模型服务
知识库运营端	Node.js 22+；按锁文件安装依赖并构建，连接可用的 IAM、Gateway、Basis 资源与知识后端

运营端支持独立运行，不等于脱离平台依赖的离线演示。本次两个项目通过 GitHub 发布源代码快照，不同时提供 Maven 制品、npm 应用包、Docker 镜像或独立安装包。

发布记录中，维护者于 2026-10-19 确认服务器端验证通过；具体环境清单与操作日志未随记录提供。服务端本地 mvn clean verify 通过，40 项测试无失败；运营端 Vue / TypeScript 检查和生产构建通过，并完成独立目录按公开锁文件安装依赖后的再次构建。

当前仍需关注多实例任务的持久输入快照、租约代次、运行中协作取消，以及完整下线和对账恢复等延期事项。部分通用保存接口仍有字段白名单收紧项；资源生成工具也不生成完整 API endpoint 清单。部署、发布与回滚应结合当前接口和运维说明执行，详见两个项目的完整发布说明。

欢迎通过社区讨论 (opens new window)分享知识问答场景，或联系维护者交流接入与项目合作。