Files
DEMO-AGENT/docs/原型设计/1.9.知识库与治理台原型设计.md

4.6 KiB
Raw Blame History

知识库与治理台原型设计

1. 页面目标

作为整套原型的治理能力承载层统一展示法规知识、RAG 证据、字段标准、模板映射、责任人和飞书配置如何被维护,并明确支持完整 CRUD。

在最新版产品形态中,知识库 已升级为四个一级入口之一;同时仍允许从审核智能体、资料包和处理历史页通过治理入口快速打开对应对象详情。

2. 适用角色

  • 规则维护人员
  • 平台管理员
  • 注册资料平台主管
  • 演示讲解人

3. 治理台布局分区

建议采用“左侧治理对象导航 + 中部列表 + 右侧详情 / 编辑抽屉”的结构。

左侧对象导航固定包含:

  1. 法规规则包
  2. RAG 文档源
  3. RAG 切片
  4. 字段 Schema
  5. Word 模板与字段映射
  6. 责任人映射
  7. 飞书通知配置

4. 法规规则包 CRUD

4.1 列表字段

  • 规则包名称
  • 适用流程
  • 版本号
  • 启用状态
  • 最近更新时间
  • 维护人

4.2 必备操作

  • 新增规则包
  • 编辑规则包
  • 复制新版本
  • 启用 / 停用
  • 删除未生效草稿
  • 查看章节要求详情

4.3 原型交互要求

  • 点击规则包行,右侧打开章节树与要求项详情。
  • 点击“新增规则包”,打开表单弹窗。

5. RAG 文档源 CRUD

5.1 列表字段

  • 文档名称
  • 文档类型
  • 来源类别
  • 版本号
  • 入库状态
  • 切片数量
  • 最近同步时间

5.2 必备操作

  • 上传新文档源
  • 替换版本
  • 编辑元数据
  • 停用文档源
  • 删除失效文档源
  • 重新入库

5.3 原型交互要求

  • 支持按“法规 / 模板 / 业务资料”过滤。
  • 点击文档源查看切片预览和召回配置。

6. RAG 切片 CRUD

6.1 列表字段

  • 切片 ID
  • 所属文档
  • 章节
  • 片段摘要
  • 切片长度
  • 召回状态
  • 最近更新时间

6.2 必备操作

  • 新增手工切片
  • 编辑切片摘要
  • 合并切片
  • 拆分切片
  • 删除切片
  • 重建向量
  • 调整召回阈值

6.3 原型交互要求

  • 点击切片行,右侧展示原文预览和命中场景。
  • 支持“查看证据命中历史”的详情抽屉。

7. 字段 Schema CRUD

7.1 列表字段

  • 字段编码
  • 中文名
  • 字段类型
  • 是否可回填
  • 是否强一致
  • 启用状态
  • 版本号

7.2 必备操作

  • 新增字段
  • 编辑字段
  • 启停字段
  • 删除草稿字段
  • 复制 schema 版本

7.3 原型交互要求

  • 点击字段查看来源优先级和适用页面。
  • 支持切换“回填字段 / 强一致字段 / 全部字段”。

8. Word 模板与字段映射 CRUD

8.1 列表字段

  • 模板名称
  • 输出类型
  • 版本号
  • 占位符数量
  • 启用状态
  • 最近更新时间

8.2 必备操作

  • 上传模板
  • 编辑模板元数据
  • 编辑占位符映射
  • 启用 / 停用版本
  • 删除未发布版本
  • 预览模板

8.3 原型交互要求

  • 点击模板打开占位符和字段映射详情。
  • 支持查看“阻断条件影响哪些占位符”。

9. 责任人映射 CRUD

9.1 列表字段

  • 映射类型
  • 章节 / 风险类型
  • 责任角色
  • 责任人姓名
  • 部门
  • 飞书用户 ID
  • 飞书 Open ID
  • 飞书昵称
  • 是否启用通知
  • 启用状态
  • 备注

9.2 必备操作

  • 新增映射
  • 编辑映射
  • 启停映射
  • 删除映射
  • 批量导入映射

9.3 原型交互要求

  • 点击某条映射可联动查看受影响风险项或飞书卡片预览。

10. 飞书通知配置 CRUD

10.1 列表字段

  • 配置名称
  • 群聊 / 机器人标识
  • 消息模板
  • 触发原因
  • Web 链接模板
  • 启用状态
  • 最近测试状态

10.2 必备操作

  • 新增配置
  • 编辑配置
  • 切换消息模板
  • 启用 / 停用
  • 删除草稿配置
  • 发送测试消息

10.3 原型交互要求

  • 支持查看 interactive card 模板预览。
  • 支持查看最近一次回执记录。
  • 固定展示两类触发原因:task_completedtask_failed

11. 与业务页面的入口关系

各主页面的治理入口分配如下:

  • 资料包导入页RAG 文档源、章节点规则
  • 法规完整性检查页法规规则包、RAG 切片
  • 字段抽取页:字段 Schema、字段来源优先级
  • 一致性核查页:强一致规则
  • 风险预警页:风险规则、责任人映射
  • Word 回填页:模板与字段映射
  • 飞书通知视图:责任人映射、飞书通知配置

12. 演示话术重点

  • 强调这套系统不是一次性写死,而是可以被维护和演进。
  • 强调法规判断、RAG 证据、字段标准、模板映射和飞书配置都能被可视化治理。
  • 强调 CRUD 的存在,说明平台具备从 Demo 走向实际业务平台的治理基础。