共享知识库
产品概述
产品简介
DeepWorks 共享知识库用于将团队内的制度文件、项目文档、业务资料和历史成果,统一加工为可检索、可维护、可治理、可被 Agent 调用的共享知识资产。
共享知识库以项目空间作为协作隔离边界,以知识库作为知识资产单元。用户可以在项目空间中新建、搜索、管理多个知识库,并在知识库内完成资源管理、维基知识治理和 Agent 会话调用。
产品价值
产品三层能力层层递进,分别解决三类痛点:第一层解决**“散”—资料碎片化,第二层解决”乱”—知识口径不一致、来源不可追溯,第三层解决”死”—知识资产用不起来**。项目空间、权限管控和数据血缘贯穿三层,保证团队知识既能协同维护,又能可信审计。
第一层:知识沉淀 —— 让碎片材料成为体系知识
团队日常产生的项目文件多为孤立的非结构化信息,难以形成体系化知识。共享知识库支持批量上传文件和文件夹、自动解析分片,并可将原始资料编译为结构化 Wiki 词条。碎片材料由此沉淀为可搜索、可维护、可复用的团队知识体系。
第二层:知识理解 —— 让 Agent 读懂业务,而不只是读到文字
普通共享文档往往只解决存起来,难以保证知识准确、关联和可追溯。共享知识库支持维护 Wiki 词条、查看版本历史、通过维基图谱理解知识关联,并借助数据血缘检查资源文件与 Wiki 页面之间的生成关系;同时可通过分块设置和检索测试验证知识召回效果。团队知识由此从松散资料升级为口径统一、链路清晰、可审计的知识资产。
第三层:知识调用 —— 让知识资产走出后台,进入工作现场
沉淀成型的知识资产若局限在系统内,就难以融入日常项目流程。共享知识库支持在会话中通过 @指令唤起知识工作区,智能体依托 RAG 与 Wiki 词条求解复杂项目业务问题,并在结果中展示来源。由此打通从知识资产到智能问答的应用链路,使沉淀的知识持续支撑项目研判与决策。
适用角色
| 角色 | 主要任务 | 常用入口 |
|---|---|---|
| 知识管理员 | 上传资料、维护资源和管理维基知识 | 资源管理、维基知识 |
| 业务使用者 | 检索知识、查看 Wiki、通过 Agent 调用知识 | 全局搜索、维基知识、Agent 会话 |
| 知识复核者 | 检查数据来源、版本历史、血缘和知识质量 | 维基知识、数据血缘、知识库设置 |
| AI 任务使用者 | 在会话中显式选择共享知识库并核验回答来源 | 会话输入框 @知识库 |
名词解释
| 名称 | 说明 |
|---|---|
| 共享知识库 | Deepology 面向团队协作与统一治理的云端知识库能力 |
| 项目空间 | 共享知识库的协作隔离单元,用于承载多个知识库及成员权限 |
| 知识库 | 知识资产管理单元,用于承载资源、Wiki和检索配置 |
| 资源管理 | 管理原始文件、文件夹、解析状态、预览和批量操作的工作区 |
| 维基知识 | 从资源内容生成的结构化知识页面,支持索引、图谱、血缘和版本治理 |
产品介绍
共享知识库的使用可概括为三个递进步骤:空间沉淀、治理验收和会话调用。
第一步:建立项目空间并接入团队资料
目标:将分散在团队中的制度文件、项目文档、业务资料和历史成果,沉淀到统一权限边界内的共享知识资产。
- 创建或选择项目空间,按团队、部门或业务域划清知识边界;
- 新建知识库,用于承载资料、Wiki和检索配置;
- 上传文件或文件夹,系统完成解析和分片,并按配置生成可检索、可追溯的维基知识。 第二步:治理并验收知识成果
目标:确认知识内容完整、准确、可搜索、可关联、可追溯,并符合团队统一口径。
- 在资源管理中检查解析状态,修正知识片段,并控制片段是否参与检索;
- 配置 Wiki 提取重点和分块规则,并通过检索测试验证知识能否被正确召回。
- 在维基知识中维护词条、版本、图谱和数据血缘,确认知识来源链路完整; 第三步:在 Agent 会话中调用共享知识库
知识验收完成后,返回 DeepWorks 会话输入框,输入 @ 或点击选择任务资源,进入知识底座 → 共享知识库,选择要使用的项目空间和知识库。
智能体将基于所选共享知识库回答问题、分析内容或执行任务。用户可在结果中核对知识来源和使用范围;如果发现知识缺口,可将继续产生的业务结论、项目经验和新的资料再次沉淀回知识库,形成持续更新的团队知识闭环。
功能模块总览
| 功能模块 | 功能介绍 |
|---|---|
| 项目空间主页 | 用于管理项目空间、查看知识库总览、全局搜索和进入项目空间管理 |
| 资源管理 | 用于管理知识库原始资料、文件夹、上传、预览、解析和批量操作 |
| 维基知识 | 用于管理 Wiki 页面、维基索引、维基图谱、数据血缘、编辑和版本历史 |
| 知识库设置 | 用于维护知识库基础信息、自动编译、Wiki 设置、分块设置和检索测试 |
| Agent 会话调用 | 用于在 DeepWorks 会话中选择共享知识库并调用知识能力 |
项目空间主页
项目空间主页是共享知识库的组织入口和协作边界。项目空间主页不直接加工资料,而是负责空间选择、知识库定位和基础治理。
操作:打开 DeepWorks;在应用侧栏点击知识中心;在选择页点击共享知识库卡片进入知识库。
结果:页面展示项目空间导航、项目空间主页标题、全局搜索入口、知识库总览、知识库卡片和新建知识库按钮。每个知识库卡片显示名称、简介、最近更新文档和内容统计。
注意:进入共享知识库前需要先登录 DeepWorks 账号,并具备对应项目空间访问权限。
企业知识中心入口

