Skip to main content

TorchV KB用户手册

版本历史

版本作者日期备注
beta v1.0.0卢向东(yuanwai@mengjia.net)、肖玉民(xiaoymin@mengjia.net)、厉杭波(lihangbo@mengjia.net)、范李军(fanlijun@mengjia.net)2024/12/31

一.引言

1.1 名词解释

本文将会提到以下中英文名词,在大部分段落可能会以英文名称代替:

  • TorchV AI:基于大模型的中间件和应用开发系统,包含知识源和索引存储,对接多类大模型,内部主要组件包括RAG、Agent等,提供应用中心和API对外发布和对接应用。可参考《TorchV AI用户手册》
  • TorchV KB:基于TorchV AI构建的知识协作系统,包括知识空间、知识页面、协作和分享等功能,使用AI加强知识协作能力,让协作更加高效智能。
  • 知识:在知识协作系统中,知识页面就是最主要的单元之一,本文中常用“知识”或“页面”来代替“知识页面”。
  • 页面:同上一条“知识”。

1.2 编写目的

本手册涵盖TorchV KB大模型知识协作系统的所有功能,包括架构说明、功能描述、使用、部署和维护,以及相关用户案例介绍,希望通过阅读本手册,可以让用户无障碍使用TorchV KB。

1.3 环境要求

浏览器:Chrome 100+/火狐(FireFox)/Microsoft Edge

1.4 读者对象

使用TorchV KB产品的使用人员,本文假设您已经获取了TorchV KB(在线版/本地版)使用权利。如还未获得TorchV KB使用账号,可在商务合作中沟通获取。

二.架构说明

TorchV KB是基于TorchV AI架构的产品,所以其天然包含了TorchV AI大模型应用能力,TorchV KB的整体架构图如下所示。

image-20241211174610054

图1:TorchV KB的架构示意图

上图可以分为四层,从下往上依次是:

  • 基础设施层:主要是带有GPU的服务器和网络设备等,另外就是大语言模型(LLM),在TorchV KB中一般选择开源大模型,常用的大模型如Qwen2.5-14B/32B/72B,具体参数规模会根据实际业务场景和硬件配置条件做适当选择;
  • 大模型应用能力层:该层在TorchV KB产品中属于PaaS或中间件,提供了RAG、OSS、Agent、多模态小模型、知识管理、应用中心(含开发者中心)等,可更大限度地发挥大模型的能力,提供较高的问答准确率。另外基于TorchV AI进行大模型应用开发会有完善的API、权限等开发者支撑;
  • 知识协作层:这是TorchV KB的功能主体,是一整套可视化可操作的系统,包含知识空间、知识页面、附件管理、反馈分享、协作、组织与用户权限、访问控制和AI知识问答等功能;
  • 应用层:基于下层的大模型能力和TorchV KB的知识内容,利用Agent构建各类知识应用,最基础的如知识问答、考试系统、评测系统、写作系统等。

需要明确的是,上图是一个整体,四层合并才是完整的TorchV KB架构,缺少TorchV AI的能力,TorchV KB将因为缺失大模型能力而缺少很多高级能力。

三.功能介绍

image-20241212113503750

图2:TorchV KB的主要功能

下面我们介绍TorchV KB主体的各项功能。

3.1 知识空间

在TorchV KB知识协作系统中存在两种知识空间:

  • 个人空间:和用户账号默认绑定的个人空间,在用户账号开通的一刻就存在;

  • 协作空间:是由多人组成的知识空间,TorchV KB中提到的空间更多是指协作空间。

3.1.1 个人空间

在TorchV KB中,每个用户都会默认有一个属于自己的“个人知识空间”,这个空间是该用户创建和上传的所有知识的集合,默认情况下其他用户无法查看、编辑该集合内的知识。用户可以选定知识,并通过分享方式让指定的用户或用户群参与该知识(页面)的查看和编辑。

3.1.2 协作空间

