# AiAgent

**Repository Path**: mason-rain/AiAgent

## Basic Information

- **Project Name**: AiAgent
- **Description**: asdasdasdasdas
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: 5.X
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-22
- **Last Updated**: 2026-06-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 企业级智能运营 Agent 平台后端

本仓库基于 RuoYi-Vue-Plus 5.6.2 改造，用作“企业级智能运营 Agent 平台”的后端底座。V1 强面试版已经围绕一个统一 Agent 工作流底座和两个业务 Agent 场景完成主链路：智能库存调拨 Agent、智能 BI 报表问答 Agent。

## 项目定位

这个项目不是单点 AI 问答 Demo，而是一个带工作流编排、任务追踪、人工审核、模型配置、Prompt 管理、RAG 检索、SQL 安全校验、Redis 幂等和 Kafka 中间件补验的企业级 Agent 平台。

核心目标：

- 管理多个业务 Agent，并把 Agent 绑定到可配置工作流。
- 通过节点、边、条件分支和人工审核控制 AI 决策链路。
- 让库存调拨和 BI 问答都能形成“请求 -> 执行 -> 留痕 -> 审核/反馈 -> 查询”的真实闭环。
- 保留 RuoYi-Vue-Plus 的用户、角色、菜单、权限、日志、字典等后台基础能力。

## 后端模块

| 模块 | 说明 |
| --- | --- |
| `ruoyi-admin` | 后端启动入口，默认端口 `8080` |
| `ruoyi-system` | RuoYi 系统管理、用户、角色、菜单、权限 |
| `ruoyi-agent-model` | 模型配置、Prompt 模板、模型调用日志 |
| `ruoyi-agent-core` | Agent 定义、工作流定义、节点、边、运行实例、人工审核、任务中心 |
| `ruoyi-agent-inventory` | 库存商品、仓库、库存快照、销量、调拨建议、风险评估 |
| `ruoyi-agent-bi` | BI 自然语言问答、知识库、文本切片、检索、SQL 安全校验、反馈 |

## 本地快速启动

前置环境：

- JDK 17
- Maven 3.9+
- MySQL 8
- Redis
- Kafka 作为 V1 中间件补验项

启动前请先按 `docs/database-init.md` 初始化数据库。配置文件当前指向 `ry-vue`，实际凭据以本机安全配置为准，不要把真实凭据写入文档或提交。

```powershell
cd D:\AllTools\workspace\AiAgent
mvn -pl ruoyi-admin -am spring-boot:run
```

看到日志中出现 `Started DromaraApplication` 和 `RuoYi-Vue-Plus启动成功`，即可判定主服务启动成功。SnailJob Server 或 Spring Boot Admin 未启动时产生连接告警，若当前验收不依赖调度中心或监控中心，可按非阻塞警告处理。

## SQL 初始化顺序

推荐顺序：

```text
script/sql/ry_vue_5.X.sql
script/sql/ry_job.sql
script/sql/ry_workflow.sql
script/sql/agent_model.sql
script/sql/agent_core.sql
script/sql/agent_inventory.sql
script/sql/agent_bi.sql
```

详细说明和核验 SQL 见 `docs/database-init.md`。

## 常用验证命令

后端目标测试：

```powershell
mvn -pl ruoyi-modules/ruoyi-agent-core,ruoyi-modules/ruoyi-agent-model,ruoyi-modules/ruoyi-agent-inventory,ruoyi-modules/ruoyi-agent-bi -am '-DskipTests=false' '-Dsurefire.failIfNoSpecifiedTests=false' test
```

后端入口打包：

```powershell
mvn -pl ruoyi-admin -am -DskipTests package
```

后端接口未登录验证示例：

```powershell
Invoke-WebRequest -UseBasicParsing http://localhost:8080/agent/runs/overview
```

未登录时返回业务 JSON `401`，说明接口路由、权限拦截和 Web 服务链路都已命中。

## 文档索引

- `docs/local-startup.md`：本地后端启动和中间件检查。
- `docs/database-init.md`：数据库初始化顺序和只读核验。
- `docs/api-reference.md`：当前真实 Agent API 路径、权限和用途。
- `docs/docker-compose-guide.md`：V1 Docker Compose 参考与本地中间件关系。
- `docs/demo-script.md`：10-15 分钟演示脚本。
- `docs/interview-guide.md`：面试讲解稿和高频问答。
- `docs/resume-project-description.md`：简历项目描述。
- `script/docker/docker-compose.agent-v1.yml`：V1 核心依赖参考 Compose。

## V1 已覆盖链路

- Agent 定义、工作流定义、节点、边、流程预览。
- 工作流运行、节点执行日志、失败重试、异步发起 fallback、任务中心统计。
- 人工审核暂停和恢复。
- 模型配置、Prompt 模板、模型连通性测试留痕、模型调用日志。
- 库存调拨 Agent：库存/销量数据加载、建议生成、风险评估、建议保存、审核入口。
- BI 问答 Agent：知识库文本入库、切片检索、自然语言问题、SQL 安全校验、结果解释、反馈。
- Redis 幂等和缓存验证。
- Kafka 本机 broker 安装和 topic 生产/消费补验。

## 重要边界

- V1 以本地稳定演示和面试讲解为目标，不承诺生产级 K8s、完整监控告警、压测报告或多租户计费。
- 当前 Kafka 已完成本机中间件补验；工作流异步业务链路仍使用 Spring Async fallback，后续可替换为 Kafka producer/consumer 适配。
- 文档和日志中不要写入真实 API Key、令牌、密码或私有仓库凭据。