项目空间主页知识库总览

项目空间
新建项目空间
功能描述:新建项目空间用于为不同团队、部门或业务域建立独立协作边界。适合在项目制交付、部门知识治理或专题知识沉淀时使用。
操作:点击项目空间主页左侧边栏+即可新建项目空间,填写必填的项目空间名称,按需填写项目空间介绍并在项目空间成员与权限中选择成员或部门,点击新建项目空间。
结果:项目空间创建后出现在左侧常用项目空间列表中,主页面切换为该项目空间的知识库总览。
注意:
(1)项目空间名称必填,名称推荐体现团队、业务域或项目边界,避免与已有空间混淆。
(2)创建后如需调整,该项目空间的所有者可在项目空间管理中修改基本信息、成员管理和知识库管理。
新建项目空间

基本信息
功能描述:用于查看和修改项目空间名称、项目空间介绍,并提供删除项目空间入口。
操作:在项目空间管理中选择基本信息,修改名称或介绍后点击保存。
结果:保存后项目空间主页和左侧导航同步更新。页面下方展示删除项目空间入口。
注意:修改基本信息需要具备项目空间权限:所有者。删除项目空间属于高风险操作,需要确认空间内已无知识库。
项目空间管理 基本信息

成员管理
功能描述:用于查看项目空间成员、添加成员、批量设置权限或批量删除成员。
操作:在项目空间管理中选择成员管理,查看成员姓名、账号、角色和操作;点击添加成员添加成员;勾选成员后使用批量设置权限或批量删除;必要时点击刷新重新读取成员。
结果:成员列表展示成员名称、账号、角色和操作入口。添加成功后成员出现在列表中。
注意:项目空间所有者可修改成员角色。批量操作前需要勾选成员,否则无法确定作用范围。
项目空间管理 成员管理

知识库管理
功能描述:用于查看当前项目空间内全部知识库,支持刷新、搜索和删除知识库。
操作:在项目空间管理中选择知识库管理,输入知识库名称或简介搜索;需要删除时点击对应知识库右侧删除。
结果:列表展示知识库名称、知识数、创建人、创建时间和操作入口。
注意:删除知识库会同时影响该知识库下的资源和知识成果,需确认没有业务引用后再执行。仅允许删除当前登录用户自己创建的知识库。知识库存在进行中任务时不可删除。
项目空间管理 知识库管理

全局搜索
功能描述:全局搜索用于跨项目空间查找项目空间、知识库或文档,适合快速定位目标知识。
操作:在项目空间主页右上角点击全局搜索,输入关键词,查看搜索结果并点击目标项进入。
结果:搜索框下方展示匹配的项目空间、知识库和文档。每条结果显示对象类型、名称和所属项目空间,方便用户判断来源。
注意:全局搜索依赖当前账号的可见权限。用户只能搜索到有权限访问的项目空间和知识内容。
全局搜索结果