TorchV KB中更常用的是协作空间,区别于个人空间,这是一种多人空间。是由产品、项目、原有组织关系等主体组成的协作型知识空间,常见的知识空间有以下几类:

  • 组织机构:公司、部门、小组等都可以有自己的一个协作空间,可以基于他们的组织关系创建协作空间,如财务部门可以创建一个财务协作空间等;
  • 产品协作:可以单一产品(或某产品的某个分支)作为一个协作空间,将该产品涉及的知识聚焦在这里,空间成员可有参与该产品的市场营销、产品设计、研发生产和售后等上下游工作的各部门人员组成。如微软的Office 365就可以创建一个协作空间,空间成员包括参与Office 365的产研人员、市场销售人员、运营团队人员、售后客户人员等;
  • 项目协作:项目知识空间非常好理解,就是参与某个特定项目的所有人员。但在项目协作空间中,极有可能会出现客户方或第三方的成员。

以上是一些具体的协作空间案例,用户也可以创建更多类型的协作空间,如销售策略协作空间、售后协作空间等等。

知识空间-分享

图3:协作空间的预览图,因为TorchV KB支持 子页面嵌入,所以会形成页面树结构。

3.1.3 空间操作

个人空间中,该空间的用户拥有所有权限,除了可以分享内部的知识给其他人查看或操作之外,不能给其他人赋予任何权限。

而在协作空间中,首先会存在不同角色,如空间管理员、空间成员以及具备查看权限的临时用户。为了保证空间的简洁,不会存在过多相似主体的空间,默认情况下空间的创建是有系统管理员进行创建的,然后由系统管理员拉取空间成员,并赋权某一个或多个空间管理员。至此,空间的操作权限由系统管理员转交给空间管理员。

空间管理员的操作

空间管理员拥有非常大的空间管理权限,除了删除空间、冻结空间等高级别操作依然需要向系统管理员申请之外,具备空间的所有权限,除了空间成员的所有权限之外,空间管理员额外具备以下功能权限:

  • 空间用户管理:拉取和剔除空间成员,可直接拉取单个用户,也可以拉取组织内的部门或团队,如组织发生人员变动,新增/剔除人员也将在空间成员中被同步(成为/失去空间成员的资格),创建角色,为空间成员赋权,禁用/激活成员等;
  • 基本信息管理:如空间名称、描述、Logo、空间首页和空间快捷链接等编辑设置;
  • 安全策略管理:包括文档水印设置、内容复制/移动/导出设置、是否可评论设置、是否可分享设置、是否发布审批设置等。

空间成员的操作

空间成员默认具备本空间所有知识的访问权限,且对于自己创建的知识具备编辑和删除权限。

知识创建者空间成员有以下基本权限:

  • 邀请协作:可以邀请空间内其他成员对该知识进行编辑,也就是所谓的协作;
  • 发布知识:未发布之前是草稿,只有自己和协作者可见且可编辑,发布之后空间内所有成员可见。也可撤销发布;
  • 对外分享:对于空间外成员,分享一般只可进行查看和评论。分享方式包括直接分享和设置密码分享,可设置分享有效期,也可在有效期结束前提前取消分享;
  • 其他:对知识进行复制(主要作用是以现有知识为基础,创建分支,继续复制和扩写)、移动(移动当前空间的不同文件数位置,或移动到其他具有权限的空间)、导出、删除等,另外还包括查看关注者、收藏者。

非知识创建者空间成员的基本权限:

  • 具备空间内所有知识的查看权限;

  • 具备空间内所有知识的评论、关注、收藏和分享权限;

  • 可被邀请成为某知识的协作者;

  • 具备对空间内所有知识的AI检索问答权限。

3.2 知识页面

知识页面是承载知识内容最主要的载体之一,目前支持空白文档、表格等两种形式,此外还支持自定义模板创建。

3.2.1 页面编辑

image-20241213162541501

图4:页面编辑界面,三大操作空间“开始”、“插入”和“工具箱”。

页面编辑是知识页面中非常重要的功能,我们引入了富文本编辑器,主要包含以下三大类组件集:

  • 开始:包含撤销↩️、重做↪️、格式刷、清除格式,正文/标题1-6、字体、字号,加粗、斜体、删除线、链接、代码嵌入、下标、上标、分割线、任务列表、表情符号、高亮划线、字体颜色、强制换行,以及快捷方式的插入excel、xmind、流程图和pdf;
  • 插入:包含插入图片、视频、附件、引用、高亮块、代码块和表格;
  • 工具箱:使用excel、pdf、流程图和打印功能等,未来还可以加入更多宏。

