# ai-agent

**Repository Path**: xiaoshiStudy/ai-agent

## Basic Information

- **Project Name**: ai-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-26
- **Last Updated**: 2026-04-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ai-agent

基于 `Spring Boot + DDD + Spring AI/Google ADK` 的多模块 AI Agent 脚手架，支持通过配置文件装配单智能体、串行智能体和并行智能体工作流。

## 项目结构

```text
ai-agent
├─ ai-agent-app              # 启动模块（Spring Boot Application）
├─ ai-agent-trigger          # 触发层（HTTP/任务/事件监听，占位为主）
├─ ai-agent-domain           # 领域层（Agent 装配、工作流执行、MCP/Plugin 能力）
├─ ai-agent-infrastructure   # 基础设施层（仓储/网关/DAO/Redis 占位）
├─ ai-agent-api              # API 定义与通用响应对象
├─ ai-agent-types            # 通用常量、枚举、异常
└─ docs/dev-ops              # Docker 与部署相关脚本
```

## 技术栈

- Java 17
- Spring Boot 3.4.3
- Spring AI 1.1.0-M3
- Google ADK 0.4.0
- LangChain4j 1.4.0
- Maven 多模块工程

## 快速开始

### 1. 环境准备

- JDK 17
- Maven 3.8+
- Docker（可选，用于本地中间件）

### 2. 拉取并构建

```bash
mvn clean install -DskipTests
```

### 3. 配置 Agent

默认启用 `dev` 环境，`ai-agent-app/src/main/resources/application-dev.yml` 中通过 `spring.config.import` 引入 Agent 配置，例如：

```yaml
spring:
  config:
    import:
      - classpath:agent/only-one-agent.yml
```

可选配置文件：

- `agent/only-one-agent.yml`：单智能体
- `agent/test-agent.yml`：串行智能体流程示例
- `agent/parallel_research_app.yml`：并行研究 + 汇总流程示例

### 4. 启动应用

方式一（推荐开发期）：

```bash
mvn -pl ai-agent-app spring-boot:run -Dspring-boot.run.profiles=dev
```

方式二（先打包后运行）：

```bash
mvn clean package -DskipTests
java -jar ai-agent-app/target/ai-agent-app.jar --spring.profiles.active=dev
```

默认端口：`8091`

## 运行与验证

当前仓库以 Agent 装配与流程编排为主，`trigger/http` 目录暂为占位结构。建议优先通过测试类验证能力：

- `AiAgentAutoConfigTest`：验证配置自动装配后的 Agent 运行
- `SequentialAgentTest`：串行 Agent 流程（写代码 -> 评审 -> 重构）
- `ParallelAgentTest`：并行 Agent 研究流程

## Docker 相关

- 环境容器：`docs/dev-ops/docker-compose-environment.yml`
- 应用容器：`docs/dev-ops/docker-compose-app.yml`

常用命令：

```bash
docker-compose -f docs/dev-ops/docker-compose-environment.yml up -d
docker-compose -f docs/dev-ops/docker-compose-app.yml up -d
```

## 注意事项

- `agent/*.yml` 中包含模型服务地址与密钥配置，建议改为环境变量注入，不要提交真实密钥。
- 若需要数据库/MyBatis，可按 `application-*.yml` 中注释模板开启相关配置。

## 参考资料

- docker 使用文档：[https://bugstack.cn/md/road-map/docker.html](https://bugstack.cn/md/road-map/docker.html)
- DDD 教程：
  - [DDD 概念理论](https://bugstack.cn/md/road-map/ddd-guide-01.html)
  - [DDD 建模方法](https://bugstack.cn/md/road-map/ddd-guide-02.html)
  - [DDD 工程模型](https://bugstack.cn/md/road-map/ddd-guide-03.html)
  - [DDD 架构设计](https://bugstack.cn/md/road-map/ddd.html)
  - [DDD 建模案例](https://bugstack.cn/md/road-map/ddd-model.html)