qKnow智能体构建平台开源版V2.4.2围绕知识文件接入流程进行优化，在知识库和知识图谱中新增数据同步能力，支持直接连接HDFS、FTP、OSS等外部存储，实现海量文件无需下载即可同步至平台，进一步优化企业知识资料进入知识库前的处理流程。

---

从“本地上传文件”，到连接企业已有存储体系

在企业智能体建设过程中，知识库通常需要持续接入大量业务资料。

这些文件通常并不是直接保存在本地服务器中，而是已经存储在企业已有的数据存储体系中。

常见存储方式包括：

• HDFS；

• OSS；

• FTP。

过去，当企业需要将这些文件导入 qKnow 进行知识处理时，通常需要经历：

第三方存储 → 下载文件 → 本地整理 → 上传至 qKnow → 开始解析

这种方式在文件数量较少时影响并不明显。

但当企业面对大量知识文件时，问题会逐渐暴露：

1. 文件需要人工下载和上传，增加了操作步骤；

2. 大量文件反复经过本地服务器，会占用额外磁盘空间；

3. 频繁的数据传输也会消耗网络带宽，增加服务器压力。

因此，企业知识管理需要的不只是“支持上传文件”，而是能够连接已有数据存储体系，让知识文件更加顺畅地进入智能体构建流程。

qKnow开源版V2.4.2此次新增的数据同步能力，就是围绕这一环节进行优化。

---

新增数据同步入口，知识库与知识图谱支持直连外部存储

qKnow开源版V2.4.2在知识库和知识图谱的知识文件管理中新增数据同步功能入口。

用户无需先将文件下载到本地，再通过上传方式导入。

而是可以直接配置外部存储连接，从已有文件目录中选择需要同步的知识文件。

整体流程调整为：

配置数据连接 → 选择知识文件 → 完善文件信息 → 完成同步

这种方式减少了中间文件搬运过程，让企业已有存储中的知识资料可以更加直接地进入 qKnow 后续解析流程。

---

支持HDFS、FTP、OSS三类数据连接

进入数据同步页面后，整体流程分为三个步骤：

数据连接 → 文件选择 → 文件信息

其中数据连接支持三种连接类型：

• HDFS；

• FTP；

• OSS（阿里云）。

不同类型的数据源需要填写对应连接配置。

例如：

• HDFS需要根据集群环境填写对应连接信息；

• FTP需要配置服务器地址、账号等连接参数；

• OSS需要根据云存储环境完成对应配置。

完成连接信息填写后，需要点击测试连接。

只有测试通过后，才能进入下一步。

同时，如果测试通过后用户再次修改任意连接配置，下一步按钮会重新限制使用，需要重新完成连接验证。

这种设计主要用于避免用户在连接信息发生变化后，继续使用未经验证的配置进入后续流程。

---

三步向导式同步流程，降低知识文件接入复杂度

企业知识文件同步通常涉及：

• 数据源连接；

• 文件定位；

• 文件属性配置。

如果这些操作集中在一个页面中，用户容易遗漏必要配置。

qKnow V2.4.2将数据同步拆分为三个步骤，让用户按照流程逐步完成。

第一步：配置数据连接并验证可用性

进入数据同步页面后，首先需要完成数据连接配置。

支持：

• HDFS；

• FTP；

• OSS。

用户填写连接相关信息后，需要执行测试连接。

测试成功后，才能继续下一步。

如果连接信息发生变化，则需要重新验证。

这一流程主要用于确认：

• 当前存储是否可以访问；

• 配置信息是否正确；

• 后续文件读取是否具备基础条件。

通过连接测试前置，可以减少进入文件选择阶段后才发现数据源无法访问的情况。

---

第二步：选择需要同步的知识文件

完成数据连接后，进入文件选择步骤。

在该步骤中，用户至少需要选择一个知识文件，才能继续下一步。

同时，在选择文件按钮旁增加文件格式说明，用于提示用户当前支持选择的文件类型。

支持的文件格式与正常新增知识文件时保持一致。

---

01 目录树与文件列表结合，快速定位目标文件

点击选择文件后，系统会打开文件选择窗口。

