关联火山知识库

扣子编程支持关联火山知识库，关联成功后，你可以在扣子编程的低代码智能体、应用、工作流中使用火山知识库。

背景信息

火山知识库是火山引擎推出的一款知识管理工具，能够将存储于指定链接或对象存储服务（TOS）中的海量文档高效导入知识库，并依次完成文档的解析、切片、向量化以及索引构建等一系列深度处理流程。处理完成后，你可以基于知识库进行知识检索工作，快速获取所需信息。更多信息，请参考创建知识库。
与扣子知识库相比，火山知识库更适合企业用户场景，支持更大的存储空间、更高的 QPS 、更精细的切片管理和更复杂的文档处理需求，能够满足企业客户对于大规模知识库的存储需求。

注意事项

在使用火山知识库前，请阅读以下注意事项。

费用说明

在扣子编程使用火山知识库时，知识库内容的存储、召回与重排操作均在火山知识库侧完成，然后由扣子大模型进行内容总结并返回给用户。因此存储、召回与重排会产生火山知识库费用，由火山方舟大模型服务平台收取，不支持通过扣子积分抵扣。火山知识库侧收取的费用如下，详情请参考知识库计费。

• 计算资源费用
• 离线存储资源费用
• 文本向量模型费用
• 重排模型费用

前提条件

已开通火山知识库服务。具体操作，请参考开通服务。

操作步骤

步骤 1：创建火山知识库

在创建火山知识库时，你可以根据具体的知识召回需求，配置知识库的数据类型、文本向量化模型、向量维度、切片方式、CPU 配额以及索引算法等参数，实现高效的知识管理和精准检索。

1. 在火山引擎知识库控制台，单击创建知识库。
2. 在创建知识库页面的基本信息区域，完成如下配置。
   具体参数配置说明，请参考创建知识库。
   
3. （可选）在创建知识库页面的高级配置区域，创建标签。
   标签用于对知识库文档进行分类与过滤，提升知识库的检索效率。添加标签后，后续在扣子编程的低代码智能体、工作流中使用火山知识库时，将先在标签范围内检索文档，然后结合召回策略返回结果。

   注意

   • 仅旗舰版支持创建标签，且仅支持在创建知识库时创建标签。更多信息，请参考创建知识库。
   • 创建知识库后不支持再变更标签名称，请在创建时确认标签名称无误。
   常见的应用场景包括：
   • 用户反馈分类：为用户反馈的文档打标签，例如产品问题、物流延迟问题。
   • 内容审核与推荐：对用户上传的文本或图片文档打标签，例如敏感内容、热门话题。
   • 商品分类：给商品图片或描述相关的文档打标签，例如家电、服饰等，提高查询效率。
     
4. 单击创建知识库。
   在弹出的知识库创建成功对话框中，单击立即导入，导入文档。
   

步骤 2：导入文档

创建火山知识库后，你可以在导入文档页面，通过本地上传、从 TOS 中导入、飞书文档、公开下载链接等方式导入文档。具体操作，请参考导入文档。

步骤 3：为文档添加标签

火山知识库的标签功能用于对知识库文档进行分类与过滤，提升知识库的检索效率。添加标签后，后续在知识库检索时，将先在标签范围内检索文档，然后结合召回策略返回结果。
如果要通过标签功能筛选文档，则你在创建标签后，还需为文档添加标签及设置标签值。具体操作，请参考标签编辑。

步骤 4：查看切片详情

导入文档后，系统会自动对内容进行切片。如果切片不满足预期，可重新调整切片规则或对原始文档进行更加规范化的加工。具体操作，请参考新增切片。

步骤 5：创建知识服务

导入文档后，系统将自动构建索引，大约需要 3～5 分钟。索引构建完成后，你可以通过调整知识检索参数来调优该知识库的检索能力。调优完成后，需将对应的检索配置发布为知识服务，扣子编程将通过知识服务直接获取已召回的内容，并返回给用户查看。

在火山知识库的知识检索页签下，单击创建服务调用，创建知识检索类型的服务调用。具体操作，请参考创建知识服务。

步骤 6 ：关联火山知识库

创建知识服务后，你可以在扣子编程关联火山知识库。将火山知识库关联到扣子编程，是将火山知识库作为扣子编程资源的一种，加入到扣子编程资源库中。关联成功后，开发者便可在扣子编程的智能体、工作流、应用中使用火山知识库。

1. 登录扣子编程。

2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击资源库。

3. 在页面右上角，选择**+资源** > 知识库。

4. 单击关联火山知识库，选择待关联的火山知识库，然后单击创建并导入。

   • 火山项目：选择目标知识库所在的火山引擎项目。
   • 选择知识库：选择目标火山知识库。
     

相关操作

火山知识库的关联者将成为该知识库在扣子编程的创建者，可以在扣子编程对该知识库进行启用、暂停、解绑操作。

解绑知识库

如果不再需要使用该火山知识库，可以在扣子编程上执行解除绑定操作。解除绑定，表示删除扣子编程和指定火山知识库的绑定关系，后续无法为智能体、工作流配置此知识库，不会删除知识库控制台中的知识库。
在知识库列表中，单击目标火山知识库对应的删除开关，解绑知识库。

启用/停用知识库

关联火山知识库后，知识库默认为启用状态。停用知识库后，即使智能体或工作流已引用了该知识库，其内容也不会被召回。
在知识库列表中，单击目标火山知识库对应的启用开关，可以启用或停用该知识库。

管理火山知识库

在知识库列表中，单击目标火山知识库，即可跳转到火山引擎控制台管理知识库，包括编辑、删除、查看知识库，以及添加内容、删除文件等操作。

常见问题

为什么关联时找不到自己创建的知识库？

在关联知识库时，仅允许关联空间所有者对应火山引擎账号（包括主账号、子账号）中的火山知识库。如果你是某工作空间的成员，并在自己的火山引擎账号中创建了火山知识库，但你的火山引擎账号和当前工作空间所有者的火山引擎账号不属于同一个主账号体系，那么你在该工作空间中无法关联自己创建的知识库。

关联火山知识库功能与火山知识库插件功能有什么区别？

扣子编程支持如下两种方式使用火山知识库，功能完全一致，主要区别如下：

• 关联火山知识库（推荐）：配置过程更为简便，无需设置复杂的参数。
• 添加火山知识库插件：需要 Access Key ID、Access Key Secret 等参数。若需了解火山知识库插件的具体操作，请参考使用火山知识库插件。