整个编辑器中还包含了划词工具,可使用鼠标选择相应的段落、行和文字内容,出现划词工具条。功能包括上述提到过的主要编辑功能中的常用功能(如加粗、斜体、下划线、删除线和代码等),还有AI能力,当前已经具备归纳和翻译功能,后续还包括续写、润色和本地知识库问答等。

image-20241214140120103

图5:划词工具条,以上截图是开发版,缺少完整功能。

页面编辑采用自动保存策略,当用户有实际键入的情况下,停顿3秒时编辑器将进行自动保存操作。

关于知识页面何时会被索引的注意点

因为TorchV KB是基于大模型的知识协作系统,所以知识页面的内容将被提取、切块(chunking)和建立索引(embedding和倒排),但系统只会对已经发布的知识进行这一系列操作,而不会对草稿状态的知识进行索引,也就意味着用户无法对未发布的知识进行问答。

3.2.2 创建子页面

image-20241214164055800

图6:知识页面可以嵌套子页面,形成知识结构树

TorchV KB的页面可以多级嵌套,在左侧结构树中,鼠标滑倒相应的知识页面上方,就会在右侧出现“+”符号,可点击“+”新建子页面,该子页面位于当前页面内部,属于下一层级的知识页面。

在页面分享时,默认情况下不包含子页面,但分享者也可以选择是否包含子页面,及选择具体的子页面。但需要注意的是,子页面是不允许分享给别人进行编辑的。

在导出知识页面时,也可以选择“是否包含所有子页面”,如选择,则导出所有该页面及所有子页面。

3.2.3 多人协作

TorchV KB允许知识页面创建者邀请其他空间内成员共同进行知识协作。

image-20241214183153000

图7:知识页面分享和邀请他人共同协作编辑。

协作邀请

邀请方式是点击页面右上角的“分享”icon,选择第二个选项“获得链接的人,可编辑”。需要注意的是,知识页面的发布权限依然还是在创建者手上,其他协作者编辑的内容在未发布之前仅存在草稿中。

版本控制

一旦进入多人协作模式,有可能会造成页面内容冲突等情况,这时候用户可以通过版本控制查看各个版本之间的差异,对于页面创建者,有权限回滚到指定版本。

image-20241215221525266

图8:知识版本控制

3.2.4 其他
  • 页面信息展示

页面展示信息包括创建者、创建时间,以及最后修改人(有可能是协作者)和最后修改时间。

  • 知识标签

知识标签不是任意创建的,默认是由系统管理员创建基础标签,类似分类标签等;空间管理员创建更加细化的业务标签。这样设置最主要的原因是避免标签混乱,影响后续维护。当然,考虑到不同企业实际的业务运作模式,在管理后台也可以将标签创建权限开放给任何人。

创建者在创建/编辑知识的时候,可以选择设置该知识页面的知识标签,方便后续的归档、检索等操作。

  • 版面设计

页面主体布局编辑,可进行页面模板简单编辑,如单栏、双栏、三栏布局,图文布局等。

  • 在文中提醒联系人

在页面编辑中支持使用“@”选择联系人,指定接收人,接收人可在站内信中收到信息。联系人展示的是空间内成员表。

3.3 附件管理

每个知识页面都可以内含附件,用户可以选择在上传附件的时候是否展示部分附件内容(仅限于PDF、Word、Excel、PPT等格式,不包括zip等压缩包格式)。

但是如果用户想快速找到目标附件,有两种方式可以进行快速查找:

  • 附件管理器:可在权限范围内,浏览全局/某空间/某页面下的所有附件,类似微信聊天下的文件浏览功能;
  • 附件检索:如果用户知道想要查看的附件名称、名称关键词、上传者等信息,也可以使用右上角的检索功能进行快速检索,找到目标附件。

检索功能会在检索章节进行详细描述,这里主要介绍附件管理器的功能。

附件管理器与网盘相似,管理着所有在页面中上传或单独上传的附件,单独上传的附件也会生成一个知识页面,内容包括附件内容的摘要,默认不会在知识列表中展示。所有附件支持按文件名、类型和上传时间进行排序。

几乎支持所有文件类型,其中可预览的文件类型包括:

Word/Excel/PowerPoint/PDF/WMARM/WAV等

