一、项目目标¶

这个项目的目标是：

• 把员工手册和培训手册导入 RAGFlow；
• 做一个公司内部知识问答助手；
• 再把它嵌入 OA 或企业内部页面。

二、准备知识文档¶

如果你没有现成资料，可以先用生成式工具快速构造演示文档。

示例思路：

• 生成一份员工手册；
• 再生成一份技术部内部培训手册；
• 把它们整理成可上传文档。

三、创建知识库¶

点击右上角：

+创建知识库

然后进入“数据集”，上传本地文件：

上传后先做搜索测试，验证切片和检索效果是否正常：

四、创建 Agent¶

进入：

Agent -> +创建 Agent

4.1 配置知识检索¶

把知识检索卡片接上知识库，并设置 Rerank 模型。

4.2 配置系统提示词¶

在“生成回答”卡片里设置系统提示词，重点约束：

• 只回答员工手册相关问题；
• 不相关问题礼貌拒绝；
• 回答简洁；
• 不编造知识库没有的内容。

五、试运行与调试¶

配置完成后，先试运行，看几个典型问题能否回答正确：

• 公司上下班时间？
• 请病假的流程是什么？
• 技术资源访问方式有哪些？

调试通过后再保存。

六、嵌入 OA 或内部系统¶

6.1 获取 API Key¶

在右上角头像的 API 管理里创建密钥。公开文档里只保留占位形式：

• RAGFLOW_API_KEY=<your-api-key>

6.2 获取嵌入代码¶

回到 Agent 页面，选择“嵌入网站”。

如果你要给 OA 页面做演示，建议把嵌入代码中的真实地址替换成占位版本，例如：

<iframe
  src="http://<your-ragflow-host>/chat/share?shared_id=<your-share-id>&from=agent"
  style="width: 100%; height: 100%; min-height: 600px"
  frameborder="0">
</iframe>

不要把真实 IP、共享 ID 或鉴权参数直接写进公开文章。

七、为什么这个案例适合用来验证 RAGFlow¶

因为它很好地利用了 RAGFlow 的强项：

• 文档理解能力强；
• 检索链路完整；
• 适合知识边界清晰的企业内部问答；
• 最终还能嵌入现有系统，具备真实落地感。

八、一个实用结论¶

如果你的重点是“把复杂文档变成靠谱问答能力”，RAGFlow 很值得深挖；如果你的重点是“快速拼应用和工作流”，FastGPT 会更灵活。把这两个系统都做一遍，对 RAG 落地的理解会非常扎实。