OfficeAce 集成 RAGFlow 华为云完整落地指南

本文通过OfficeAce 提示词生成API Skill，无缝对接华为云一键部署 Ragflow，实现上层办公交互与底层知识库底座的完美拆分。

随着市面上各个厂商陆续推出AI办公助手，借助AI办公助手提高办公效率似乎成了大势所趋。但是如果长期在办公中使用就会面临历史创作的报告、方案、资料零零散散，无法根据用户自主意愿进行系统化，结构化的存储的问题，这导致每次用户花大量时间定位所需要的文件，或者消耗token重新生成。并且由于AI幻觉的问题，生成的内容用户要用于生产必须经过人工审视。重复的内容生成和不断的内容审视，这对用户的精力以及资源无疑是一种没有意义的消耗。

当然这一问题也有解决方法——给AI助手配上一个知识库存储产出。现如今很多AI办公助手的厂商也陆续添加了知识库部分功能，但是内置的知识库也有一定的使用局限。比如要批量上传隐私文件就会存在数据安全问题。可不使用内置知识库就只有自建本地私有知识库，自建本地私有知识库有一定的技术门槛，并且就算建好了知识库，如何接入AI办公助手也是一大问题。

为了让大多数才接触不久AI的朋友都能用上“自带”本地私有知识库的AI办公助手，本文带来一套近乎零开发门槛、极简部署、全员可用的创新联动方案：华为云一键部署 Ragflow + OfficeAce API Skill 集成方案。依托云原生一键部署能力+对话式Skill编排，让普通办公人员无需任何RAG专业知识，也能拥有专属私有知识库AI办公助手。

2.RAGFlow已上线华为云一键部署

不用头疼搭建本地私有知识库要进行的镜像拉取，容器部署等相关技术问题，只需要动动鼠标在华为云解决方案实践栏目点点点就能完成本地私有知识库的搭建。用于搭建RAGFlow的机器如果不使用了可以进行一键删除，大幅降低数据泄露的风险。

二、RAGFlow + OfficeAce 手把手实现教学

1. 环境准备

（1）OfficeAce下载

下载地址：https://www.huaweicloud.com/product/agentarts/officeace.html

图1 OfficeAce下载页

（2）RAGFlow部署

第一步，点击链接进入RAGFlow部署详情页。

部署详情页链接：https://www.huaweicloud.com/solution/implementations/building-an-enterprise-grade-knowledge-base-with-ragflow.html

图2 部署详情页

第二步，点击开始部署跳转部署页，开始部署。

图3 部署页

第三步，进入RFS一键部署，点击下一步创建资源栈。

图4 创建资源栈

图5 参数填写页

第四步，按照提示填写相关参数。

第五步，根据个人需求选择是否开启加密，密钥类型及获取方式详见说明。

图6 加密密钥类型选择

说明：

1. 默认密钥

定义：当前账号、当前区域下，由OBS等其它云服务首次调用密钥管理服务时自动创建，密钥别名后缀固定为“/default”，由平台统一托管。

获取方式：无需手动创建，OBS等其它云服务首次调用DEW加密功能自动生成，可在密钥管理界面查询，刷新下拉框即可使用。

核心特点：可在密钥管理界面查询；不支持禁用、计划删除、共享，用户无自主管控权限。基础托管免费，仅超额API请求计费。每个密钥每月享有 20000 次 API 调用免费额度。单击价格计算页通过价格详情栏查看超额API请求计费详情。

适用场景：小型正式环境、轻度合规需求，快速加密场景。

2. 自定义密钥

定义：用户在当前账号、对应区域自行通过KMS创建或导入的密钥，用户全权管控。

获取方式：DEW控制台→同区域→创建密钥→刷新密钥列表选用。

核心特点：支持密钥轮换、审计、禁用删除、跨账号共享；按需计费，单击价格计算页查看计费详情；权限自主可控。

适用场景：企业生产环境、等保合规、需密钥管控与共享的场景。

3. 共享密钥

定义：其他华为云账号创建的自定义密钥，通过RAM资源共享授权给当前账号使用（默认密钥不支持共享）。

获取方式：1. 归属账号创建自定义密钥，通过RAM共享至当前账号；2. 当前账号接受共享邀请，保证密钥与区域一致，刷新即可使用。

核心特点：仅可使用、无权修改管控；对方取消共享/删除密钥即失效；由密钥归属方付费。

适用场景：大型企业多账号架构，密钥统一由安全账号托管的合规场景。

4.最简选型总结

个人/测试：关闭加密，无需密钥（建议）

普通正式环境：默认密钥（免费免配置）

企业合规生产：自定义密钥（自主可控）

企业多账号架构：共享密钥（统一托管）

第六步（可选，如果使用华为主账号或admin用户组下的IAM子账户可不选委托）在资源设置界面中，在权限委托下拉框中选择“rf_admin_trust”委托，单击“下一步”。

图7 资源栈设置

第七步，确认配置，然后单击“创建执行计划”。

图8 配置确认

第八步，在显示的对话框中，输入执行计划名称，然后单击确定。

图9 创建执行计划

第九步，等待执行计划状态变为可用，然后在操作列中单击部署。在显示的对话框中，单击执行。

图10 执行计划

图11 确认执行计划

