为支持用户在 Coze 智能体 bot 中调用 Viking DB 知识库的检索召回能力，我们基于火山引擎知识库 SDK，在 Coze 插件商城的发布上架了【火山知识库】插件。
目前已上架能力包括：

• search_knowledge【新】【推荐】：调用新版接口，基于输入 query，完成切片的检索召回，支持更多灵活参数配置，涵盖更多预处理选项、后处理选项、文档过滤选项等。

  详细接口说明：search_knowledge（新）--向量数据库VikingDB-火山引擎

• search_collection【旧】：调用旧版接口，基于输入 query，对知识库进行切片的检索召回，已不推荐使用，建议使用上面的新版能力。

  详细接口说明：search_collection--向量数据库VikingDB-火山引擎
  
  

2.1 开通 VikingDB 知识库服务

VikingDB 知识库服务的开通流程，共分为以下步骤：

1. 注册火山引擎账号。
2. 完成实名认证。
3. 开通知识库服务。

2.1.1 注册账号

• 进入 火山引擎官网，单击页面右上角的【立即注册】。
• 根据要求完整填写表单后即可完成注册，更多详情参考 火山引擎账号注册。

2.1.2 实名认证

• 使用已注册的火山引擎账号登录 火山引擎官网。
• 单击右上角账号名下拉框中的【账号管理】进入对应页面。
• 单击左侧导航中的【实名认证】，根据实际情况选择个人或者企业，并填写对应表单或上传相关材料完成实名认证，更多详情参考 实名认证。

2.1.3 开通知识库

登录 火山引擎控制台，根据对应的提示开通知识库服务。

2.2 创建知识库

• 知识库的操作指南详见产品文档
• 控制台-开通知识库服务

按照知识库服务的使用方式，进行文档上传和处理，并在检索测试页面进行召回效果调试

3.1. 在 Coze 智能体 Bot 中使用知识库完成知识问答

1. 在 Coze 左侧点击加号 【创建智能体】。

2. 在 bot 中搜索添加【火山知识库】插件。

3. 插件参数默认值预配置

使用插件前，需要配置输入参数。右侧【开启】开关打开时，参数的内容会交给大模型来填写。如果想要手动设置固定的值，请填写好默认值，并关闭【开启】开关，就可以将该参数锁定为此值。其中火山引擎知识库账号的 ak，sk 和 collection_name 都推荐锁定（如下图），这样就无需在每次对话输入时重复输入。

• Access Key ID（简称为 AK）用于标识用户，Access Key Secret（简称为 SK） 用于验证用户的密钥，请您妥善保管。
  AK/SK 密钥获取方式如下，更多详情请参考 Access Key（密钥）管理。
  1. 单击右上角账号名下拉框中的【API访问密钥】进入对应页面。
  2. 单击【新建密钥】按钮，可获取 AK/SK，可以此为凭证调用上述已接入应用的接口。

• collection_name 值为指定要进行检索召回的合法知识库名称
• 本工具的全部参数解读请参考：search_knowledge（新）--向量数据库VikingDB-火山引擎

4. 为确保智能体能够在对话中调用知识库插件，请在【人设与回复逻辑】中进行类似下图的提示词设计（根据您的场景灵活调整）

5. 完成上述配置后，在和 Bot 的对话中检索知识库内的文档切片，以辅助扣子 bot 的大模型回答。

4.1 创建工作流

1. 在 Coze / 工作空间 / 资源库中【+资源】，选择创建工作流。

4.2 工作流编排

1. 在工作流编排页面，点击【添加节点】，选择【插件】，搜索添加【火山知识库 】插件。

2. 按照如下顺序串联工作流。

3. search_knowledge插件参数配置

配置插件的输入参数，必填的信息包括 **** ak，sk 和 collection_name，其余可根据需要选填。

• Access Key ID（简称为 AK）用于标识用户，Access Key Secret（简称为 SK） 用于验证用户的密钥，请您妥善保管。
  AK/SK 密钥获取方式如下，更多详情请参考 Access Key（密钥）管理。
  1. 单击右上角账号名下拉框中的【API访问密钥】进入对应页面。
  2. 单击【新建密钥】按钮，可获取 AK/SK，可以此为凭证调用上述已接入应用的接口。

• collection_name 值为指定要进行检索召回的合法知识库名称
• 本工具的全部参数解读请参考：search_knowledge（新）--向量数据库VikingDB-火山引擎

4. 结束节点参数配置

在输出变量里选择search_knowledge插件的result_list，作为输出结果。

5. 测试并发布该工作流。

4.3 在 Coze 智能体 Bot 中使用

1. 在Coze智能体中添加刚刚创建的工作流。

2. 为确保智能体能够在对话中调用知识库插件，请在【人设与回复逻辑】中进行类似下图的提示词设计（根据您的场景灵活调整）

3. 完成上述配置后，在和 Bot 的对话中检索知识库内的文档切片，以辅助扣子 bot 的大模型回答。