快速开始

环境要求

后端环境

组件	版本要求
JDK	21
Maven	3.9+
MySQL	5.7/8.0
Redis	8.8

本地可以用Docker Desktop安装和启动MySQL8.0和Redis8.8

前端环境

组件	版本要求
Node.js	22+

数据库初始化

1. 创建两个数据库：

mysql 5.7

CREATE DATABASE `agent-plus` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE DATABASE `agent-plus-sys` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

mysql 8.0

CREATE DATABASE `agent-plus` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_zh_cn_0900_ai_ci;
CREATE DATABASE `agent-plus-sys` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_zh_cn_0900_ai_ci;

2. 按顺序执行 SQL 脚本：
   • agent-plus.sql → 业务表
   • agent-plus-sys.sql → 系统表
   • id_generator.sql → ID 生成相关表

SQL 脚本位置：agent-plus/docs/sql/

后端启动

1. 配置文件

修改agent-plus-web/src/main/resources/application.yml 或者 复制 application-dev-template.yml 为 application-dev.yml，修改以下配置：

spring:
  datasource:
    dynamic:
      datasource:
        biz:
          url: jdbc:mysql://127.0.0.1:3306/agent-plus?zeroDateTimeBehavior=convertToNull&useUnicode=true&useSSL=false&characterEncoding=utf8&serverTimezone=GMT%2B8
          username: root
          password: 你的密码
        sys:
          url: jdbc:mysql://127.0.0.1:3306/agent-plus-sys?zeroDateTimeBehavior=convertToNull&useUnicode=true&useSSL=false&characterEncoding=utf8&serverTimezone=GMT%2B8
          username: root
          password: 你的密码
          
  # 缓存 + Redis向量库使用
  data:
    redis:
      host: 127.0.0.1
      port: 6379
      password: 你的密码（如无则留空）

# 阿里云OSS 必要配置 知识库文件上传、资源库图标需要使用  
storage:
  oss:
    accessKeyId:
    accessKeySecret:
    endPoint:
    regionId:
    roleArn:
    bucket:
    domain: https://xxxxxx.aliyuncs.com

2. 启动

检查一下 Maven版本 和 Jdk版本

IDEA运行项目

运行入口：

agent-plus-web/src/main/java/com/iusofts/agentplus/web/Application.java

后端服务默认启动在 http://localhost:8080

Swagger 文档地址：http://localhost:8080/swagger-ui.html

前端启动

1. 安装依赖

cd agent-plus-admin-front
npm install

2. 启动开发服务器

npm run dev

前端服务默认启动在 http://localhost:80

登录系统

• 地址：http://localhost
• 用户名：admin
• 密码：admin

优先配置模型

登录后，进入 资源库 → 模型管理，点击「新增」添加模型：

下一步

• 配置模型
• 配置知识库
• 创建工作流