知识库创建
功能描述:新建知识库用于在当前项目空间内建立一个可管理原始资料、Wiki 知识、RAG 检索和知识图谱的知识容器。用户可以按业务主题、项目阶段、交付物类型或资料用途拆分知识库,避免所有资料混在一个空间里。创建时选择的索引策略会决定后续资料解析后的加工链路。
为避免返工,建议创建知识库后先到知识库设置确认配置,再开始上传资料。这里的配置只对之后新上传或重新解析的资料生效;已经解析完成的存量资料不会自动按新配置重新处理。如需让存量资料使用新配置,需要手动触发重新解析。
| 索引策略 | 描述 | 优势 | 限制 | 适用场景 |
|---|---|---|---|---|
| RAG 检索 | 将资料分块并建立向量、关键词索引,用于问答召回。 | 响应直接,可基于原文回答,适合稳定问答。 | 只按片段召回,弱于跨文档关系分析。 | 规范查询、资料问答、问题排查。 |
| Wiki 知识库 | 自动生成互相关联的 Wiki 页面,把资料沉淀为结构化知识。 | 便于阅读、编辑、分类和沉淀。 | 生成质量受资料影响,需要人工审查。 | 项目总结、业务知识、经验沉淀。 |
| 知识图谱 | 抽取实体和关系,形成可浏览、可追溯的关联网络。 | 擅长展示关联、追溯来源、发现隐性联系。 | 需要配置实体关系,当前不作为问答召回索引(后续迭代) | 风险分析、流程链路、对象关系梳理。 |
操作:
-
在左侧选择目标项目空间,进入项目空间主页。
-
在
知识库总览右上角点击新建知识库,或点击知识库列表中的虚线新建知识库卡片。 -
填写
知识库名称。该字段必填,最长 200 个字符,建议使用能体现业务范围或资料主题的名称。 -
按需填写
知识库简介。该字段选填,最长 1024 个字符,建议说明知识库覆盖的主题、资料来源、适用业务或使用场景。 -
在
索引策略中至少勾选一种能力:
- RAG 检索:对文档进行分块、向量化和关键词索引,用于后续问答召回和混合检索。
- Wiki 知识库:在上传解析后自动生成互相关联的 Wiki 知识页面,用于知识沉淀和结构化浏览。
- 知识图谱:从资料中抽取实体和关系,用于后续浏览、关联探索和来源追溯。
- 如果勾选
Wiki 知识库,继续配置 Wiki 生成参数:
| 配置项 | 选项 | 说明 |
|---|---|---|
| 提取粒度 | 聚焦 | 只抽取最核心、最确定的实体和概念,适合低噪声、高精度场景 |
| 提取粒度 | 标准 | 抽取主要对象以及被详细描述的次要概念,适合大多数业务资料 |
| 提取粒度 | 详尽 | 尽量保留更多实体、概念和关系线索,适合调研、审计或高召回场景 |
| Wiki 内容生成要求 | 自定义文本 | 说明表达重点、写作风格、口径要求(最长4000字) |
| Wiki 提取重点 | 自定义文本 | 说明需要重点识别的领域对象、概念、版本、角色等(最长4000字) |
- 确认信息无误后,点击
新建知识库。创建成功后,建议先进入新知识库的知识库设置,按已开启的索引策略确认 Wiki 设置、分块设置和知识图谱配置,确认无误后再上传原始资料。
结果:创建成功后,当前项目空间的知识库总览刷新,并出现新知识库卡片。卡片展示知识库名称、简介和内容统计。用户可以点击该卡片进入知识库,继续上传原始资料。
注意:
(1)勾选 Wiki 后,提取粒度和两个 Wiki 指令才会出现,指令只影响生成方向,不能替换系统内置的引用、合并和防幻觉规则。
(2)知识图谱开启后,还需要在知识库设置中确认实体关系提取配置并上传资料
(3)创建知识库本身不会立刻解析资料,需要继续上传或选择已有资料触发解析。如需被 Agent 稳定召回,建议保留 RAG 检索。
新建知识库

索引策略

知识库原始资料
原始资料是共享知识库的原始资料层,负责把团队文件接入知识库并维持可解析、可追溯的状态。该模块管理的是原始文件、文件夹和解析片段本身;维基知识生成、知识图谱和 Agent 调用分别在后续模块完成。
知识库首页
功能描述:知识库主页用于查看当前知识库基础信息和最近更新资源,帮助用户快速判断知识库是否有新增内容、是否需要继续上传或维护。
操作:在项目空间主页点击目标知识库卡片,进入知识库主页,点击首页。
结果:页面展示知识库名称、简介和最近更新列表;有内容时显示文件名称和更新时间,无内容时显示暂无知识内容。
注意:知识库主页只展示最近更新摘要,不包含全部资源操作。需要管理文件时请点击文件目录或相应文件夹。
知识库首页

文件目录
功能描述:文件目录用于集中管理知识库中的原始资料,支持搜索、筛选、视图切换、状态查看和重新解析。
操作:进入知识库后点击左侧文件目录,输入文件名搜索,或按类型、状态、创建时间和最近更新时间筛选;需要重新处理解析时点击重新解析。
结果:目录列表展示文件标题、类型、大小、创建时间、最近更新时间、状态和操作入口。解析成功的文件会显示解析成功。
注意:只上传文件不等于知识可被检索,文件需要完成解析后才能用于后续检索、维基生成和 Agent 调用。
| 状态 | 描述 |
|---|---|
| 排队中 | 文件已进入处理队列,但解析任务尚未开始执行 |
| 解析中 | 系统正在解析文件内容并生成可检索片段 |
| 编译中 | 解析成功但编译流程尚未完成 |
| 解析成功 | 文件已完成解析,可进入预览、检索和后续知识加工链路 |
| 解析失败 / 编译失败 | 解析或编译未成功,文件不能作为稳定可用知识。可点击查看失败原因 |
| 已取消 | 处理任务已被取消,文件未完成解析 |
| 待解析 | 资料仍处于待处理边界 |
注意:重新解析会重新提交处理任务,适合解析结果异常时使用
原始资料 文件目录

原始资料 文件目录 多选功能

新增入口
功能描述:新增入口用于创建文件夹、上传文件或上传文件夹,用于补充知识库原始资料。
操作:在文件目录左侧点击新增,选择新建文件夹``上传文件或上传文件夹。
结果:选择上传后,文件进入知识库文件目录并显示上传和解析状态。
注意:上传前需要确认文件来源可靠、内容符合团队知识治理要求;解析成功后资料才具备后续检索和 Wiki 生成基础。 原始资料 新增

