RuoYi Office 文档

Appearance

AG01 本地服务启动 v3 ​

← 返回本课教程 · 系列目录

1. 开始前的准备 ​

开始操作前，先看一下整体安装规划。我们准备配套平台和 AgentOS 源码，JDK 十七、Maven、Node 和 pnpm，以及本机的 MySQL 八和 Redis。后端由 IDEA 运行，前端用 Cursor 或 VS Code。智能体后端使用默认四八零九一端口，前端使用默认五六六六端口；如果被旧实例占用，先停止旧实例。

操作画面

2. 安装顺序与本课目标 ​

整个过程按这个顺序进行：先准备本机配置和独立空库，导入基线、客户种子和版本脚本；再在 IDEA 加载智能体模块，核对运行配置，启动 Application；最后导入前端目录，安装依赖并启动，打开本地页面。本课先完成服务启动，模型配置和一体化平台连接放到下一篇。

操作画面

3. 导入独立数据库 ​

先打开数据库客户端，连接本机三三零六端口，选择新建的 ruoyi office agentos 空库。打开安装目录中的一点零基线脚本。执行前，看一眼顶部连接名和当前库，确认是智能体的独立库。接着选择执行 SQL 脚本，让整个文件按顺序运行。

操作画面

4. 完成初始化与版本升级 ​

执行结束后检查结果，没有错误再继续。首次安装还要依次执行生成目录里的客户种子和安装记录脚本，本次已完成。当前版本另外带了两份一点一升级脚本，我们也在同一个智能体库中执行。这里看到执行统计已经结束。基础表和当前版本字段就准备好了。

操作画面

5. IDEA 打开 Maven 工程 ​

接下来在 IDEA 打开配套平台后端根目录的 pom 文件，作为 Maven 项目导入。本次已经导入，直接复用现有窗口。也可以单独作为 IDEA 项目打开，或者纳入 ruoyi office 工程作为模块启动，两种方式都要保留兼容的平台框架源码。看左侧，我们接下来始终操作 yudao server agentos 这个智能体模块。

操作画面

6. 加载 addons 模块 ​

Maven 选择 addons → 重新加载。确认 yudao-server-agentos、yudao-module-agentos 被识别。

操作画面

7. 核对中间件配置 ​

文件：yudao-server-agentos/src/main/resources/application-prod.yaml。先在 deploy/agentos.env 填写本机中间件，再在 AgentOS 根目录执行配套 prepare 命令。

操作画面

8. 检查 Application 运行配置 ​

Application；JDK 17；模块 yudao-server-agentos；主类 cn.iocoder.yudao.server.YudaoAgentosServerApplication；参数 --spring.profiles.active=prod；工作目录 AgentOS 仓库根目录；@argfile。

操作画面

9. 运行后端 Application ​

现在点击运行。IDEA 会先编译，再启动 Application。首次编译可能需要下载依赖，这里把等待稍微压缩一下。看到控制台开始输出启动日志后，继续等到启动完成。

操作画面

10. 检查默认端口启动成功 ​

这里已经显示项目启动成功，Tomcat 监听四八零九一。后端健康接口也返回了 UP。到这里，本地后端已经运行，先保持 IDEA 中的进程开着。

操作画面

11. 打开智能体前端 ​

文件 → 打开文件夹 → AgentOS/apps-web-agentos。资源管理器展开 src，并查看 package.json 中 dev: vite。

操作画面

12. 安装并检查前端依赖 ​

终端 → 新建终端。确认当前路径为 apps-web-agentos，执行 pnpm install，成功结束后继续。

操作画面

13. 核对前端默认地址 ​

启动前核对前端配置。资源管理器里打开 .env.development.local，智能体接口指向本机四八零九一，开发端口是五六六六。这里保留默认端口。平台地址先保留现有配置，具体连接放到下一课完成。

操作画面

14. 终端执行 pnpm dev ​

在同一个终端执行 pnpm dev。确认 Vite ready 与 http://localhost:5666/。保持终端运行。

操作画面

15. 打开本地页面 ​

浏览器打开 http://localhost:5666/login。检查页面可达。平台 48080 尚未启动时，租户接口请求会连接失败，AG02 继续平台对接；本课没有验收平台登录或模型调用。

操作画面

AG01 v3 安装规划与操作顺序 ​

顺序：准备配置与独立库 → 导入 SQL → IDEA 加载 AgentOS 模块 → 配置并运行 Application → Cursor 导入前端目录 → pnpm install → pnpm dev → 打开本地页面。

AG01 首次准备 ​

配套平台后端、平台前端、AgentOS 源码；JDK 17、Maven 3.9+、Node.js 22.12+、pnpm、MySQL 8、Redis。教程代码核对版本：cd6b332。

1. 本机中间件 ​

新建独立空库 ruoyi_office_agentos，并为独立账号分配该库权限。本次 MySQL 为 127.0.0.1:3306，Redis 为 127.0.0.1:6379 / database 5。按自己的环境填写数据库口令。

2. 生成本机运行配置 ​

在 AgentOS 根目录，首次运行：

powershell
node tools/setup.mjs init --mode local

已有 deploy/agentos.env 就直接编辑，不重复 init。填写同名中间件字段：MYSQL_URL、MYSQL_USERNAME、MYSQL_PASSWORD、REDIS_HOST、REDIS_PORT、REDIS_DATABASE、REDIS_PASSWORD。数据库 URL 示例：

text
jdbc:mysql://127.0.0.1:3306/ruoyi_office_agentos?useSSL=false&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true

然后运行（非标准目录调整 platform 路径）：

powershell
node tools/setup.mjs prepare --mode local --platform ../../ruoyi-office

prepare 生成运行配置并装配后端模块，不会执行数据库 SQL。模型与平台连接的填写和验收留到 AG02，保留现有配置。prod 是本课加载统一参数的配置名，实际连接地址取自本机填写的值。

3. 新库初始化顺序 ​

在数据库客户端选择同一独立空库，逐份执行，任一步失败就停止：

  1. sql/install/agentos/V1.0.0__agentos_baseline.sql
  2. sql/generated/02_customer_seed.sql
  3. sql/generated/03_record.sql
  4. sql/upgrade/v1.1.0/V1.1.0__knowledge_governance.sql
  5. sql/upgrade/v1.1.0/V1.1.0__agent_knowledge_binding.sql

基础脚本建成 28 张表；本次另验证了当前版本升级字段。基础安装前三步只用于新空库；已有环境按版本升级文档执行。sql/generated/04_mainline.sql 属于下一课的平台对接，不在本课执行。

4. 前端 ​

Cursor / VS Code 打开 apps-web-agentos。在该目录安装依赖：

powershell
pnpm install

本次复用既有依赖，实际输出 Already up to date，成功退出；首次下载等待正常完成。在 Cursor / VS Code 的“终端 → 新建终端”中确认当前目录为 apps-web-agentos。依赖安装完成、重新出现提示符后，在同一终端执行 pnpm dev，等待 Vite ready 与 http://localhost:5666/。保持终端运行。

默认前端 http://localhost:5666/，后端 http://127.0.0.1:48091。占用时先核对并停止旧实例，然后重试，不增加本课端口覆盖。

本课只验收服务启动与页面可达；平台后端尚未运行时，登录页请求 /admin-api/system/tenant/* 可能提示 48080 连接失败。这与 AgentOS 后端 48091 的健康检查是两件事，AG02 完成平台启动、地址配置和登录对接。