为了节省存储空间,避免大量页面重复添加相同附件,系统会默认通过checksum特征值引用已存在的相同附件,而不是在用户上传时重新上传完整的附件。附件管理器的一大优势是可以对附件进行双向管理,可在附件详情中查看该附件被哪些页面引用。如果某附件的其中一个引用页面被删除,或者用户删除该页面中的这个附件,默认情况下如果该附件还存在其他页面的引用,则只是断开该页面与该附件之间的引用关系,而不是真正删除该附件。

3.4 互动分享

TorchV KB知识协作系统最主要的价值之一就是协作,协作不仅仅只有共同编辑知识页面,这些都是知识生产环节。协作的另外一大特点是互动,比如评论,在实际使用环节中非常重要,我们可以举例说明:

假设有一客户是生产商业路由器的企业,简称A,A服务了全国5万多家酒店、宾馆和商场,为这些场所提供路由器产品和组网方案。A在全国各个城市派驻了1000多名维护人员,负责各个客户设备的维护。在真实业务场景中,这些维护人员几乎每天都会遇到客户售后问题,他们穿梭于各种酒店、商场,然后负责维护A生产的各种类型设备。

这里最大的问题是很多问题并不是这些维护人员凭经验和直觉就能解决的,他们需要寻求帮助总部研发生产部门的帮助,特别是在针对各种繁杂的产品型号时,需要有各产品线的同事提供技术解答、驱动升级、bug修复和解决方案共享等技术支撑。在这种情况下,如果仅仅是通过电话沟通,或者通过微信、钉钉等IM进行沟通,效率会很低,而且总部需要把很多研发人员的工作往“客服”的方向转移,那肯定不是企业想要看不到的。

TorchV KB知识协作系统为A企业的各产品大类建立知识空间,为每个产品型号建立产品知识页面。外部的维护人员遇到特定型号的产品维修问题或组网问题,首先会通过AI问答寻找解决方案,或通过原文引用链接进入具体的产品知识页面查看该产品的问题集。这些问题集是所有维护人员在之前遇到的过问题的解决方案,一般该型号的产品维修问题都能被找到并解决。如果已有的产品问题集无法解决该维护人员当下的问题,则他可以在该型号的知识页面下面进行评论留言,并可以@作者。该产品型号的知识维护者一般也是该产品的开发者,他在收到站内信/邮件提醒之后,会对该问题进行研究并给出解决方案。并在解决问题之后,将该问题和解决方案加入到该知识的问题集中,为其他维护人员服务。

随着知识积累越来越多,TorchV KB在A企业中协调研发和售后两个体系的作用越来越明显,同理,这样的多个体系之间的协同还可以是研发和销售体系之间的协同,或者运营与研发之间的协同。销售侧会实时了解目前的产品研发情况,推荐给客户更好更新的产品,研发侧可以更加了解市场信息和客户实际使用反馈,协作的各方都会在知识协作中受益。

以上例子可以看到TorchV KB在企业协作中的重要性,下面我们介绍一下互动分享的一些具体功能。

3.4.1 收藏与关注

image-20241215151554559

图9:知识页面的收藏和关注。

收藏的icon是星星,关注的icon是红心,在这里我们非常希望用户了解它们之间的区别。

收藏和关注是一对常见的互动功能,因为知识协作平台的内容是会不断更新的,所以用户需要知道它们的作用是有比较大差距的:

  • 收藏重点在于过去。用户收藏某个空间或者知识页面,目的是为了以后需要时再次查看当前状态的知识;
  • 关注重点在于未来。用户关注某篇知识页面,目的是为了获得该知识持续的更新内容,所以被用户关注的知识,默认情况下该知识产生更新变动,会将更新信息通过站内信/短信/邮件等方式通知给关注者。

当然,为了更便于理解,用户可以侧重于对“关注”的理解,如果您想获得某篇知识页面或者某个知识空间的更新信息,那么请使用“关注”

在TorchV KB中,空间管理员或内容创建者可以主动选择添加该知识文章的关注者,当然被选择添加的关注者可以自己取消关注。

3.4.2 点赞和打分

点赞和打分属于相对较弱的互动行为,但对于维护知识内容的质量非常有帮助。

image-20241215152900015

图10:点赞和打分,在这里只展示点赞,还未展示打分

点赞和打分的影响