第十步，（可选）如果计费模式选择“包年包月”，在余额不充足的情况下（所需总费用请参考x-wc://file=zh-cn_topic_0000002724013277.html#table1865715108296）请及时登录费用中心，手动完成待支付订单的费用支付。

第十一步，待“事件”中出现“Apply required resource success”，堆栈部署成功，表示顺利完成资源的下发和部署。堆栈部署成功后，平台部署脚本开始执行，耐心等待10分钟左右（受网络波动影响）。

图12 部署完成

图13 查看访问链接

第十二步，通过3030端口查看RAGFlow部署进程。

图14 RAGFlow实时部署日志查看页

图15 部署成功后，单击进入服务开始使用RAGFlow。

2. RAGFlow配置

在部署完成后的输出页查看并访问RAGFlow登录网址，单击Sign up用邮箱注册RAGFlow账户，进入RAGFlow注册界面，依次输入相关信息进行账号注册。

图16 RAGFlow登录网址

图17 RAGFlow登录界面

图18 RAGFlow注册界面

根据注册的账号完成登录，在RAGFlow主页按需求修改语言设置。

图19 语言选择界面

获取模型API Key。登录MaaS平台，在左侧导航栏，单击“API Key管理”（最多可创建30个密钥。每个密钥仅在创建时显示一次，请确保妥善保存。如果密钥丢失，无法找回，需要重新创建API Key以获取新的访问密钥）。

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

图20 API Key管理

图21 创建API Key

模型配置：单击头像进入模型配置页面。

图22 单击头像

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

图24 模型供应商版块

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

图25 OpenAI-API-Compatible

说明：

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

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

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

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

图26 模型列表验证模型

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

接下来就可以将RAGFlow接入OfficeAce开始使用了。

图28 模型配置完毕

3. OfficeAce集成RAGFlow

RAGFlow（华为云）：承担底层核心能力，一键完成部署、文档解析、智能分块、向量存储、精准检索，提供稳定的知识库底座

OfficeAce：承担上层办公交互、AI创作、用户操作入口，屏蔽所有底层技术细节

图29 创建skill

图30 skill核心能力

图31 API key和API服务器地址

单击自己的头像，进入左侧最下方API栏目，就能看到图31中对应的API key和服务地址，将信息发送给Office ace就能轻松实现两者的对接。

图32 链接成功

整套方案无需修改源码、无需复杂开发，依托API Skill轻量集成，快速落地私有知识库办公体系。

三、核心能力落地展示

1. 创作即存库，存量可复用

方案打通了办公文档的完整沉淀链路，支持两类文件入库。

（1）AI创作文件入库

用户在OfficeAce完成报告、方案、制度等文档创作后，可通过自然语言提示词，自主选择是否将生成文件存入RAGFlow私有知识库，按需沉淀优质创作内容，避免垃圾草稿污染库体。这里展示的是测试使用skill生成报告直接上传的场景，由图可见已经成功上传文件并完成了文档解析。

图33 skill生成并上传文件

图34 上传结果

​

（2）本地存量文件入库

用户可直接在OfficeAce界面上传本地已有办公文档，无需跳转Ragflow后台，一站式完成文件上传入库。以下是一个简单的上传示例：

图34 本地文件上传

2. 智能自适应分块，彻底解放用户双手

本方案核心创新点为将RAG分块策略的决策层上移至OfficeAce。

传统方案需要用户手动调整chunk大小、重叠度、解析规则；本方案中，Office Ace可以根据文档格式、文档长度、办公场景类型，智能生成适配的解析分块参数，通过API同步给Ragflow执行。另外，还可以通过对话进行解析和分块方法的个性化调整。

图35 调整解析分块方法

图36 效果呈现

全程用户无需感知任何RAG技术参数，系统自动保障常规办公文档的解析、分块、入库质量，完美适配零基础办公人群。

3. 私有知识库约束问答，大幅降低模型幻觉

依托Ragflow精准检索能力，用户提问时，OfficeAce会优先调用私有知识库检索片段，将专属业务资料注入提示词约束模型输出。

AI回答不再依赖通用大模型知识，全部基于用户自有真实文档生成，支持内容溯源，极大降低大模型凭空编造的幻觉问题，大幅提升办公问答、文档改写、业务咨询的可靠性。

图37 效果呈现

四、方案优势对比呈现

（1）使用门槛对比

（2）回答可靠性对比

适用人群变化：

单独 RAGFlow：面向开发者、运维人员；

联动之后：普通办公人员、中小团队业务人员均可上手。

五、总结与展望

AI办公的下半场，不再是“会不会生成文档”，而是能不能沉淀知识、能不能精准复用、能不能可靠输出。RAGFlow + OfficeAce 的联动方案，打破了传统RAG高门槛、传统AI办公无沉淀的双重痛点，以轻量化集成、极简操作、高可靠输出的核心优势，为个人与中小团队提供了一套可快速落地的智能化办公解决方案。

相关链接：

华为云RAGFlow一键部署链接：https://www.huaweicloud.com/solution/implementations/building-an-enterprise-grade-knowledge-base-with-ragflow-deploy.html

OfficeAce下载链接：https://www.huaweicloud.com/product/agentarts/officeace.html

最后，欢迎各位加入解决方案实践交流群与方案作者，技术开发者交流。

加入链接：https://bbs.huaweicloud.com/blogs/489693