支持原始资料格式与限制
- 单文件大小: 单文件 ≤ 100MB
- 文件夹层级:目标目录层级 + 上传文件夹相对层级 ≤ 10 层
- 上传数量限制:
- 单次上传文件最多 1000 个文件
- 上传文件夹文件和目录条目合计最多 1000 条
- Agent 目录上传最多收集 1000 个可上传文件 注意:目前暂不支持 zip、ppt、rtf、html、json、xml、音频、视频等格式。ZIP 压缩包不能直接上传,必须先完整解压后再上传目录。
| 支持文件类型 | 扩展名 |
|---|---|
| 文档 | docx、doc、txt、md |
| 表格 | xlsx、xls、csv |
| 演示 | pptx |
| 图片 | png、jpg、jpeg |
原始资料 新增入口

原始资料 上传文件

多选模式与批量操作
功能描述:多选模式用于同时管理多个文件,支持批量移动、批量删除和退出多选。适合批量整理知识库目录结构。
操作:在文件目录点击多选,勾选目标文件,点击批量移动或批量删除。
结果:页面顶部显示已选数量,批量移动时弹出目标目录选择框,批量删除时弹出确认框。
注意:批量删除确认框会提示关联的 Wiki 版本将同步删除,执行前必须确认选择范围。取消操作不会修改数据。
多选模式

批量移动

批量删除确认

文件更多操作
功能描述:文件更多操作用于管理单个文件,支持下载和删除。适合对单个资料进行生命周期管理。
操作:在文件目录中点击目标文件右侧更多操作,选择下载或删除。
结果:选择下载后,浏览器或系统开始下载文件;选择删除后进入删除确认流程。
注意:删除文件影响已生成的 关联Wiki版本、检索结果和血缘关系。删除前应确认该文件是否仍被业务使用。
文件更多操作

文件预览与解析预览
功能描述:文件预览用于查看文件基础信息和在线预览能力;解析预览用于查看解析后的摘要、片段内容、是否参与检索和处理状态。
操作:点击目标文件,进入当前文件预览页;点击解析预览查看解析结果;在片段中可编辑、删除或关闭参与检索。
结果:文件预览页展示文件路径、解析预览入口和预览提示。解析预览页展示解析状态、基本信息、摘要、片段列表、片段编辑、删除和参与检索开关。
注意:文件过大时页面会提示下载后预览。解析预览中提供预览原文和重新分段;重新分段会改变后续检索使用的片段,执行前应确认影响。关闭片段参与检索后,该片段不会参与知识检索,但文件本身不会被删除。
文件预览

解析预览

编辑片段与参与检索
功能描述:编辑片段用于人工修正解析后的知识片段;参与检索用于控制某个片段是否进入检索结果。
操作:在解析预览中点击目标片段的编辑片段,修改内容后保存;需要控制检索范围时切换片段右侧是否参与检索。
结果:编辑保存后片段内容更新;关闭参与检索后,片段状态显示为已停用。
注意:编辑片段属于知识内容修改,会影响后续检索和回答依据。不要删除关键上下文,避免造成回答缺证据。
编辑分片片段

片段参与检索开关

知识库维基知识
维基知识是共享知识库的沉淀层,把已解析资料整理成可阅读、可维护、可追溯的 Wiki 页面。
该模块面向知识治理:索引负责查找;页面详情负责阅读;编辑负责修正口径;版本历史负责追溯;维基图谱负责查看关联;数据血缘负责校验来源链路。

| 二级功能 | 描述 |
|---|---|
| 维基索引 | 快速盘点当前知识库的知识资产 |
| 维基页面详情 | 支持阅读、溯源和跳转关联知识 |
| 编辑词条 | 统一团队口径并修正解析误差 |
| 版本历史 | 查看变更摘要和正文差异 |
| 维基图谱 | 发现关键页面、孤立内容和知识断点 |
| 数据血缘 | 检查未生成 Wiki 的资料和缺少来源的页面 |
维基索引
功能描述:维基索引用于按摘要、实体和概念组织 Wiki 页面,帮助用户快速了解当前知识库已经沉淀了哪些核心知识。
操作:进入知识库后点击维基知识,默认打开维基索引;按摘要或知识筛选页面类型,点击目标词条查看。
结果:页面展示索引说明、摘要分组、实体分组、概念分组和对应词条摘要。
注意:维基索引适合作为知识盘点入口。若索引为空,请检查资源是否已解析或 Wiki 内容是否正在生成。
维基索引

维基页面详情
功能描述:维基页面详情用于阅读单个词条的标题、分类、版本、摘要和正文,是从索引进入具体知识的阅读页。
操作:在维基索引中点击目标词条,进入页面详情。
结果:页面展示词条名称、所属分类、版本、摘要和正文;如页面提供来源或关联入口,可继续追溯相关内容。
注意:来源、内链和治理信息以实际页面展示为准。若来源为空,应到数据血缘检查链路完整性,避免后续无法追溯出处。
维基页面详情 摘要

维基页面详情 知识