为了让用户在知识问答和检索过程中得到更有效的答案,系统会设置一个综合的排序算法对答案进行排序。该排序算法会不断优化,目前可以给出其中最重要的几个影响因素,以下具体分值只是参考值,并非真实系统实际分值:

  • 相关度:根据混合检索与Rerank,与用户问题相关度得分最高的答案会被排在最前面,一般相关度得分的取值在0~0.99之间。相关度在整个算法中是最重要的因素;

  • 知识质量:知识质量取决于用户点赞数/阅读量,在相关度最高的几个答案中,为每个答案增加0~0.05的分值。也就是说,在相似度差距小于0.05的两个答案之间,知识质量会起到重要影响;

  • 分享引用:分享引用包括知识的分享次数、被其他知识引用的次数等,也和阅读量相除,分值保持在0~0.02的分值之间。答案的相似度得分加上知识质量得分之后,如果两个答案之间差值小于0.02的情况,会产生重要影响。

3.4.3 分享

知识空间-文档详情-分享

图11:页面分享的示意图,为了展示完整的分享形式,这里同时展现了四种分享方式。

在了解分享功能之前,我们需要先了解一下组织的概念。最大的组织一般是公司,再往下可能是一级部门、二级部门、小组等,当然每个公司的组织架构都存在差异,所以我们这里所说的组织一般指的是公司内部,分享功能的一个分界线就是组织内和组织外。

系统允许空间内的成员将知识页面已查看的权限分享给组织内的其他人,但只有页面的创建者或协作者拥有将页面以编辑的权限分享给组织内其他成员的权限。如果要将页面分享给组织外的人,也就是分享给互联网的所有人,则需要加上访问密码保护和有效期。具体的权限可参见下表:

分享方式允许执行该操作的用户分享范围
分享查看当前页面所在空间的所有成员(默认具备当前页面的查看权限)组织内的其他成员
分享查看当前页面和子页面所在空间的所有成员(默认具备当前页面和子页面的查看权限)组织内的其他成员
分享编辑的创建者或协作者(默认具备编辑权限,无法分享子页面编辑权限)空间内的其他成员
互联网所有人可访问所在空间的所有成员(默认具备查看权限,无法分享子页面查看权限)组织内和组织外的所有人

表1:页面分享方式、权限和范围。

另外需要注意的是,使用互联网所有人可访问的分享方式将页面转发给组织外部的人员之后,其无法再继续转发,且分享者可以在有效期内提前停止分享。

以上介绍的都是知识页面的分享功能,附件的分享功能与页面类似。

空间管理员可统一控制页面分享的权限,包括空间内的知识页面是否可以对互联网分享,分享是否需要审核等。知识页面创建者也可以对页面的分享权限进行设置。

3.4.4 评论

在本章开头的案例介绍中,已经提到评论是知识协作的另一个非常重要的方法,是知识消费者向知识生产者反馈的主要路径。

评论区在每个知识页面的底部,默认情况下获得查看权限的成员(或外部人员)都可以对知识进行评价。对于空间成员,还可在评论中使用“@”提醒联系人。在用户提交评论之后,知识创建者和协作者将会在站内信/短信/邮件等处收到提醒。

页面创建者可以设置页面是否可被评论。

image-20241215210359947

图12:评论

3.4.5 站内信/通知

工作台-@和评论

图13:站内信具备五种类型的消息。

站内信是最基础也是最常用的消息通知方式,另外的通知方式还包括短信和邮件,可有系统管理员根据企业具体情况进行配置。

通知分为两个等级,紧急通知标准通知紧急通知在右上角的小叮当上会显示红色的数字,也可以同时设置短信或邮件的通知方式;标准通知在右上角的小叮当上只会显示红色,没有或增加数字。具体如下表所示:

通知级别通知形式场景说明
紧急通知带有数字的站内信通知/短信/邮件被@、被评论、私信、待我处理、审批通知、关注的知识更新等
标准通知不带数字的小红点站内信通知空间动态更新、被点赞、被关注和系统通知等

表2:通知的两种级别

3.5 访问控制

TorchV KB具备完善的组织架构、用户和权限等功能,系统首先支持AD、LDAP等认证方式实现单点登录,可从钉钉、企业微信等常用企业办公软件中导入组织和用户。

