实践手册：使用DTS RAGFlow注册DMS Dify外部知识库

步骤一：创建知识库并上传文件

1. 登录RAGFlow页面。

2. 创建知识库。

   1. 在页面右上角，单击创建知识库。

   2. 在弹出的创建知识库对话框，填入知识库的名称。

   3. 单击确定。

   4. 根据实际情况配置知识库，然后单击保存。

3. 在知识库中上传文件。

   1. 在知识库的数据集页面，选择新增文件 > 本地文件。

   2. 在弹出的上传文件对话框，选择并上传准备的本地文件。

   3. 勾选创建时解析。

   4. 单击确定。

步骤二：添加并连接外部知识库

1. 进入DMS的知识库页面。

   说明

   进入方法请联系DMS的技术支持人员。

   

2. 添加外部知识库API。

   1. 在页面右侧，单击外部知识库API。

   2. 单击添加外部知识库API。

   3. 配置外部知识库API信息。

      配置项	说明
      Name	建议您填入一个具有业务意义的名称，便于后续识别。
      API Endpoint	DTS RAGFlow知识库的API地址，格式为http://<IP>/api/v1/dify。 说明 <IP>需替换为DTS RAGFlow知识库的连接地址。 若您需要使用知识库内网地址，需要将DMS Dify所在交换机的IPv4网段，添加到DTS RAGFlow知识库的IP白名单；若您需要使用知识库外网地址，还需将DMS Dify的公网出口地址，添加到DTS RAGFlow知识库的IP白名单。
      API Key	RAGFlow知识库的API Key。 说明 获取方式，请参见获取RAGFlow知识库的API Key。

   4. 单击保存。

3. 连接外部知识库。

   1. 在页面右侧，单击外部知识库API面板的。

   2. 在创建知识库卡片中，单击连接外部知识库。

   3. 配置外部知识库信息。

      配置项	说明
      外部知识库名称	建议您填入一个具有业务意义的外部知识库名称，便于后续识别。
      知识库描述（可选）	填入外部知识库的描述信息，便于后续识别。
      外部知识库API	选择步骤2添加的外部知识库API。
      外部知识库ID	填入外部知识库的ID。 说明 获取方式，请参见获取RAGFlow知识库的ID。
      招回设置	根据实际情况，设置Top K和Score阈值。

   4. 单击连接。

      DMS的知识库页面，将出现以外部知识库名称为名称的卡片。

步骤三：基于外部知识库构建工作流等应用

在DMS控制台，使用该知识库进行大模型应用开发。

获取DTS RAGFlow知识库的连接地址

1. 进入目标地域的RAGFlow知识库列表页面。

   1. 登录数据传输服务DTS控制台。

   2. 在左侧导航栏，单击数据准备。

   3. 在页面左上角，选择数据准备实例所属地域。

   4. 单击RAGFlow 知识库页签。

2. 在目标RAGFlow知识库的操作列，单击管理。

3. 在连接地址区域，获取知识库内网地址或知识库外网地址。

获取RAGFlow知识库的API Key

1. 登录RAGFlow页面。

2. 在左侧导航栏，单击API。

3. 在RAGFlow API右侧，单击API KEY。

4. 在弹出的API KEY对话框，单击创建新密钥。

5. 单击，记录Token。

获取RAGFlow知识库的ID

1. 登录RAGFlow页面。

2. 在知识库页面，单击目标知识库。

3. 在当前页面的URL中，记录知识库的ID。

   说明

   id=之后的信息即为知识库的ID。

创建并使用聊天助手应用

1. 创建聊天助手应用。

   1. 在DMS的知识库页面，单击工作室页签。

   2. 单击聊天助手。

   3. 在创建应用卡片中，单击创建空白应用。

   4. 配置应用信息。

      配置项	说明
      选择应用类型	选择聊天助手。
      应用名称&图标	填入聊天助手应用的名称，并设置图标。
      描述（可选）	填入聊天助手应用的描述信息，便于后续识别。

   5. 单击创建。

2. 单击创建好的聊天助手应用。

3. 编排聊天助手应用。

   1. 根据实际需求，填入提示词。

   2. 在知识库区域，单击添加。

   3. 选择步骤3配置的外部知识库，并单击添加。

   4. 根据实际情况，配置招回设置，并单击保存。

   5. 在页面右上角，选择聊天助手应用需使用的模型。

4. 在和机器人聊天文本框中，填入咨询问题进行测试。