> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coze.cn/llms.txt
> Use this file to discover all available pages before exploring further.

扣子编程支持关联火山知识库，关联成功后，你可以在扣子编程的低代码智能体、应用、工作流中使用火山知识库。
## 背景信息 {#053adc8c}
[火山知识库](https://www.volcengine.com/docs/84313/1254439)是火山引擎推出的一款知识管理工具，能够将存储于指定链接或对象存储服务（TOS）中的海量文档高效导入知识库，并依次完成文档的解析、切片、向量化以及索引构建等一系列深度处理流程。处理完成后，你可以基于知识库进行知识检索工作，快速获取所需信息。更多信息，请参考[创建知识库](https://www.volcengine.com/docs/84313/1254463)。
与扣子知识库相比，火山知识库更适合企业用户场景，支持更大的存储空间、更高的 QPS 、更精细的切片管理和更复杂的文档处理需求，能够满足企业客户对于大规模知识库的存储需求。
## 注意事项 {#d12aabb6}
在使用火山知识库前，请阅读以下注意事项。
<!-- @cols-width: 189,599 -->
| | | \
|**事项** |**说明** |
|---|---|
| | | \
|阅读相关文档 |关联火山知识库前，请先阅读[知识库概述](/guides/knowledge)、[使用限制](/guides/knowledge_limits)了解其功能特性及使用限制。 |
| | | \
|订阅套餐 |扣子付费套餐用户支持关联火山知识库。 |
| | | \
|操作限制 |* 不支持跨空间复制、迁移火山知识库。 |\
| |* 仅允许关联**空间所有者**对应火山引擎账号（包括主账号、子账号）中的火山知识库。 |\
| |* 暂时只支持通过页面关联火山知识库，不支持通过扣子编程 API 关联火山知识库。 |

## 费用说明 {#872cf566}
在扣子编程使用火山知识库时，知识库内容的存储、召回与重排操作均在火山知识库侧完成，然后由扣子大模型进行内容总结并返回给用户。因此存储、召回与重排会产生火山知识库费用，由火山方舟大模型服务平台收取，不支持通过扣子积分抵扣。火山知识库侧收取的费用如下，详情请参考[知识库计费](https://www.volcengine.com/docs/84313/1414457)。

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

:::notice 注意
* 创建火山知识库后上传文档，系统将自动分配和预留知识库所需的计算资源，并开始计费。
* 删除文档不会影响计算资源的占用，仍会继续计费。如果你不再需要使用**火山知识库**，请及时解绑并前往[火山引擎控制台](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/collection/list)删除火山知识库以停止计费。
:::
## 前提条件 {#6f50e359}
已开通火山知识库服务。具体操作，请参考[开通服务](https://www.volcengine.com/docs/84313/1254444#%E5%BC%80%E9%80%9A%E5%90%91%E9%87%8F%E6%95%B0%E6%8D%AE%E5%BA%93-%E7%9F%A5%E8%AF%86%E5%BA%93)。
## 操作步骤 {#657b7a67}
### 步骤 1：创建火山知识库 {#18ca66f7}
在创建火山知识库时，你可以根据具体的知识召回需求，配置知识库的数据类型、文本向量化模型、向量维度、切片方式、CPU 配额以及索引算法等参数，实现高效的知识管理和精准检索。

1. 在[火山引擎知识库控制台](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/collection/list)，单击**创建知识库**。
2. 在**创建知识库**页面的**基本信息**区域，完成如下配置。
   具体参数配置说明，请参考[创建知识库](https://www.volcengine.com/docs/84313/1254463)。
   ![Image=460x327](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/5ef9cc45fedc41dbaa7a5c114447ae89~tplv-goo7wpa0wc-image.image)
3. （可选）在**创建知识库**页面的**高级配置**区域，创建标签。
   标签用于对知识库文档进行分类与过滤，提升知识库的检索效率。添加标签后，后续在扣子编程的低代码智能体、工作流中使用火山知识库时，将先在标签范围内检索文档，然后结合召回策略返回结果。
   :::notice 注意
   * 仅旗舰版支持创建标签，且仅支持在创建知识库时创建标签。更多信息，请参考[创建知识库](https://www.volcengine.com/docs/84313/1254457)。
   * 创建知识库后不支持再变更标签名称，请在创建时确认标签名称无误。
   :::
   常见的应用场景包括：
   * 用户反馈分类：为用户反馈的文档打标签，例如产品问题、物流延迟问题。
   * 内容审核与推荐：对用户上传的文本或图片文档打标签，例如敏感内容、热门话题。
   * 商品分类：给商品图片或描述相关的文档打标签，例如家电、服饰等，提高查询效率。
   ![Image=621x235](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/e8ef25b9374944a98829deb83e6792c2~tplv-goo7wpa0wc-image.image)
4. 单击**创建知识库**。
   在弹出的**知识库创建成功**对话框中，单击**立即导入**，导入文档。
   ![Image=462x345](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/49e4dc29bae14b6284145e85a9cc185d~tplv-goo7wpa0wc-image.image)

### 步骤 2：导入文档 {#27c02aff}
创建火山知识库后，你可以在**导入文档**页面，通过本地上传、从 TOS 中导入、飞书文档、公开下载链接等方式导入文档。具体操作，请参考[导入文档](https://www.volcengine.com/docs/84313/1254469)。
![Image=503x296](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/666a457c4534456195e02f31983cf88d~tplv-goo7wpa0wc-image.image)
### 步骤 3：为文档添加标签 {#60c1b6f4}
火山知识库的标签功能用于对知识库文档进行分类与过滤，提升知识库的检索效率。添加标签后，后续在知识库检索时，将先在标签范围内检索文档，然后结合召回策略返回结果。
如果要通过标签功能筛选文档，则你在创建标签后，还需为文档添加标签及设置标签值。具体操作，请参考[标签编辑](https://www.volcengine.com/docs/84313/1254450)。
![Image=637x269](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/7e021014b45942d986539e2e37898b7b~tplv-goo7wpa0wc-image.image)
### 步骤 4：查看切片详情 {#77af5982}
导入文档后，系统会自动对内容进行切片。如果切片不满足预期，可重新调整切片规则或对原始文档进行更加规范化的加工。具体操作，请参考[新增切片](https://www.volcengine.com/docs/84313/1389038)。
![Image=633x112](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/403b0471edc349fc8c69758d09e114f2~tplv-goo7wpa0wc-image.image)
### 步骤 5：创建知识服务 {#bb3cc852}
导入文档后，系统将自动构建索引，大约需要 3～5 分钟。索引构建完成后，你可以通过调整知识检索参数来调优该知识库的检索能力。调优完成后，需将对应的检索配置发布为知识服务，扣子编程将通过**知识服务**直接获取已召回的内容，并返回给用户查看。
:::tip 说明
如果修改了检索参数配置，需先发布为新的知识服务，并在扣子编程中选择新知识服务后，扣子编程才会根据新配置召回知识库内容。
:::
在火山知识库的**知识检索**页签下，单击**创建服务调用**，创建知识检索类型的服务调用。具体操作，请参考[创建知识服务](https://www.volcengine.com/docs/84313/1254449)。
![Image=643x294](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a21c6ac973a344b491af23bb4d6f7481~tplv-goo7wpa0wc-image.image)
### 步骤 6 ：关联火山知识库 {#912dcbfe}
创建知识服务后，你可以在扣子编程关联火山知识库。将火山知识库关联到扣子编程，是将火山知识库作为扣子编程资源的一种，加入到扣子编程资源库中。关联成功后，开发者便可在扣子编程的智能体、工作流、应用中使用火山知识库。
1. 登录[扣子编程](https://code.coze.cn/home)。
2. 在页面顶部选择目标工作空间，然后在左侧导航栏中单击**资源库**。


3. 在页面右上角，选择**+资源** > **知识库。**
4. 单击**关联火山知识库**，选择待关联的火山知识库，然后单击**创建并导入**。
   * **火山项目**：选择目标知识库所在的火山引擎项目。
   * **选择知识库**：选择目标火山知识库。
   ![Image=324x305](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/9ef478130dbe40e8af99c11aa70884b7~tplv-goo7wpa0wc-image.image)

## 相关操作 {#c3384d6c}
火山知识库的关联者将成为该知识库在扣子编程的创建者，可以在扣子编程对该知识库进行启用、暂停、解绑操作。
### 解绑知识库 {#227ba348}
:::notice 注意
解绑某个知识库后，引用了该知识库的智能体或工作流将自动取消引用。
:::
如果不再需要使用该火山知识库，可以在扣子编程上执行解除绑定操作。解除绑定，表示删除扣子编程和指定火山知识库的绑定关系，后续无法为智能体、工作流配置此知识库，不会删除[知识库控制台](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/collection/list)中的知识库。
在知识库列表中，单击目标火山知识库对应的**删除**开关，解绑知识库。
![Image=645x65](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/ff1f873a726043b585a15223d51dc11f~tplv-goo7wpa0wc-image.image)
### 启用/停用知识库 {#6e135beb}
关联火山知识库后，知识库默认为启用状态。停用知识库后，即使智能体或工作流已引用了该知识库，其内容也不会被召回。
在知识库列表中，单击目标火山知识库对应的**启用**开关，可以启用或停用该知识库。
![Image=652x66](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/8fb1364d15b74f81a40d5df95196c5ee~tplv-goo7wpa0wc-image.image)
### 管理火山知识库 {#9a9b5b70}
在知识库列表中，单击目标火山知识库，即可跳转到[火山引擎控制台](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/collection/list)管理知识库，包括编辑、删除、查看知识库，以及添加内容、删除文件等操作。
![Image=661x90](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/661a33169ded46369a80618b11aeab55~tplv-goo7wpa0wc-image.image)
:::notice 注意
* 如果你不再需要使用**火山知识库**，请及时解绑并前往[火山引擎控制台](https://console.volcengine.com/vikingdb/knowledge/region:vdb-knowledge+cn-beijing/collection/list)删除火山知识库以停止计费。具体操作，请参考[删除知识库](https://www.volcengine.com/docs/84313/1254459)。
* 删除某个知识库文件后，引用了对应知识库的智能体或工作流将无法召回该内容。
* 删除某个知识库后，引用了该知识库的智能体或工作流将自动取消引用。
* 删除操作不可撤回，请谨慎操作。
:::
## 常见问题 {#c76e33b6}
### 为什么关联时找不到自己创建的知识库？ {#550a2810}
在关联知识库时，仅允许关联**空间所有者**对应火山引擎账号（包括主账号、子账号）中的火山知识库。如果你是某工作空间的成员，并在自己的火山引擎账号中创建了火山知识库，但你的火山引擎账号和当前工作空间所有者的火山引擎账号不属于同一个主账号体系，那么你在该工作空间中无法关联自己创建的知识库。
### 关联火山知识库功能与火山知识库插件功能有什么区别？ {#95bad631}
扣子编程支持如下两种方式使用火山知识库，功能完全一致，主要区别如下：

* 关联火山知识库（推荐）：配置过程更为简便，无需设置复杂的参数。
* 添加火山知识库插件：需要 Access Key ID、Access Key Secret 等参数。若需了解火山知识库插件的具体操作，请参考[使用火山知识库插件](https://www.volcengine.com/docs/84313/1528465)。