说明
本文主要介绍了如何在 Coze 平台上使用火山引擎的 VikingDB 知识库服务来构建 RAG（检索增强生成）能力。
为支持用户在 Coze 智能体 bot 中调用 Viking DB 知识库的检索召回能力，我们基于火山引擎知识库 SDK，在 Coze 插件商城的发布上架了【火山知识库】插件。
目前已上架能力包括：
search_knowledge【新】【推荐】：调用新版接口，基于输入 query，完成切片的检索召回，支持更多灵活参数配置，涵盖更多预处理选项、后处理选项、文档过滤选项等。
search_collection【旧】：调用旧版接口，基于输入 query，对知识库进行切片的检索召回，已不推荐使用，建议使用上面的新版能力。
2.1 开通 VikingDB 知识库服务
VikingDB 知识库服务的开通流程，共分为以下步骤：
- 注册火山引擎账号。
- 完成实名认证。
- 开通知识库服务。
2.1.1 注册账号
2.1.2 实名认证
- 使用已注册的火山引擎账号登录 火山引擎官网。
- 单击右上角账号名下拉框中的【账号管理】进入对应页面。
- 单击左侧导航中的【实名认证】，根据实际情况选择个人或者企业，并填写对应表单或上传相关材料完成实名认证，更多详情参考 实名认证。
2.1.3 开通知识库
登录 火山引擎控制台，根据对应的提示开通知识库服务。
2.2 创建知识库
- 知识库的操作指南详见产品文档
- 控制台-开通知识库服务
按照知识库服务的使用方式，进行文档上传和处理，并在检索测试页面进行召回效果调试
3.1. 在 Coze 智能体 Bot 中使用知识库完成知识问答
说明
这里给出在 Coze 智能体的编排链路中，使用 VikingDB 知识库的 RAG 能力的最佳实践，即直接在 bot 中添加方舟知识库 search_knowledge 插件，如需更复杂的编排流程也可以在工作流中使用此插件。
- 在 Coze 左侧点击加号 【创建智能体】。
- 在 bot 中搜索添加【火山知识库】插件。
- 插件参数默认值预配置
使用插件前，需要配置输入参数。右侧【开启】开关打开时，参数的内容会交给大模型来填写。如果想要手动设置固定的值，请填写好默认值，并关闭【开启】开关，就可以将该参数锁定为此值。其中火山引擎知识库账号的 ak，sk 和 collection_name 都推荐锁定（如下图），这样就无需在每次对话输入时重复输入。
- Access Key ID（简称为 AK）用于标识用户，Access Key Secret（简称为 SK） 用于验证用户的密钥，请您妥善保管。
AK/SK 密钥获取方式如下，更多详情请参考 Access Key（密钥）管理。- 单击右上角账号名下拉框中的【API访问密钥】进入对应页面。
- 单击【新建密钥】按钮，可获取 AK/SK，可以此为凭证调用上述已接入应用的接口。
- collection_name 值为指定要进行检索召回的合法知识库名称
- 本工具的全部参数解读请参考：search_knowledge（新）--向量数据库VikingDB-火山引擎
- 为确保智能体能够在对话中调用知识库插件，请在【人设与回复逻辑】中进行类似下图的提示词设计（根据您的场景灵活调整）
- 完成上述配置后，在和 Bot 的对话中检索知识库内的文档切片，以辅助扣子 bot 的大模型回答。
说明
这里给出通过编排工作流调用VikingDB插件的最佳实践，可以用来解决更复杂的需求。即在工作流中添加方舟知识库 search_knowledge 插件，然后再在智能体中使用该工作流。
4.1 创建工作流
- 在 Coze / 工作空间 / 资源库中【+资源】，选择创建工作流。
4.2 工作流编排
- 在工作流编排页面，点击【添加节点】，选择【插件】，搜索添加【火山知识库 】插件。
- 按照如下顺序串联工作流。
- search_knowledge插件参数配置
配置插件的输入参数，必填的信息包括 **** ak，sk 和 collection_name，其余可根据需要选填。
- Access Key ID（简称为 AK）用于标识用户，Access Key Secret（简称为 SK） 用于验证用户的密钥，请您妥善保管。
AK/SK 密钥获取方式如下，更多详情请参考 Access Key（密钥）管理。- 单击右上角账号名下拉框中的【API访问密钥】进入对应页面。
- 单击【新建密钥】按钮，可获取 AK/SK，可以此为凭证调用上述已接入应用的接口。
- collection_name 值为指定要进行检索召回的合法知识库名称
- 本工具的全部参数解读请参考：search_knowledge（新）--向量数据库VikingDB-火山引擎
- 结束节点参数配置
在输出变量里选择search_knowledge插件的result_list，作为输出结果。
- 测试并发布该工作流。
4.3 在 Coze 智能体 Bot 中使用
- 在Coze智能体中添加刚刚创建的工作流。
- 为确保智能体能够在对话中调用知识库插件，请在【人设与回复逻辑】中进行类似下图的提示词设计（根据您的场景灵活调整）
- 完成上述配置后，在和 Bot 的对话中检索知识库内的文档切片，以辅助扣子 bot 的大模型回答。