开始使用

安全组规则修改（可选）

安全组实际是网络流量访问策略，包括网络流量入方向规则和出方向规则，通过这些规则为安全组内具有相同保护需求并且相互信任的云服务器、云容器、云数据库等实例提供安全保护。

如果您的实例关联的安全组策略无法满足使用需求，比如需要添加、修改、删除某个TCP端口，请参考以下内容进行修改。

• 添加安全组规则：根据业务使用需求需要开放某个TCP端口，请参考添加安全组规则添加入方向规则，打开指定的TCP端口。
• 修改安全组规则：安全组规则设置不当会造成严重的安全隐患。您可以参考修改安全组规则，来修改安全组中不合理的规则，保证云服务器等实例的网络安全。
• 删除安全组规则：当安全组规则入方向、出方向源地址/目的地址有变化时，或者不需要开放某个端口时，您可以参考删除安全组规则进行安全组规则删除。

RAGFlow的使用

1. 访问RAGFlow登录网址。
   图1 RAGFlow登录网址
   
   图2 RAGFlow登录界面，单击Sign up用邮箱注册RAGFlow账户
   
   图3 进入RAGFlow注册界面，依次输入相关信息进行账号注册
   

2. 根据注册的账号完成登录，在RAGFlow主页按需求修改语言设置。
   图4 语言选择界面
   

3. 获取模型API Key。登录Maas平台，在左侧导航栏，单击“API Key管理”（最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥）。如已有apikey请下拉到步骤5继续模型配置。
   图5 API Key管理
   

4. 在“API Key管理”页面，单击右上角“创建API Key”，填写标签（自定义API Key的标签，标签具有唯一性，不可重复。仅支持大小写英文字母、数字、下划线、中划线，长度范围为1~100个字符）和描述（自定义API Key的描述，长度范围为1~100个字符）信息后，单击“确定”。标签和描述信息在创建完成后，不支持修改。
   图6 创建API Key
   

5. 模型配置。
   图7 单击头像进入模型配置页面
   

6. 找到模型供应商版块。
   图8 模型供应商版块所在位置
   

7. 单击模型供应商版块开始配置模型，接下来以已有API Key（OpenAI兼容）为示例进行演示。
   图9 模型供应商版块
   

8. 如图所示，在右侧可选模型列表下拉找到OpenAI-API-Compatible，单击打开。依次填写API base URL、API key，如何填写详见说明。实例名称可以任意填写。
   图10 OpenAI-API-Compatible
   
   

   模型配置华为云Maas为样例：API base URL固定填写："https://api.modelarts-maas.com/v1”,API key填写：步骤3创建apikey或使用已有apikey；

   选择模型需要注意：模型已经开通，查询地址：华为云Maas模型列表。

9. 在填写好API base URL、API key后单击模型列表勾选验证模型，这里选择的所有模型。
   图11 模型列表勾选验证模型
   

10. 单击验证后等待一段时间出现下图所示的API密钥有效则可以单击确认完成模型配置。
    图12 API密钥验证有效
    

11. 根据配置好的模型，设置RAGFlow默认模型，到此模型配置完毕。
    图13 模型配置完毕
    

RAGFlow基础使用指南

1. 在知识库版块单击中间“+”号创建知识库。
   图14 知识库版块
   

2. 根据个人需求命名知识库，选择嵌入模型，解析方法。其中若选择内置解析方法需要选择内置好的分块方法；选择pipeline解析方法则需要自己通过智能体构建满足用户个性的文档处理方法。怎么选择详见说明。
   图15 知识库配置页面（选择内置解析方法版）
   
   图16 知识库配置页面（选择pipeline解析方法版）
   
   图17 单击Scratch构建跳转到此页面，根据需要在此构建满足用户个性的文档处理方法
   
   

   ✅ 优先选择 Built-in

   1. 文档类型单一（普通规章制度、说明书、简单 PDF、Word）
   2. 追求快速搭建知识库，不想复杂配置
   3. 不需要对文本做 LLM 预处理（不需要自动生成摘要、问题）
   4. 中小体量知识库，业务需求简单

   ✅ 优先选择 Pipeline

   1. 文档混杂：同时存在 PDF、扫描件、Excel、图片，希望不同文件使用不同解析方案
   2. 需要增强检索效果：给每个分块自动生成摘要、检索问句、关键词
   3. 内置策略效果不好，需要自定义分块逻辑、文本清洗规则
   4. 使用 MinerU、多模态 VLM 解析等第三方文档理解模型
   5. 金融财报、论文、复杂版式文档，精细化控制解析流程
   6. 多知识库共用一套标准化处理流程（Pipeline 可以复用）

3. 知识库填充。以创建知识库时选择内置解析方法进行知识库填充举例。
   图18 单击新建文件进行知识库填充，可根据需求选择上传文件或新建空文件进行知识库填充
   
   图19 这里以上传文件填充知识库举例。在上传时勾选创建时解析
   
   图20 如图所示，当箭头所指显示为小绿点时文档解析成功
   
   图21 单击检索测试进行知识检索测试，通过相似度阈值和向量相似度权重调整知识库问答效果
   

4. 创建ragflow聊天。
   图22 单击创建聊天
   
   图23 配置聊天知识库
   

   

   图24 配置成功后进行聊天测试
   

5. 基于知识库创建搜索应用
   图25 搜索应用创建
   
   

   图26 测试结果
   

6. 在RAGFlow中搭建智能体。
   图27 根据需要选择工作流式智能体搭建形式进行智能体搭建
   

7. 创建记忆库储存相关记忆
   图28 记忆创建
   

   

   图29 单击高级设置进行记忆权限设置