部署与初始化

面向角色： 实施顾问、系统管理员、运维工程师
目标： 完成可登录、可对话、可调用业务能力、可审计的最小生产闭环

企业管理智能体支持与 RuoYi Office 一体化部署，也支持独立部署后连接客户已有业务系统。

部署组成

• AgentOS 前端应用
• AgentOS 后端服务
• AgentOS 独立数据库
• 通用大模型与 OCR、语音等专用模型服务
• 文件存储、缓存及可选知识检索组件
• RuoYi Office 或第三方业务系统连接器

初始化顺序

1. 部署前后端及独立数据库。
2. 配置统一登录、租户和组织身份映射。
3. 配置通用大模型、OCR 和语音模型。
4. 创建业务系统连接器并同步能力。
5. 配置智能体、技能及角色授权。
6. 使用普通员工和管理员账号分别验收。

上线前准备

检查项	要求
域名与 HTTPS	前端、后端、文件服务和回调地址均使用可信域名
独立数据库	AgentOS 表不进入主线客户必跑升级脚本
身份映射	用户能够准确映射租户、公司、部门和员工档案
模型密钥	使用环境变量或加密配置，不写入代码和日志
文件域名	仅允许受信文件服务域名，禁止任意外部 URL 抓取
业务权限	能力授权与业务系统权限同时生效
审计留痕	写操作、确认、失败和重试均可追溯

部署模式

模式	适用场景
与 RuoYi Office 集成	共享身份、组织、权限和业务能力，开箱体验最完整
独立部署	客户已有金蝶、用友或自研业务系统，通过连接器接入
混合连接	同时连接 RuoYi Office 与多个外围系统，统一智能入口

推荐验收顺序

1. 管理员登录并检查组织、公司和部门信息。
2. 配置一个对话模型，完成健康检查和试聊。
3. 配置一个只读业务能力，例如“查询本人待办”。
4. 配置一个需要确认的写能力，例如“生成工作汇报草稿”。
5. 分别使用管理员和普通员工验证数据范围。
6. 模拟模型失败、接口超时和重复确认，检查容错与幂等。
7. 完成备份、监控、日志脱敏和回滚演练。

升级原则

• 前端、后端和 AgentOS 独立 SQL 使用同一发布版本。
• 数据库变更只执行对应扩展服务的增量脚本。
• 先在预发布环境验证模型、连接器和关键场景，再升级生产。
• 升级后重点验证 SSO、对话、附件、确认卡、详情跳转和审计记录。

详细步骤请参阅部署与初始化配置手册。