除了外部导入,系统本身也可以新增组织和用户,新增的用户可以通过手机验证码登录系统,并在个人中心设置个人密码(用户名默认是手机号码,用户可进行修改)。系统管理员可设置强密码验证策略,如设定密码复杂度(比如包含大写字母、数字和特殊符号等,以及重复字符限制)、密码有效期(提醒)等。一旦发现某些账号可能存在被盗用的情况,系统管理员也可以在后台开启二次登录验证,目前的二次登录方式仅限于短信验证码的二次登录。

用户也可以通过忘记密码功能,通过手机短信和邮箱自助找回密码。

访问控制的另外一种升级形式是IP白名单控制,还可以与MAC地址强关联。

3.6 知识问答

3.6.1 知识问答架构

image-20241215225340410

图14:知识问答基于大模型RAG技术和知识库的内容。

知识问答功能可以认为是TorchV AI的RAG能力和TorchV KB的知识数据的结合,在登录系统后任何地方都会存在一个带有“ai”字样的蓝色icon,点击即可进行知识问答。当然,AI能力更是无处不在的,使用鼠标对系统中的内容进行选择,也会在光标停留处显示AI功能的tips,可进行翻译、RAG问答等操作。

image-20241215230627316

图15:右下角的蓝色icon是打开AI知识问答的最直接入口。

3.6.2 知识问答窗口

知识问答窗口默认是居右的主功能区30%宽度的弹出框,可在下方输入问题进行问答。

image-20241215232850789

图16:知识问答展示

在知识问答弹出框的窗口顶部,有大模型选择下拉列表,以及新建会话、参数配置和全屏展开等功能icon。中间大部分区域是问答区,最底部是问题输入区域,包括知识库检索开关(如果是关闭状态则直接对大模型进行提问)和问题提交按钮。

问题提交之后,中间的问答区域会流式显示答案,点击答案下方的知识引用会展开原文引用,如知识页面/PDF/Word/HTML等的原文,可点击右侧的箭头icon收起。

image-20241215235824068

图17:全屏展开状态。

3.6.3 TorchV KB问答优势

通过TorchV KB知识协作系统进行RAG知识问答与传统的RAG问答相比,存在五大优势:

  • 问答更准确:区别于传统RAG面临五花八门的知识文档,使用TorchV KB知识协作系统生产和整理的知识内容在格式更清晰和标准内容解析更准确元数据更完整,所以在问答准确率比传统RAG的准确率普遍更高;
  • 知识更新鲜:传统RAG采用文档上传并索引的方式进行问答,知识文件的生产和使用往往不是同步的,中间极有可能存在较长时间差,知识的新鲜度下降。而使用TorchV KB生产的知识,一旦发布即可被系统索引化,直接就可以在问答中被使用,从知识生产到知识应用仅需一瞬间。比如用户刚刚在TorchV KB中发布新产品的特性,即可在所有知识消费者的问答中出现,体现了企业知识高效协同和利用的特性;
  • 知识维护更高效:传统RAG的知识以文件为主要载体,用户更新知识的时候需要先删除原有过期的文件及其索引数据,然后重新上传新文件,在这个过程中极易出现忘记删除原有文件的情况,造成知识库中存在相互矛盾的内容,影响问答准确率。使用TorchV KB则可以有效杜绝此类问题。TorchV KB的采用以下方式对知识进行高效管理:
    • 知识空间和标签无惧海量知识,让知识维护更有序;
    • 组织、角色和访问控制,让知识管理更安全
    • 协作、互动,让知识生产更高效
  • 工具多样性:支持流程图工具、思维导图、甘特图、日程表、CRM和其他知识组织工具,在传统RAG系统中,系统很难理解这些工具的知识组织方式及表示的业务逻辑。而使用TorchV KB提供的以上工具生产的知识内容,可被系统完美解析和问答;
  • 知识更集中:TorchV KB可以连接钉钉、企业微信、飞书等办公软件,也可以对接简道云、泛微等各类OA系统,让知识同步流向知识协作系统,解决企业知识分散导致无法有效使用的问题,并可通过强大的权限控制系统保证知识的安全。

3.7 用户权限

该板块主要包括用户管理、组织架构管理、团队管理、角色管理和临时角色管理等功能。

3.7.1 组织创建

image-20241216113207418