窗口分为左右两个区域：

1. 左侧：展示通过数据连接读取到的文件目录。

2. 右侧：展示当前目录下的文件和文件夹。

用户可以通过：

• 左侧目录树进入不同文件夹；

• 点击列表中的文件夹继续浏览；

• 使用文件名称搜索快速定位。

文件列表中展示：

• 文件名称；

• 文件类型；

• 所在路径；

• 文件大小；

• 更新时间。

对于企业大量文件场景，这种目录和搜索结合的方式，可以减少在海量文件中逐层查找的时间。

---

02 支持批量勾选文件同步

在文件选择页面中，用户可以根据实际需求选择多个知识文件。

选择完成后点击确定，系统会将文件同步选择结果回显到文件列表中。

如果发现存在不需要同步的文件，也可以在外部列表中通过操作栏删除。

确认文件无误后，再进入下一步。

这样可以在正式同步前再次确认文件范围，减少误选文件进入知识处理流程。

---

第三步：文件信息配置，让同步后的知识内容保持可管理

完成文件选择后，进入文件信息配置阶段。

该阶段需要补充同步文件的基础信息，包括：

• 所属分类；

• 数据风格；

• 文件描述。

这些信息用于帮助企业后续管理进入知识库中的文件。

例如：

• 不同业务部门的知识资料可以归入不同分类；

• 不同类型的数据文件可以根据实际情况设置对应属性；

文件描述可以补充文件来源或用途说明。

在文件信息配置中，如果第二步选择了 JSON/JSONL 等半结构化文件，则需要进一步选择数据风格。

如果没有选择这类文件，则无需配置该项。

完成全部信息填写后，点击确定即可完成数据同步操作。

---

知识图谱同步流程保持一致，补充文件类型限制

除了知识库数据同步外，qKnow V2.4.2同样支持知识图谱中的数据同步能力。

整体流程与知识库保持一致：

数据连接 → 文件选择 → 文件信息

区别在于：

知识图谱的数据同步在第二步选择文件时，不支持 JSON/JSONL 类型数据。

其他文件格式保持一致。

同时，在选择文件按钮旁增加对应文件格式说明，用于提示用户当前支持范围。

---

版本价值：让企业知识接入从文件搬运转向数据直连

qKnow开源版V2.4.2此次升级主要围绕知识文件进入平台前的接入流程展开。

• 减少人工文件搬运过程

通过新增HDFS、FTP、OSS数据同步能力，企业无需先将文件下载到本地，再上传至qKnow，可以直接连接已有存储体系。

• 降低本地存储和网络压力

大量文件反复下载、上传，会占用服务器空间并消耗网络带宽。

直连同步方式减少中间传输环节，有助于降低本地服务器压力。

• 提升海量知识文件管理效率

通过目录树、文件搜索、文件信息展示等能力，用户可以更加方便地从外部存储中定位和选择需要进入知识库的文件。

整体来看，qKnow智能体构建平台v2.4.2并不是简单增加一个文件上传入口，而是进一步完善企业已有数据资产进入智能体知识体系的连接方式。

---

写在最后

企业智能体建设过程中，知识获取能力是基础环节。

随着知识规模不断增长，知识文件的来源也越来越多。如果仍然依赖人工下载、整理和上传，不仅增加操作成本，也会影响知识更新效率。

qKnow智能体构建平台开源版v2.4.2围绕这一问题新增数据同步能力：

• 在知识接入侧，支持HDFS、FTP、OSS三类外部存储连接，让企业已有文件资源可以直接进入知识处理流程；

• 在操作流程侧，通过数据连接、文件选择、文件信息三步向导，降低文件同步操作复杂度；

• 在文件管理侧，提供目录浏览、搜索、路径、大小、更新时间等信息展示，帮助用户更加准确地选择知识文件。

这些能力不能替代企业自身的数据管理规范，也不能自动解决所有外部存储权限和网络配置问题。

但通过减少文件搬运环节、优化知识文件接入流程，qKnow V2.4.2进一步完善了企业知识从存储系统进入智能体应用之间的连接路径，为后续知识库建设和智能体应用落地提供更加稳定的基础能力。