105 lines
4.7 KiB
Markdown
105 lines
4.7 KiB
Markdown
# 指摘管理系统（IMS）技术构成简要说明
|
||
|
||
> **版本**：V4.1 | **日期**：2026-07-20
|
||
>
|
||
> AI驱动的指摘（缺陷/问题）全生命周期管理系统，以 Agent（智能体）为核心，实现"人机协同"的自动化管理。
|
||
|
||
---
|
||
|
||
## 一、整体架构
|
||
|
||
```
|
||
┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐
|
||
│ 前端层 │────▶│ 后端业务层 │────▶│ Agent决策编排层 │
|
||
│ React SPA │ │ Spring Boot │ │ ReAct循环 + 工具调用 │
|
||
└─────────────┘ └─────────────┘ └─────────────────────────┘
|
||
│
|
||
┌───────────────────────────┼───────────────────┐
|
||
▼ ▼ ▼
|
||
┌──────────┐ ┌────────────┐ ┌────────────┐
|
||
│本地数据层 │ │ 本地向量库 │ │ 外接AI算力 │
|
||
│PostgreSQL│ │ pgvector │ │ DeepSeek │
|
||
│+ Redis │ │ (1536维) │ │ API │
|
||
└──────────┘ └────────────┘ └────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 二、核心技术栈
|
||
|
||
| 层级 | 技术选型 | 作用 |
|
||
|:---|:---|:---|
|
||
| **前端** | React 19 + TypeScript + Vite + Ant Design 6 | 单页应用，工作台/指摘管理/Agent驾驶舱 |
|
||
| **后端** | Java 17/21 + Spring Boot 3.5 + Spring Security | RESTful API、RBAC权限、数据访问（JPA） |
|
||
| **Agent引擎** | Spring AI / 自定义ReAct框架 + DeepSeek API | 自然语言理解、任务规划、工具调用、思考链 |
|
||
| **向量检索** | PostgreSQL 16 + **pgvector** 插件 | 本地存储文档向量（1536维），余弦相似度检索 |
|
||
| **缓存/消息** | Redis 7.4 | 热点缓存、会话管理、异步通知 |
|
||
| **对象存储** | MinIO（本地部署） | 知识库文档、附件文件存储 |
|
||
| **AI算力** | DeepSeek API（deepseek-v4-pro + text-embedding-3-small） | **仅提供推理与向量化算力，不留存数据** |
|
||
|
||
---
|
||
|
||
## 三、核心创新点
|
||
|
||
### 1. Agent驱动的业务闭环
|
||
- 内置 **ReAct循环**（推理→行动→观察）
|
||
- 用户自然语言指令（如"催办逾期指摘分配给张三"）→ Agent自动规划 → 调用工具执行
|
||
- 高风险操作（删除/跨部门分配）自动触发人工审批
|
||
|
||
### 2. 本地知识库 + 外接算力
|
||
- 所有文档原文和向量索引 **存储于本地**（PostgreSQL pgvector）
|
||
- 仅将待向量化的文本片段通过API发送至DeepSeek
|
||
- **数据不出内网**，兼顾智能化与数据安全
|
||
|
||
### 3. 人机协同审批机制
|
||
- Agent执行敏感操作前自动触发 `request_human_approval`
|
||
- 详情页"Agent驾驶舱"实时展示思考链：`[思考]` → `[行动]` → `[观察]`
|
||
- 用户可实时批准/拒绝/修改建议
|
||
|
||
### 4. 长期记忆能力
|
||
- 成功的Agent处理经验自动沉淀为向量记忆（`agent_memories`表）
|
||
- 后续遇到相似问题时优先检索历史方案，持续优化决策质量
|
||
|
||
---
|
||
|
||
## 四、关键数据流示例
|
||
|
||
**用户输入**："这个4K屏幕适配问题怎么处理？"
|
||
|
||
```
|
||
Agent接收目标
|
||
│
|
||
▼
|
||
检索本地知识库（search_knowledge）
|
||
│
|
||
▼
|
||
匹配历史案例 #KB-042（Flex容器4K适配方案）
|
||
│
|
||
▼
|
||
生成行动方案 → 调用 send_reminder 给担当者
|
||
│
|
||
▼
|
||
触发人工审批闸门（request_human_approval）
|
||
│
|
||
▼
|
||
用户批准 → 发送通知并附解决方案 → 记录成功经验到记忆库
|
||
```
|
||
|
||
---
|
||
|
||
## 五、部署特点
|
||
|
||
| 特性 | 说明 |
|
||
|:---|:---|
|
||
| **全栈容器化** | Docker Compose 一键启动所有服务 |
|
||
| **数据本地化** | 知识库文档、向量索引、业务数据全部本地存储 |
|
||
| **算力外包化** | 仅DeepSeek API为外部依赖，传输内容可控、不留存 |
|
||
| **可观测性** | Prometheus + Grafana 监控Agent任务指标；ELK审计思考链日志 |
|
||
| **安全策略** | JWT认证 + RBAC权限 + 单用户Agent调用限流（10次/分钟） |
|
||
|
||
---
|
||
|
||
## 六、一句话概括
|
||
|
||
> 用 **Spring Boot + React** 构建、以 **DeepSeek AI** 为大脑、以 **本地pgvector** 为记忆、以 **Agent** 为执行中枢的智能化缺陷管理系统——让AI自动处理80%的常规指摘流转，人工只介入关键决策。
|