图18:组织架构创建

组织架构的内容包括最顶级组织——公司/事业单位的创建,其下属的部门创建,如果有集团公司,则顶级组织为集团公司。这里的组织和部门选项,更多是为了后续在显示上的icon有区别。

image-20241216113634119

图19:组织部门的批量导入,可先下载模板,后续会增加与其他主流系统同步的方式。

对于组织内的部门,也可以使用excel进行批量导入,批量导入格式如下:

image-20241216113811063

图20:组织部门的批量导入excel模板。

3.7.2 团队管理

团队也是一种组织,和部门属于同一级别,但不同的是,团队组织形式更加灵活。如果说部门是一种自上而下的带有行政性质的垂直结构的话,那么团队更像是超越部门的一种扁平结构。常见的团队包括产品团队、项目团队、市场调研团队等,团队成员可以来自于各个不同部门,为某一专项业务组织在一起的临时组合。

与部门不同,团队有以下几个特点:

  • 一个用户可属于多个团队;
  • 团队成员可以来源于不同部门,甚至可以来源于不同组织(公司);
  • 团队更类似于聊天工具里面的群组织,不支持多层穿透,举例来说就是大团队的领导不默认就拥有所属子团队的权限。
3.7.3 用户管理

image-20241216143237447

图21:用户创建。

用户创建有系统管理员完成,用户类型分为正式员工、实习员工和外包员工,可分别设置不同等级的默认权限。系统支持批量导入,和组织架构批量导入一样,也是先下载excel模板,或者对接其他第三方系统进行导入。

image-20241216145833371

图22:批量操作

系统支持对人员进行批量操作,包括批量变更组织、批量禁用/启用、批量删除等操作,列表标题栏的“...”即可进入批量操作模式,需要主要的是,该功能仅限于系统管理员或该空间下的空间管理员使用。

3.7.4 角色管理

此功能仅限系统管理员角色可以使用,系统管理员点击右上角头像右侧的向下小箭头,可展示下拉列表,点击“进入管理后台”。如果您是系统管理员,则可看到完整后台菜单,如下图所示:

后台-系统管理员-功能权限

图23:角色配置,权限分为菜单可见权限和操作权限。

系统管理员

系统默认只有超级管理员(系统管理员/租户管理员)角色,具备完全权限的角色。系统管理员可以创建更多非完整角色,如空间管理员、空间可编辑成员、空间仅查看成员等等。

系统管理员具备全局权限,包括创建/删除空间,设置备份/还原/安全策略,设置组织架构,创建和导入系统用户等等。

角色模板

除了系统在初始状态下就创建的最高等级权限“租户管理员”(或超级管理员)之外,这里创建的其他任何角色都可以被认为是角色模板,如我们可以创建“空间管理员”、“空间可编辑成员”和“空间可查看成员”等,都属于角色模版。

当系统管理员真正创建了一个空间,拉取成员,并将这些角色赋予给相应的人员时,这些角色就会在该空间内进行复制。请注意“复制”两个字,因为这些角色在该空间内的权限是可以被调整的,调整这些角色权限的人是系统管理员,或者具备“空间角色配置”菜单权限的用户。在空间内调整的角色不会反向影响系统级别的角色(模板)。

image-20241229204152096

图24-1:角色的分配

空间级别角色

空间级别角色权限最大的是空间管理员,由系统管理员指定。空间级别角色,主要分为以下几类(注意,各企业可根据实际情况制定自己的角色):

  • 空间管理员:拉取/剔除空间成员、设置空间成员角色、设置空间配置(如是否可导出知识、是否设置导出水印、发布是否需要审核等),空间管理员可以赋予其他成员的哪些角色是由系统管理员决定的。空间管理员本身也具备创建知识和普通成员的权限;
  • 空间可编辑成员:可编辑成员的权限是由系统管理员规定好的,但如果系统管理员给予空间管理员调整角色权限的权限,那么空间管理员可以进行调整。默认情况下,可编辑成员所创建的知识有编辑、发布、删除、邀请协作者等权限,在分享知识的时候可以赋予空间内其他成员编辑权限,即知识协作;
  • 普通成员:默认情况下,具备空间内所有知识内容的查看权限,可参与知识页面的评论、关注、收藏、导出和分享(仅限查看权限)等功能,可被知识创建者邀请成为协作者。但这些权限的配置可由系统管理员进行设定,每家具体的客户企业可以自行配置;
  • 临时成员:一般是组织外的用户,被空间管理员邀请,可使用手机号码注册进入空间,只有查看、评论、点赞和收藏等权限,无分享和导出权限。这些权限的配置可由系统管理员进行设定,每家具体的客户企业可以自行配置。