编辑词条
功能描述:编辑词条用于人工修正词条名称、分类、概览和正文,确保 Wiki 内容符合实际业务口径。它不是重新解析原始文件,而是直接维护已经生成的 Wiki 页面。编辑后会影响维基索引、维基图谱、检索结果和 Agent 的回答依据。
操作:
(1)在维基页面详情点击编辑,
(2)修改词条名称。名称必填,建议使用团队统一后的业务名称。
(3)按需调整词条分类。
(4)修改词条概览,用一两句话说明该词条的定义、结论或适用范围。
(5)在词条正文中维护详细内容,可使用标题、列表、加粗、代码块、引用等排版能力。需要引用其他 Wiki 页面时,点击插入词条并选择目标词条。
(6)点击保存提交修改;点击取消放弃修改。
结果:保存成功后,页面回到阅读态,展示新的词条名称、分类、概览和正文。维基索引、页面分类、关联关系和图谱展示会随保存结果更新;后续内容变化会进入版本历史记录。
注意:词条名称必填,词条分类、概览和正文共同决定知识口径。编辑会影响后续知识引用,保存前需确认内容准确。
| 字段 | 描述 |
|---|---|
| 词条名称 | Wiki 页面标题,也是索引、内链、图谱中展示的重要标识 |
| 词条分类 | 用于说明 Wiki 页面的知识类型,主要分为摘要、实体、概念。 |
| 词条概览 | 用于快速理解词条内容,展示在页面摘要区和索引中 |
| 词条正文 | 承载词条完整知识内容,可插入标题、列表、代码块、引用和词条链接 |
编辑词条

词条分类
分类决定词条在维基索引中的分组位置和页面归属,帮助用户按不同知识类型查找和维护内容。
词条分类规则:维基知识的摘要页固定为摘要,知识页可在实体 / 概念间切换。
| 分类 | 适用内容 | 例子 | 价值 |
|---|---|---|---|
| 摘要 | 一份原始资料的整体概述 | 产品白皮书摘要、项目总结摘要 | 帮助用户快速了解一份原始资料的整体内容 |
| 实体 | 可识别的具体业务对象 | 产品、组织、设备、系统、客户、项目 | 把具体对象沉淀为可复用的业务知识 |
| 概念 | 方法、机制、流程、规则或通用术语 | 知识治理、数据血缘、检索测试、上线流程 | 帮助用户理解业务方法和通用概念 |
词条正文编辑
正文编辑器支持:
- 正文段落、一级到六级标题。
- 有序列表、无序列表。
- 代码块、引用块。
- 加粗、斜体、删除线
- Wiki 内链、取消已有 Wiki 链接。

插入词条
插入词条用于在当前词条正文中添加另一个 Wiki 页面的链接,建立词条之间的关联。
插入后,用户可以从当前词条跳转到被引用词条,系统也会根据这类链接形成页面关联和维基图谱关系。如不再需要某个链接,可在编辑状态下选中该链接后使用取消链接。
编辑词条 插入词条

编辑词条 取消链接

版本历史
功能描述:版本历史用于查看 Wiki 页面的历史版本、当前版本、变更摘要和正文差异,帮助用户追溯知识演进。
操作:在维基页面详情点击版本历史,查看版本列表和正文差异。
结果:右侧展示版本历史抽屉,包含当前版本、自动生成信息、标题、摘要和正文变更。
注意:版本历史用于追溯。可查看当前版本、自动生成时间和标题 / 摘要 / 正文变更,暂无历史版本时会提示页面内容变化后会记录快照。

维基图谱
功能描述:维基图谱用于展示 Wiki 页面之间的关联关系,帮助用户理解知识结构、发现关键页面和知识断点。
操作:在维基知识左侧点击维基图谱,按类型筛选节点,搜索 Wiki 页面,点击节点查看详情;使用适应屏幕、隐藏箭头和画布操作说明。
结果:页面展示节点关系、图例控制、节点数量和画布操作提示。
注意:维基图谱反映的是 Wiki 页面之间的链接关系,不等同于实体关系知识图谱。

数据血缘
功能描述:数据血缘用于查看资源文件和 Wiki 文件之间的生成、引用和缺失关系,帮助用户判断知识是否可溯源。未生成Wiki的资源表示原始资料尚未生成有效维基知识产物,缺少来源的Wiki表示 维基知识 缺少来源依据。删除 Raw 原始资料不会自动删除已生成 维基,血缘会标记原始资料为已删除。
操作:在维基知识左侧点击数据血缘,搜索文件标题,点击资源文件或 Wiki 文件,查看上下游关联和右侧文件预览。
结果:页面展示资源文件、维基文件、未生成 Wiki 的资源、缺少来源的 Wiki 和文件预览。
注意:缺少来源的 Wiki 会影响知识可信度;未生成 Wiki 的资源表示当前资料尚未完成知识加工。
数据血缘列表

数据血缘 查看文件血缘

