2026-05-20 00:11:37 +08:00
2026-05-18 19:50:25 +08:00
2026-05-20 00:11:37 +08:00
2026-05-18 23:42:38 +08:00
2026-05-18 19:50:25 +08:00
2026-05-20 00:11:37 +08:00
2026-05-18 19:50:25 +08:00
2026-05-18 19:50:25 +08:00

Common Agent

Common Agent 是一个规划中的通用 Agent 平台,技术路线基于 Java、Spring Boot 和 Spring AI。 项目目标是建设一套完整的前后端系统,支持 Agent 编排、工具调用、会话管理、RAG 知识库和平台管理能力。

当前项目处于基础工程阶段。后端骨架、PostgreSQL 配置、MyBatis-Plus、Lombok 和多环境配置文件已经完成; Agent 运行时、RAG 索引、前端页面和管理功能会在后续阶段逐步实现。

项目愿景

Common Agent 希望成为一个可复用的企业级 AI 应用基础平台:

  • Agent 运行时:支持对话、工具调用、记忆、任务执行和流程编排。
  • RAG 知识库:支持文档导入、解析、切片、向量化、检索和基于上下文的回答生成。
  • 模型抽象:通过 Spring AI 统一接入聊天模型、Embedding 模型和重排序模型。
  • 管理控制台提供会话、Agent、知识库、文档、提示词和系统配置的 Web 管理界面。
  • 多环境部署:支持本地开发、测试环境和生产环境的配置隔离。

当前技术栈

  • Java 21
  • Spring Boot 4.0.6
  • Spring AI规划接入
  • MyBatis-Plus 3.5.16
  • PostgreSQL JDBC Driver
  • Lombok
  • Maven Wrapper
  • PostgreSQL 数据库:common_agent

项目结构

common_agent
├── src/main/java/com/bruce
│   └── CommonAgentApplication.java
├── src/main/resources
│   ├── application.yaml
│   ├── application-dev.yaml
│   └── application-template.yaml
├── docs
│   ├── ARCHITECTURE.md
│   └── ROADMAP.md
├── pom.xml
└── README.md

配置说明

主配置文件只负责选择当前环境:

spring:
  application:
    name: common_agent
  profiles:
    active: dev

本地开发环境配置位于 src/main/resources/application-dev.yaml。 当前开发环境数据库指向 PostgreSQL

spring:
  datasource:
    driver-class-name: org.postgresql.Driver
    url: jdbc:postgresql://110.42.106.130:5431/common_agent?currentSchema=common_agent
    username: common_agent
    password: common_agent

src/main/resources/application-template.yaml 是配置模板,可用于复制生成 application-test.yamlapplication-prod.yaml 等其他环境配置文件。

运行方式

运行测试:

.\mvnw.cmd test

启动应用:

.\mvnw.cmd spring-boot:run

当前阶段还没有加入 Web 服务依赖或常驻任务,所以应用可能启动成功后立即退出。

规划模块

  • agent-coreAgent 执行模型、工具注册、记忆和编排能力。
  • rag-core文档导入、切片、Embedding、检索和引用元数据。
  • model-provider:基于 Spring AI 的聊天模型、Embedding、重排序和模型配置层。
  • platform-api:面向前端和外部系统的 REST API。
  • platform-admin:平台管理前端。
  • common-infra:持久化、审计日志、安全、租户隔离和可观测性。

文档

参考资料

Description
No description provided
Readme 1.1 MiB
Languages
Java 71.9%
Vue 15.8%
TypeScript 10.4%
CSS 1.9%