工作流/知识和数据节点/知识库写入节点
知识库写入节点
更新于: 2026-06-24 15:44:40
AI 助手
扣子 AI 帮助与支持
你好，我是 扣子 文档问答助手 🎉
你在阅读当前文档的过程中，无论对文档概念的解释，还是文档内容方面的疑问，都可以随时向我提问，我会全力为你解答
推荐问题
如何快速了解这个空间的核心内容？
有哪些近期更新的重点文档？
我应该从哪些文档开始阅读？
文档反馈
低代码项目
快速开始
智能体
工作流
基础节点
业务逻辑节点
输入和输出节点
数据库节点
图像处理节点
音视频处理节点
组件节点
触发器节点
会话管理节点
会话历史节点
消息节点
应用
资源
发布
模型
多人协作
开发工具
推广与变现
知识库写入节点
低代码工作流中的知识库写入节点用于向指定的扣子知识库或火山知识库中添加内容。
使用限制
使用火山知识库时，节点的请求频率限制遵循火山知识库自身的 QPS 配额限制。更多信息，请参考接口限流说明。
- 写入文本到火山知识库文档时，将调用 /api/knowledge/point/add 接口，该接口的 QPS 为 10。
- 上传新文档到火山知识库时，将调用 /api/knowledge/doc/add 接口，该接口的 QPS 为 300。
- 检索火山知识库中的文档时，将调用 /api/knowledge/service/chat 接口，该接口与部分火山知识库接口共享 QPS，其值为 50。
节点说明
在低代码工作流执行过程中，用户不仅可以从已上传的知识库里检索信息，还可以通过知识库写入节点来主动更新知识库，上传新的文档内容。知识库写入节点是智能体或应用的用户上传知识库的唯一途径，它的本质是向一个已创建的知识库中上传文件或内容，内容的切片策略沿用知识库的分段策略。
说明
- 每次运行知识库写入节点只能上传一个文件到知识库，但是你可以通过批处理或循环节点多次执行写入操作。
- 知识库写入节点为异步节点，工作流执行时无需等待文档上传完成。
添加节点
在工作流画布中，单击 + 添加节点，在知识库&数据区域选择知识库写入节点，即可将节点添加到画布中。
配置火山知识库
选择知识库来源为火山知识库时，参考如下配置。
写入方式
当选择知识库来源为火山知识库时，支持设置写入方式，具体包括以下两种方式：
- 写入知识库：将文件写入到指定的知识库中。
- 写入文档：将文本内容上传到知识库的指定文档中。
输入
知识库写入节点的输入参数固定为 knowledge，表示用户需要上传到知识库中的文件或内容。
- 如果要上传文本内容到知识库文档中，可设置
knowledge的数据类型为 String 或 Array - 如果要上传新文件到知识库，可设置
knowledge的数据类型为 File。上传的文件可以固定为某个文件，由知识库的搭建者在搭建时上传；也可以引用上游节点的输出参数，在上游节点获取文件后上传。 - 如果知识库是结构化类型，支持上传 csv，xlsx，jsonl，faq.xlsx 格式的文件。
- 如果知识库是非结构化类型，支持上传 pdf， ppt，txt，markdown，doc，xlsx，csv，jsonl，faq 格式的文件。
知识库
在知识库区域，选择待写入内容的知识库。
- 知识库来源：选择火山知识库。
- 添加知识库：选择具体的知识库。
- 目标写入文档：设置写入方式为写入文档时，需选择具体的知识库文档。
标签
说明
仅火山知识库旗舰版支持标签功能。更多信息，请参考创建知识库。
火山知识库的标签功能用于对知识库文档进行分类与过滤，提升知识库的检索效率。添加标签后，后续在知识库检索时，将先在标签范围内检索文档，然后结合召回策略返回结果。
标签区域将展示你在创建火山知识库时所创建的标签。标签值中将罗列你在创建标签时设置的标签值，你也可以在搜索框中输入标签值，单击创建，创建新的标签值。设置完成后，系统会在上传文档时，同步为文档添加标签。
选择标签值
创建标签值
数据写入设置
火山知识库的解析与分离策略，需单击前往火山配置，在火山知识库控制台进行配置，包括文本向量化模型、向量维度、切片方式等。具体操作，请参考创建知识库。
输出
输出参数固定为以下参数：
说明
上传文本内容到知识库文档时，fileName 和 fileUrl 参数值为空。
- documentId：知识库文档的 ID。格式为 String。
- fileName：知识库文档的名称。格式为 String。
- fileUrl：知识库文档的访问地址。格式为 String。
配置扣子知识库
选择知识库来源为扣子知识库时，参考如下配置。
输入
知识库写入节点的输入参数固定为 knowledge，数据类型为 File
知识库
在知识库区域，选择待写入内容的知识库。
- 知识库来源：选择扣子知识库。
- 添加知识库：选择具体的知识库。
数据写入设置
扣子知识库的文档解析策略和分段策略说明如下：
|
参数 |
说明 |
|---|---|
|
文档解析策略 |
文档解析策略用于定义系统如何解析文档中的文本、图片或表格内容。支持设置为：
|
|
分段策略 |
每次上传文档时都可以设置新文档的分段策略，合理的切片策略可以提高检索效率、提升检索结果的准确性。支持选择自动分段或自定义分段，详细说明可参考知识库概述。 |
输出
输出参数固定为以下参数：
- documentId：知识库文档的 ID。格式为 String。
- fileName：知识库文档的名称。格式为 String。
- fileUrl：知识库文档的访问地址。格式为 String。
常见问题
用户上传的文档和开发者上传的文档有什么区别？
用户上传的文档和开发者上传的文档本身没有任何区别，都是知识库中的公开内容，可以被其他用户检索。但上传方式有区别，用户只能通过工作流的知识库写入节点上传文档，开发者则是在知识库管理页面或通过知识库 API 上传文档。
知识库写入节点是异步节点吗？
知识库写入节点为异步节点，工作流执行时无需等待文档上传完成。