# AiAgentFront

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

## Basic Information

- **Project Name**: AiAgentFront
- **Description**: asdasgffjghjghjkjk
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: ts
- **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 平台前端

本仓库基于 plus-ui 5.6.2-2.6.2 改造，用作企业级智能运营 Agent 平台的管理端。V1 强面试版围绕 Agent 管理、工作流配置、模型/Prompt 管理、库存调拨、BI 问答、知识库、人工审核和任务日志完成可演示闭环。

## 项目定位

前端不是单纯后台表格集合，而是 Agent 平台的业务工作台：

- 平台管理员配置模型、Prompt、Agent 和工作流。
- 业务运营人员发起库存调拨分析并处理审核。
- 数据分析人员维护知识库并提交 BI 自然语言问题。
- 研发/运维人员通过任务日志和模型调用日志复盘执行链路。

## 技术栈

- Vue 3
- TypeScript
- Vite
- Element Plus
- ECharts
- PNPM
- plus-ui / RuoYi-Vue-Plus 前端基础能力

## 本地启动

前置条件：

- Node.js >= 20.19.0
- PNPM
- 后端服务运行在 `http://localhost:8080`

安装依赖：

```powershell
cd D:\AllTools\workspace\AiAgentFront
pnpm install
```

启动开发服务：

```powershell
pnpm dev
```

当前 `.env.development`：

```text
VITE_APP_PORT = 80
VITE_APP_BASE_API = '/dev-api'
```

Vite 代理会把 `/dev-api` 转发到 `http://localhost:8080`。如果 80 端口被占用，先记录占用原因，再调整 `VITE_APP_PORT` 或使用可用端口。

## 常用命令

```powershell
pnpm build:dev
pnpm build:prod
pnpm lint:eslint
pnpm exec eslint <files>
```

不要在本仓库混用 `npm install`、`yarn` 或生成 `package-lock.json`。

## Agent 页面

| 页面 | 路径/目录 | 用途 |
| --- | --- | --- |
| Agent 管理 | `src/views/agent/definition` | Agent 定义、类型、工作流绑定 |
| 工作流管理 | `src/views/agent/workflow` | 工作流、节点、边、流程预览 |
| 模型配置 | `src/views/agent/model` | 模型配置、连接测试、模型调用日志 |
| Prompt 模板 | `src/views/agent/prompt` | Prompt 模板维护 |
| 知识库 | `src/views/agent/knowledge` | 文本文档入库、切片、检索 |
| 库存调拨 | `src/views/agent/inventory` | 发起分析、查看建议和风险 |
| BI 问答 | `src/views/agent/bi` | 自然语言问题、SQL、图表、反馈 |
| 人工审核 | `src/views/agent/review` | 审核待办、通过/驳回 |
| 任务日志 | `src/views/agent/run` | 任务统计、运行列表、节点时间线 |

接口封装位于 `src/api/agent`，与后端 `/agent/...` 接口对应。

## 文档索引

- `docs/local-startup.md`：前端本地启动、端口、代理和验证。
- `docs/page-map.md`：页面地图、演示顺序和接口对应关系。

## 验收建议

1. 后端 `8080` 已启动。
2. 前端 `pnpm build:dev` 通过。
3. 前端页面可访问。
4. 通过前端代理访问 `/dev-api/agent/runs/overview`，未登录时返回业务 JSON `401`。
5. 登录后按 `docs/page-map.md` 的演示顺序走库存调拨和 BI 问答主链路。