智能体对接
把企业管理智能体接入 RuoYi Office 企业管理一体化平台，员工无需离开业务页面，就能通过 AI 助手查询数据、理解当前业务，并在确认后生成业务草稿。也可以单独打开智能体工作台，继续同一段对话。
本组教程面向平台实施人员与管理员，重点讲清楚：在哪配置、如何打通登录、怎样启用，以及不需要时怎样关闭。
先分清两个产品
RuoYi Office 平台负责组织、账号、权限、流程与业务数据；企业管理智能体负责对话、知识与业务能力编排。两者是独立应用，不是打开一个前端按钮就完成部署。尚未部署智能体时，可以先关闭平台 AI 助手，不影响平台其他业务。
接入后的使用方式
- 业务页内使用：点击平台右侧 AI 助手，展开对话面板；按需引用当前页面的业务上下文。
- 独立工作台使用：通过面板的新窗口入口或管理员配置的菜单，打开
/ai/work。 - 管理与开发：有相应角色权限的人员进入智能体管理、模型服务与能力配置；普通员工不因此获得管理员权限。
这里的“对接”包含三件事：入口可访问、账号可登录、业务可执行。只出现助手图标，不代表单点登录和财务等业务场景已经验收通过。
建议实施顺序
- 先部署两套应用：确认平台本身可正常登录，智能体前后端、独立数据库及 Redis 已准备好。
- 配置地址与单点登录：让浏览器能打开智能体，让智能体后端能访问平台后端，配置 OAuth2 客户端。
- 配置平台入口：设置助手开关和智能体地址，重新构建平台 PC 前端。
- 按角色开放能力：员工开放工作台，专用管理员维护智能体、模型和能力；业务权限仍在平台侧管理。
- 先验收基础对话，再验收业务：发票报销还需要 OCR、兼容的财务接口和员工基础资料。
从哪里开始阅读
- 接入配置与单点登录：本地与生产地址、OAuth2、菜单权限及反向代理。
- AI 助手启用与停用：个人关闭、右侧贴边、全站关闭与恢复。
- 联调验收与常见问题：登录循环、白屏、无流式输出与上线检查。
需要从源码开始启动或部署智能体，请阅读：
推荐生产形态
推荐在同一 HTTPS 域名下，通过不同路径提供服务：平台入口例如 /web/，智能体入口 /ai/。Nginx 将智能体 API 转到独立后端，其他 API 仍交给平台后端。
平台和智能体使用各自的运行配置与数据库账号。AgentOS 不需要持有平台数据库账号；平台集成 SQL 由平台管理员审核执行。
源码交付说明
客户本地与私有化部署默认关闭公开演示体验控制，无需体验码；商业 License 默认关闭，无需配置验签公钥。源码使用范围按合同约定，不以助手开关售卖席位或 Token。