可以通过以下表格总结以上权限的默认配置:

角色权限
系统管理员创建知识空间、配置其他权限、给空间赋管理员、系统级别参数配置、组织架构和用户管理
空间管理员空间配置、空间成员和角色管理、其他普通成员的权限
空间可编辑成员空间内所有知识查看、创建知识、对自己创建的知识可邀请协作者、发布、分享(含编辑权限)、收藏、关注、导出等
普通(仅查看)成员空间内所有知识查看、评论、关注、收藏、导出和分享(仅限查看权限)
临时成员查看、评论、点赞和收藏,无分享和导出权限

表3:常见的角色和权限,除了系统管理员之外,其他角色均可进行调整,由客户企业自行调配。

页面权限

页面权限比较特别,是独立于上述权限之外的。页面权限默认是无限制,但也可以设置为“限制编辑”和“限制编辑和查看”这两种权限。

如果空间内有权限创建知识页面的成员在创建页面时选择了“限制编辑和查看”,在默认情况下,空间内的成员(包括空间管理员)均无法查看和编辑该知识页面。只有创建者邀请了指定人员之后,被邀请人员才有权限查看和编辑该页面。

为了易于理解,可将该功能类比于朋友圈权限的私密、只给谁看和公开等三种权限。

如何赋予角色

在系统层面,角色一般可以在管理后台的人员列表里面进行单个或批量赋权。

在空间层面,可以选择的角色首先已经是系统角色的子集,是由系统管理员指定给空间的。空间管理员可以在创建空间之后,点击空间右上角的“...”,在展开的下拉列表中点击“更多设置”,找到左侧菜单的“权限”,为空间成员赋予角色。

3.7.5 临时用户和角色

临时用户和角色在上一节中已经提到过,这里需要补充的是系统允许创建外部关联组织,来统一管理这些临时用户,进行统一赋权。

image-20241216195804547

图24:关联企业

3.8 统计分析

image-20241216200212183

图25:统计分析

TorchV KB的统计分析相对比较简单,主要指标如下:

分析类别
知识贡献度分析根据用户、用户组、标签等维度统计知识贡献度,以积分形式体现,可按照时间段统计,支持导出
知识增长率分析根据空间、标签、用户组等维度统计知识增长率,可按照时间段统计,支持导出
知识访问量分析支持知识访问量统计,空间、页面访问量,用户、用户组访问量,可按照时间段统计,支持导出
知识热度分析热点知识统计展板,展现系统内的热点内容,如热点空间/页面、热点地图、热点专家、热点问答、热点团队、热点活动等内容
附件热度分析针对附件支持按照预览量、下载量统计,可按照时间段统计,支持导出
空间基础信息统计支持知识空间数据统计,支持查看空间下页面总数、本周新增页面数量

表4:统计分析指标

3.9 知识应用

image-20241216205217707

图26:应用=工具+内容+业务流程

3.9.1 知识应用要素

在AI时代,一个对企业和用户有实际价值的应用,必然是可以帮助用户完成端到端业务的,而要完成端到端,需要有“智力+数据+业务流程”。但在现阶段,也不是任何应用都可以体现出应有的价值,而是需要考虑以下几个因素:

  • 大模型能力:主要逻辑推理能力和RAG的准确率,是可以认为是一种工具;
  • 内容:内容就是数据,保证数据的干净和实时更新;
  • 业务流程:有工具和数据之后,应用还需要去适应用户的业务流程或使用场景。
3.9.2 知识应用案例

以下是知识应用的一些案例:

image-20241216214101234

图27:知识应用的一些例子。

3.9.3 知识应用开发

TorchV KB提供完整的API,包括TorchV AI的问答对话API、知识维护API,以及检索API等,便于外部开发者基于“AI工具+内容数据”来开发适应特定业务流程的应用。以下是API一览:

image-20241216214848582

图28:API一览

Enjoy!