知识库知识图谱
功能描述:知识图谱用于展示知识库中已被抽取出的实体和实体关系。它把资料中的业务对象、组织、产品、流程、风险、指标等内容转化为可视化关系网络,帮助用户查看对象之间的关联、定位关键实体、理解业务结构。
操作:
- 【前置步骤,建议先于上传文件完成】前往
知识库设置 → 索引与解析 → 知识图谱启用实体关系提取并保存配置。详情见 知识库设置-知识图谱章节。配置完成后,新上传或重新解析的资料才会生成实体和关系。
- 推荐顺序:先完成配置 → 再上传新资料,系统会在资料解析阶段自动抽取实体关系,无需额外操作;
- 已先上传资料的补救方式:配置完成后,需对存量资料手动触发重新解析,才会生成实体和关系。
- 配置完成且图谱生成后,在搜索框中输入实体名称,或直接浏览图谱画布。
- 单击节点,查看实体详情和该实体的指向 / 来自关系。
- 双击节点,聚焦该实体的局部子图。点击
返回全库概览,回到整体视图。 - 使用拖拽节点、拖拽空白、滚轮缩放、适应屏幕、隐藏 / 显示箭头调整展示方式。
结果:页面展示实体节点、关系边、节点数量和当前展示范围。实体详情中会按方向展示
指向和来自的关系,包括关系类型和关联实例。
注意:
- 如果提示未启用知识图谱,需要先前往
知识库设置 → 索引与解析 → 知识图谱完成配置。 - 顺序提醒:知识图谱配置不会对配置前上传、且未重新解析的资料自动生效,建议在上传第一批资料前完成配置,减少重复操作。 知识图谱与维基图谱的区别:
维基图谱看哪些词条互相引用;知识图谱看业务对象之间有什么关系。
| 对比项 | 知识图谱 | 维基图谱 |
|---|---|---|
| 节点 | 实体,例如产品、组织、设备、客户、工序 | Wiki 页面 / 词条 |
| 边 | 实体之间的关系,例如属于、供应、指向、依赖 | Wiki 页面之间的引用链接 |
| 数据来源 | 模型从原始资料中抽取实体和关系 | Wiki 正文中的词条链接 |
| 主要价值 | 表达业务对象之间的结构化关系 | 查看 Wiki 页面之间的知识关联 |
知识图谱 空状态提示

知识图谱 全库概览

知识图谱 局部子图

知识库设置
知识库设置是共享知识库的配置与质量检查模块。基本信息决定知识库如何被识别,Wiki 设置决定新增 Wiki 如何生成,分块设置决定新资料如何切分为检索片段,检索测试验证这些配置是否真的能召回有效内容。
| 二级功能 | 区别 | 描述 |
|---|---|---|
| 基本信息 | 维护知识库身份和自动编译开关 | 控制名称、简介和 Wiki 自动生成入口 |
| Wiki 设置 | 定义 Wiki 提取规则 | 使新增 Wiki 符合团队知识口径 |
| 分块设置 | 定义资料切分规则 | 平衡检索召回率与上下文完整性 |
| 检索测试 | 验证实际召回效果 | 上线前检查知识是否可用 |
基本信息
功能描述:基本信息用于维护知识库名称、知识库简介和自动编译为维基知识开关,并提供删除知识库入口。
操作:进入知识库后点击知识库设置,选择基本信息,修改名称或简介,按需切换自动编译为维基知识,点击保存。
结果:保存后知识库基础信息更新。自动编译为维基知识开关说明为:开启后文件上传即自动编译为维基知识;关闭后需在原始资料的知识列表中手动编译。
注意:知识库名称必填,页面显示长度上限为 200 字符。删除知识库会影响其中所有资源和知识成果。仅允许删除当前登录用户自己创建的知识库。知识库存在进行中任务时不可删除。
知识库设置基本信息

Wiki 设置
功能描述:Wiki 设置用于配置 Wiki 提取粒度、提取重点和内容生成要求,影响新增 Wiki 的生成方式。
操作:在知识库设置中选择Wiki 设置,选择聚焦``标准或详尽提取粒度,填写 Wiki 提取重点和内容生成要求,点击保存配置。
结果:保存后,后续新生成的 Wiki 会按当前配置提取和组织内容。
注意:Wiki 提取重点和内容生成要求各显示 4000 字符上限。该配置不会自动改写已有 Wiki 页面,也不会重新整理目录。修改配置前建议先确认团队统一口径。
Wiki设置

分块设置
功能描述:分块设置用于控制文档如何切分为可检索的知识片段,影响检索召回效果和上下文完整性。
操作:在知识库设置中选择分块设置,先选择精准问答``均衡检索或完整上下文预设规则,或调整分块大小、重叠长度、分隔符优先级;必要时切换通用分块或Markdown 标题模式,点击保存规则。
结果:保存后,新上传文档会按当前分块规则处理;右侧实时预览展示文档将如何切分。
注意:
(1)分块大小允许 64-4096 token,系统建议 256-1024;重叠长度建议为分块大小的 10%-20%。
(2)分块规则只影响新上传的文档,已有文档不会自动重新分块。
(3)当前仅支持知识库级规则,不支持单个文档独立规则。
分块设置

