quce-ai-agent — AI 智能体工作台

基于 DDD 架构的 AI 智能体（Agent）应用平台，提供 Auto Agent 自动对话、Flow Agent 流程执行、Fixed Agent 固定问答与 Armory 动态装配能力，支持 SSE 流式响应、MCP 工具接入、RAG 知识库问答与后台管理。

特性

• Auto Agent 自动对话：将一次请求拆解为「需求分析 → 精准执行 → 质量监督 → 总结输出」多阶段执行，通过 SSE 流式实时返回思考过程与结果
• Flow Agent 流程执行：按「MCP 工具分析 → 规划 → 解析步骤 → 执行」编排多步骤任务
• Armory 动态装配：启动/运行时按配置动态装配对话客户端（模型、MCP 工具、Advisor 顾问、系统提示词），通过「策略路由 + 责任链」节点式加载
• MCP 工具接入：基于 Spring AI 的 MCP Client，支持 stdio / SSE 传输的 MCP Server
• RAG 知识库问答：PGVector 向量存储 + Tika 文档解析，支持知识库绑定问答
• SSE 流式响应：全部对话接口以 Server-Sent Events 流式输出
• 后台管理：AI 客户端、模型、API、MCP、Advisor、系统提示词、知识库订单、绘图配置、数据统计等完整管理接口
• 自研责任链框架：策略路由 + 多线程预加载的责任链模板（com.quce.ai.design.framework.tree），不依赖外部框架
• 运维可观测：Docker 编排、ELK 日志、Grafana/Prometheus 监控脚本

技术栈

分类	技术
语言/构建	Java 17、Maven、Spring Boot 3.4.3
AI 框架	Spring AI 1.0.0（ChatClient、OpenAI 兼容模型、MCP Client、PGVector、Tika）
持久化	MyBatis、MySQL 8、PostgreSQL（PGVector）
通信	SSE（Server-Sent Events）、Spring MVC
架构	DDD 分层 + 策略路由/责任链（自研）
部署	Docker、docker-compose、Nginx（前端静态页）

模块结构（DDD）

模块	职责
quce-ai-agent-api	对外服务接口与 DTO
quce-ai-agent-app	应用启动层：配置、装配、自动装配监听
quce-ai-agent-domain	领域层：Agent 装配、执行策略（auto/flow/fixed）、RAG、任务、责任链框架
quce-ai-agent-trigger	触发器层：HTTP 接口（对话/后台管理）
quce-ai-agent-infrastructure	基础设施层：DAO 持久化、仓储实现
quce-ai-agent-types	通用类型层：枚举、常量、任务调度框架

trigger → domain ← infrastructure
    ↓         ↑
   app ←─────┘
    ↓
   api
    ↓
  types

快速开始

环境要求

• JDK 17+、Maven 3.8+
• MySQL 8.0+、PostgreSQL（含 pgvector 插件，RAG 场景）
• 可选：Redis、Elasticsearch/Logstash/Kibana、Grafana/Prometheus（监控场景）

启动步骤

1. 导入数据库脚本：docs/dev-ops/mysql/sql/ 下 SQL 文件（按版本顺序执行）
2. 配置模型 API Key：修改 quce-ai-agent-app/src/main/resources/application-dev.yml 中 spring.ai.openai.api-key（OpenAI 兼容接口，支持通义/DeepSeek 等）
3. 调整 application-dev.yml 中 MySQL / PGVector 连接信息
4. 启动应用：

mvn -DskipTests=true package
java -jar quce-ai-agent-app/target/quce-ai-agent-app.jar

默认端口：8099（dev）/ 8091（test）

5. 访问前端演示页（docs/dev-ops/nginx/html）：

cd docs/dev-ops/nginx/html && python3 -m http.server 8080
# 打开 http://localhost:8080/index.html

API 概览

对话接口（/api/v1/agent）

接口	方法	说明
/api/v1/agent/auto_agent	POST	Auto Agent 自动对话（SSE 流式，参数：aiAgentId/message/sessionId/maxStep）
/api/v1/agent/armory_agent	POST	Armory 装配后对话（SSE 流式）
/api/v1/agent/query_available_agents	GET	查询可用 Agent 列表

后台管理（/api/v1/admin）

资源	说明
/api/v1/admin/ai-client	AI 客户端配置
/api/v1/admin/ai-client-model	模型配置
/api/v1/admin/ai-client-api	API 渠道配置
/api/v1/admin/ai-client-mcp	MCP 工具配置
/api/v1/admin/ai-client-advisor	Advisor 顾问配置
/api/v1/admin/ai-client-system-prompt	系统提示词配置
/api/v1/admin/ai-client-rag-order	RAG 知识库订单（含文件上传）
/api/v1/admin/ai-agent-draw	Agent 绘图配置
/api/v1/admin/data/statistics	数据统计
/api/v1/admin/admin-user	后台用户（登录/校验）

详细请求/响应示例见 docs/api-docs/后台管理API文档.md

核心设计

策略路由 + 责任链（自研）

com.quce.ai.design.framework.tree 提供三件套：

• StrategyHandler<T, D, R>：责任链节点接口，DEFAULT 兜底处理器
• AbstractStrategyRouter<T, D, R>：路由骨架，get() 决定下一个节点，router() 驱动链路
• AbstractMultiThreadStrategyRouter<T, D, R>：多线程预加载（multiThread）+ 业务执行（doApply）两段式节点

典型链路（Armory 装配）：RootNode（数据加载）→ AiClientApiNode → AiClientModelNode → AiClientNode → AiClientAdvisorNode → AiClientToolMcpNode

Auto Agent 多阶段执行

AutoAgentExecuteStrategy 下按责任链串联：需求分析 → 精准执行 → 质量监督 → 日志总结，每阶段通过 SSE 推送结构化事件（analysis/execution/supervision/summary）。

Docker 部署

docs/dev-ops/ 提供完整编排：

• docker-compose-environment.yml：MySQL / Redis / PostgreSQL / Nginx 等基础环境
• docker-compose-app.yml：应用 + MCP Server 服务
• docker-compose-elk.yml / docker-compose-grafana.yml：日志与监控

License

Apache License 2.0