# java-agent

**Repository Path**: bigan/java-agent

## Basic Information

- **Project Name**: java-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-02-12
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java Agent 项目

基于 Spring Boot 3.2 + Spring AI + Qwen 的 AI Agent 开发框架

## 🎯 项目简介

这是一个完整的 Java Agent 开发学习项目，按照15天学习计划设计，涵盖了：
- Spring AI 基础应用
- Qwen 模型集成
- Function Calling 工具调用
- RAG 检索增强生成
- 多智能体协作
- 工程化实践

## 🚀 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Redis (可选)
- Milvus (可选)

### 配置步骤

1. **克隆项目**
```bash
git clone <repository-url>
cd java-agent
```

2. **配置环境变量**
```bash
cp .env.example .env
# 编辑 .env 文件，填入你的 API 密钥
```

3. **编译项目**
```bash
mvn clean compile
```

4. **启动应用**
```bash
mvn spring-boot:run
```

5. **验证启动**
访问：http://localhost:8080

## 📁 项目结构

```
java-agent/
├── src/
│   ├── main/
│   │   ├── java/com/example/javaagent/
│   │   │   ├── JavaAgentApplication.java      # 主启动类
│   │   │   └── controller/
│   │   │       └── HealthController.java      # 健康检查控制器
│   │   └── resources/
│   │       └── application.properties          # 配置文件
├── pom.xml                                     # Maven 配置
├── .env.example                               # 环境变量模板
└── plan.md                                    # 15天学习计划
```

## 🔧 核心技术栈

- **框架**: Spring Boot 3.2
- **AI框架**: Spring AI 1.0.0-M3
- **大模型**: Qwen (通义千问) via Spring AI Alibaba
- **向量存储**: Milvus
- **缓存**: Redis
- **工具链**: Lombok, MapStruct

## 📚 学习路径

按照 [plan.md](roadmap.md) 文件中的15天计划逐步学习：

1. **Days 1-2**: AI Agent 基础 + Spring AI 快速上手
2. **Days 3-4**: 深入 Function Calling 与 Tool 集成  
3. **Days 5-6**: RAG（检索增强生成）实战
4. **Days 7-8**: Spring AI Alibaba 深度集成
5. **Days 9-10**: 多智能体（Multi-Agent）协作
6. **Days 11-12**: 工程化与可观测性
7. **Days 13-14**: 部署与云原生
8. **Day 15**: 项目整合 + 求职准备

## 🛠️ 开发工具推荐

- IntelliJ IDEA (推荐)
- VS Code with Java extensions
- Postman (API测试)
- Docker Desktop (容器化部署)

## 📞 支持与反馈

如有问题，请提交 Issue 或联系项目维护者。

---
**注意**: 请确保在生产环境中妥善保管 API 密钥，不要提交到版本控制系统中。