知识图谱设置
功能描述:知识图谱设置用于配置实体关系提取能力。管理员可以决定是否启用知识图谱、选择业务抽取模板、定义关系类型、补充领域提取要求,并通过示例文本、示例实体和示例关系约束模型抽取效果。
其中示例文本、示例实体、示例关系组成Few-shot 少样本标注样例组—— 给模型提供带标准答案的例题,作为抽取参照统一实体命名、抽取粒度、关系标注口径,约束模型抽取效果。
操作:
- 进入目标知识库。点击
知识库设置。进入索引与解析 → 知识图谱。 - 打开
启用实体关系提取。 - 填写
额外提取要求:补充业务专属的抽取规则与边界。 - 定义
关系类型:配置本次抽取需要识别的关系标签。 - 配置 Few-shot 少样本样例组:
- 填写
示例文本:粘贴 1-2 段覆盖目标业务场景的典型原文,作为样例原始素材; - 点击
测试示例抽取:模型自动生成示例实体与示例关系,查看模型输出是否贴合样例标准,作为实体抽取的标注参照。
- 点击
保存配置。 结果:
- 保存成功后,系统提示
知识图谱配置已保存。 - 开启提取后,后续新上传或重新解析的文档会参照配置的规则、关系类型与 Few-shot 样例标准,抽取实体和关系。 注意:
- 开启知识图谱不会自动处理历史资料;存量资料需要重新解析或点击
开始提取。 - 知识图谱已有数据时,系统不支持直接关闭实体关系提取。
- 配置修改后需保存才会生效。 知识图谱设置 知识图谱启用开关

知识图谱配置参考:
额外提取要求
重点提取产品、功能模块、用户角色、设备故障、业务指标、处理动作和数据依赖。实体名称使用资料中的标准名称,不要使用代词。只抽取资料中明确表达的关系,不要自行推测。属性填写短标签。
关系类型
包含、使用、导致、影响、属于、发生于、依赖、提供、导致
示例文本
智能设备管理平台包含设备台账、故障诊断和维修工单模块。维修工程师使用故障诊断模块定位设备故障。设备故障会导致产线停机,并影响设备可用率。维修工单模块用于记录处理动作和维修结果。故障诊断依赖实时监控数据。
示例实体
| 实体名称 | 属性 1 | 属性 2 | 属性 3 |
|---|---|---|---|
| 智能设备管理平台 | 产品类型 | 核心能力 | 服务对象 |
| 故障诊断 | 模块类型 | 核心能力 | 数据来源 |
| 设备故障 | 事件类型 | 影响等级 | 触发条件 |
| 产线停机 | 事件类型 | 影响等级 | 触发条件 |
示例关系
| 起点实体 | 关系类型 | 终点实体 |
|---|---|---|
| 智能设备管理平台 | 包含 | 故障诊断 |
| 故障诊断 | 处理 | 设备故障 |
| 设备故障 | 导致 | 产线停机 |
知识图谱配置1

知识图谱配置2

检索测试
功能描述:检索测试用于验证当前知识库内容能否被正确召回。它模拟用户提问或关键词搜索,检查原始分片是否会被检索出来,是知识库上线前的重要质量检查工具。
操作:在知识库设置中选择检索测试,输入必填测试内容,选择检索范围、关键词 / 语义 / 混合检索方法、返回数量 Top K 和是否启用结果重排,点击开始测试。
结果:测试结果展示命中分片、来源路径、检索方式、耗时和查看分片/打开原文入口。
注意:测试内容显示 5000 字符上限。检索测试是只读操作,不会修改知识内容、正式检索配置或访问权限。测试不通过时,应优先检查解析状态、分块配置和片段是否参与检索。
| 术语 | 定义 | 适用场景 |
|---|---|---|
| 关键词检索 | 基于字面匹配的检索方式,系统将查询内容拆分为关键词,并在知识分片中查找匹配词 | 查询产品名、错误码、接口名、条款编号等精确术语 |
| 语义检索 | 基于语义向量的检索方式,系统计算查询内容与知识分片在含义上的相似度 | 查询表述与资料原文不一致,但语义相近的场景 |
| 混合检索 | 同时执行关键词检索和语义检索,并融合两路结果的检索方式 | 大多数正式检索场景,推荐优先使用 |
| 返回 Top K | 限定检索结果最多返回的前 K 条记录 | 控制返回数量、上下文长度和结果聚焦度 |
| 结果重排 | 在初步召回完成后,系统再使用重排模型对候选结果进行二次评估,并按照与当前问题的相关性重新排序。 | 对答案精度要求较高、需要优先展示最相关内容的场景 |
检索测试 空状态

检索测试结果

检索测试重排结果

Agent 会话调用
Agent 会话调用是共享知识库的消费层,把已解析资料和维基知识变成会话中可使用的知识资产。用户在会话中先确定任务输入,再选择任务资源和知识底座,Agent 按所选范围检索和执行。
会话输入区
功能描述:会话输入区是用户与 Agent 交互的统一发起入口,用于描述任务要求、选择匹配的专家 / 专家团、挂载共享知识库与任务资源,提交后触发 Agent 执行任务,所有会话问答、任务处理均从该区域发起。
操作:
(1)点击激活会话输入框,输入@唤起资源选择面板,在分类中选择共享知识库,勾选目标知识库后点击确认,输入框会展示已选知识库的引用标签;
(2)按需选择匹配的专家 / 专家团、挂载其他任务资源;
(3)在输入框内描述具体问题或任务要求;
(4)确认所有选择无误后,点击发送按钮提交任务。
结果:Agent 开始处理任务,并按所选知识底座、技能和专家组织输出。是否展示来源引用取决于任务类型和页面返回,用户应核对回答依据是否来自所选知识库。
注意:点击发送按钮前需要确认选择的知识底座正确,否则 Agent 可能回答来源不符或证据不足。
选择共享知识库

共享知识库列表

选中共享知识库

Agent 输出任务结果

附录:图片与正文位置映射表
| 图片文件 | 所在章节 |
|---|---|
| /images/manuals/knowledge/shared/project-space-home-1.png | 项目空间主页 |
| /images/manuals/knowledge/shared/project-space-home-2.png | 项目空间主页 |
| /images/manuals/knowledge/shared/create-project-space-1.png | 新建项目空间 |
| /images/manuals/knowledge/shared/project-space-info-1.png | 基本信息 |
| /images/manuals/knowledge/shared/member-management-1.png | 成员管理 |
| /images/manuals/knowledge/shared/kb-management-1.png | 知识库管理 |
| /images/manuals/knowledge/shared/global-search-1.png | 全局搜索 |
| /images/manuals/knowledge/shared/create-kb-1.png | 知识库创建 |
| /images/manuals/knowledge/shared/create-kb-2.png | 知识库创建 |
| /images/manuals/knowledge/shared/kb-home-1.png | 知识库首页 |
| /images/manuals/knowledge/shared/file-directory-1.png | 文件目录 |
| /images/manuals/knowledge/shared/file-directory-2.png | 文件目录 |
| /images/manuals/knowledge/shared/add-entry-1.png | 新增入口 |
| /images/manuals/knowledge/shared/supported-formats-1.png | 支持原始资料格式与限制 |
| /images/manuals/knowledge/shared/supported-formats-2.png | 支持原始资料格式与限制 |
| /images/manuals/knowledge/shared/batch-operations-1.png | 多选模式与批量操作 |
| /images/manuals/knowledge/shared/batch-operations-2.png | 多选模式与批量操作 |
| /images/manuals/knowledge/shared/batch-operations-3.png | 多选模式与批量操作 |
| /images/manuals/knowledge/shared/file-more-actions-1.png | 文件更多操作 |
| /images/manuals/knowledge/shared/file-preview-1.png | 文件预览与解析预览 |
| /images/manuals/knowledge/shared/file-preview-2.png | 文件预览与解析预览 |
| /images/manuals/knowledge/shared/chunk-editing-1.png | 编辑片段与参与检索 |
| /images/manuals/knowledge/shared/chunk-editing-2.png | 编辑片段与参与检索 |
| /images/manuals/knowledge/shared/kb-wiki-1.png | 知识库维基知识 |
| /images/manuals/knowledge/shared/wiki-index-1.png | 维基索引 |
| /images/manuals/knowledge/shared/wiki-page-detail-1.png | 维基页面详情 |
| /images/manuals/knowledge/shared/wiki-page-detail-2.png | 维基页面详情 |
| /images/manuals/knowledge/shared/edit-entry-1.png | 编辑词条 |
| /images/manuals/knowledge/shared/edit-entry-content-1.png | 词条正文编辑 |
| /images/manuals/knowledge/shared/insert-entry-1.png | 插入词条 |
| /images/manuals/knowledge/shared/insert-entry-2.png | 插入词条 |
| /images/manuals/knowledge/shared/version-history-1.png | 版本历史 |
| /images/manuals/knowledge/shared/wiki-graph-1.png | 维基图谱 |
| /images/manuals/knowledge/shared/data-lineage-1.png | 数据血缘 |
| /images/manuals/knowledge/shared/data-lineage-2.png | 数据血缘 |
| /images/manuals/knowledge/shared/knowledge-graph-1.png | 知识库知识图谱 |
| /images/manuals/knowledge/shared/knowledge-graph-2.png | 知识库知识图谱 |
| /images/manuals/knowledge/shared/knowledge-graph-3.png | 知识库知识图谱 |
| /images/manuals/knowledge/shared/kb-settings-info-1.png | 基本信息 |
| /images/manuals/knowledge/shared/wiki-settings-1.png | Wiki 设置 |
| /images/manuals/knowledge/shared/chunk-settings-1.png | 分块设置 |
| /images/manuals/knowledge/shared/graph-settings-1.png | 知识图谱设置 |
| /images/manuals/knowledge/shared/graph-settings-2.png | 知识图谱设置 |
| /images/manuals/knowledge/shared/graph-settings-3.png | 知识图谱设置 |
| /images/manuals/knowledge/shared/retrieval-test-1.png | 检索测试 |
| /images/manuals/knowledge/shared/retrieval-test-2.png | 检索测试 |
| /images/manuals/knowledge/shared/retrieval-test-3.png | 检索测试 |
| /images/manuals/knowledge/shared/chat-input-1.png | 会话输入区 |
| /images/manuals/knowledge/shared/chat-input-2.png | 会话输入区 |
| /images/manuals/knowledge/shared/chat-input-3.png | 会话输入区 |
| /images/manuals/knowledge/shared/chat-input-4.png | 会话输入区 |