# spring-ai-alibaba-agentic-framework

**Repository Path**: jacklinnnn/spring-ai-alibaba-agentic-framework

## Basic Information

- **Project Name**: spring-ai-alibaba-agentic-framework
- **Description**: spring-ai-alibaba-agentic-framework
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📚 AI Agent 框架文档导航

## 欢迎使用 Spring AI Alibaba Agentic Framework

本项目提供了两个AI Agent模块的完整实现和文档。

---

## 🎯 快速导航

### 我想快速上手

**选择Qwen（推荐）**
```bash
# 1. 阅读快速开始
qwen-ai-agent/QUICKSTART.md

# 2. 启动应用
cd qwen-ai-agent
mvn spring-boot:run

# 3. 运行演示
./demo.sh  # Linux/Mac
# 或
demo.bat   # Windows
```

**选择DeepSeek**
```bash
# 1. 阅读快速开始
deepseek-ai-agent/QUICKSTART.md

# 2. 启动应用
cd deepseek-ai-agent
mvn spring-boot:run
```

---

## 📖 文档分类

### 📘 入门文档

#### Qwen AI Agent
| 文档 | 说明 | 阅读时间 |
|------|------|----------|
| [qwen-ai-agent/START_HERE.md](qwen-ai-agent/START_HERE.md) | 入门指引，首次使用必读 | 5分钟 |
| [qwen-ai-agent/QUICKSTART.md](qwen-ai-agent/QUICKSTART.md) | 5分钟快速上手 | 5分钟 |
| [QWEN_AI_AGENT_MODULE.md](QWEN_AI_AGENT_MODULE.md) | 项目说明 | 3分钟 |

#### DeepSeek AI Agent
| 文档 | 说明 | 阅读时间 |
|------|------|----------|
| [deepseek-ai-agent/QUICKSTART.md](deepseek-ai-agent/QUICKSTART.md) | 5分钟快速上手 | 5分钟 |
| [DEEPSEEK_AI_AGENT_DOCUMENTATION.md](DEEPSEEK_AI_AGENT_DOCUMENTATION.md) | 项目说明 | 3分钟 |

### 📗 完整文档

#### Qwen AI Agent
| 文档 | 说明 | 行数 |
|------|------|------|
| [qwen-ai-agent/README.md](qwen-ai-agent/README.md) | 模块完整说明 | 98行 |
| [qwen-ai-agent/EXAMPLES.md](qwen-ai-agent/EXAMPLES.md) | 详细使用示例 | 219行 |
| [qwen-ai-agent/CREATION_SUMMARY.md](qwen-ai-agent/CREATION_SUMMARY.md) | 模块创建总结 | 230行 |

#### DeepSeek AI Agent
| 文档 | 说明 | 行数 |
|------|------|------|
| [deepseek-ai-agent/README.md](deepseek-ai-agent/README.md) | 模块完整说明 | 104行 |
| [deepseek-ai-agent/EXAMPLES.md](deepseek-ai-agent/EXAMPLES.md) | 详细使用示例 | 220行 |
| [deepseek-ai-agent/CREATION_SUMMARY.md](deepseek-ai-agent/CREATION_SUMMARY.md) | 模块创建总结 | 218行 |

### 📙 对比文档

| 文档 | 说明 | 用途 |
|------|------|------|
| [qwen-ai-agent/DEEPSEEK_VS_QWEN.md](qwen-ai-agent/DEEPSEEK_VS_QWEN.md) | 详细对比两个模块 | 选择模块/迁移指南 |

### 📕 报告文档

#### Qwen AI Agent
| 文档 | 说明 |
|------|------|
| [qwen-ai-agent/DELIVERY_REPORT.md](qwen-ai-agent/DELIVERY_REPORT.md) | 交付报告，包含质量检查 |
| [qwen-ai-agent/START_HERE.md](qwen-ai-agent/START_HERE.md) | 入门指引，学习路径 |

#### DeepSeek AI Agent
| 文档 | 说明 |
|------|------|
| [deepseek-ai-agent/DOCUMENTATION_COMPLETE.md](deepseek-ai-agent/DOCUMENTATION_COMPLETE.md) | 文档完成报告 |

### 📓 总结文档

| 文档 | 说明 |
|------|------|
| [DOCUMENTATION_SUMMARY.md](DOCUMENTATION_SUMMARY.md) | 整体文档体系总结 |

---

## 🚀 学习路径推荐

### 路径1：新手快速上手（15分钟）

**推荐模块**: Qwen AI Agent

1. **第1步** (3分钟)
   - 阅读 [qwen-ai-agent/START_HERE.md](qwen-ai-agent/START_HERE.md)

2. **第2步** (5分钟)
   - 阅读 [qwen-ai-agent/QUICKSTART.md](qwen-ai-agent/QUICKSTART.md)
   - 配置API密钥

3. **第3步** (5分钟)
   - 运行 `mvn spring-boot:run`
   - 运行演示脚本 `demo.sh` 或 `demo.bat`

4. **第4步** (2分钟)
   - 测试API，查看效果

### 路径2：对比学习（30分钟）

1. **第1步** (10分钟)
   - 阅读 [qwen-ai-agent/DEEPSEEK_VS_QWEN.md](qwen-ai-agent/DEEPSEEK_VS_QWEN.md)

2. **第2步** (10分钟)
   - 分别查看两个模块的 [README.md](qwen-ai-agent/README.md)

3. **第3步** (10分钟)
   - 启动两个模块进行对比测试

### 路径3：深入理解（1小时）

1. **第1步** (15分钟)
   - 阅读 [CREATION_SUMMARY.md](qwen-ai-agent/CREATION_SUMMARY.md) (任选一个模块)

2. **第2步** (15分钟)
   - 查看核心代码：`AIAgentEngine.java`

3. **第3步** (15分钟)
   - 阅读 [EXAMPLES.md](qwen-ai-agent/EXAMPLES.md) 中的扩展开发部分

4. **第4步** (15分钟)
   - 尝试修改代码，添加自定义功能

---

## 📊 文档统计

### DeepSeek AI Agent
- **文档数量**: 5个
- **文档总行数**: 935行
- **核心文档**: ✅ 完整

### Qwen AI Agent
- **文档数量**: 7个
- **文档总行数**: ~1,400行
- **核心文档**: ✅ 完整
- **辅助文档**: ✅ 完整

### 项目根目录
- **文档数量**: 3个
- **文档总行数**: ~14,100行

### 总计
- **文档总数**: 15个
- **文档总行数**: ~2,350行

---

## 🔍 根据需求查找文档

### 我想知道如何配置
- 📖 [QUICKSTART.md](qwen-ai-agent/QUICKSTART.md) (两个模块都有)

### 我想了解模块功能
- 📖 [README.md](qwen-ai-agent/README.md) (两个模块都有)

### 我想看使用示例
- 📖 [EXAMPLES.md](qwen-ai-agent/EXAMPLES.md) (两个模块都有)

### 我想对比两个模块
- 📖 [DEEPSEEK_VS_QWEN.md](qwen-ai-agent/DEEPSEEK_VS_QWEN.md)

### 我想了解模块是如何创建的
- 📖 [CREATION_SUMMARY.md](qwen-ai-agent/CREATION_SUMMARY.md) (两个模块都有)

### 我想运行演示
- 🎬 `demo.sh` / `demo.bat` (Qwen模块)

### 我是新手，不知道从哪里开始
- 🚀 [START_HERE.md](qwen-ai-agent/START_HERE.md) (Qwen模块)

---

## 💡 模块选择建议

### 选择 Qwen AI Agent 如果：
- ✅ 国内业务场景
- ✅ 需要更快的API响应
- ✅ 偏好阿里云生态系统
- ✅ 需要多种模型选择（plus/max/turbo）
- ✅ 想要有演示脚本

### 选择 DeepSeek AI Agent 如果：
- ✅ 国际化业务场景
- ✅ 已有DeepSeek账号和配额
- ✅ 需要与DeepSeek特定功能集成

**两个模块的功能完全一致，只是后端模型不同。**

---

## 🎯 常见问题快速定位

### Q: 如何配置API密钥？
**A**: 参考 [QUICKSTART.md](qwen-ai-agent/QUICKSTART.md) 中的"步骤1"

### Q: 如何启动应用？
**A**: 参考 [QUICKSTART.md](qwen-ai-agent/QUICKSTART.md) 中的"步骤2"

### Q: 如何调用API？
**A**: 参考 [EXAMPLES.md](qwen-ai-agent/EXAMPLES.md) 中的API调用示例

### Q: sessionId是什么？
**A**: 参考 [README.md](qwen-ai-agent/README.md) 中的"核心功能"

### Q: 两个模块有什么区别？
**A**: 参考 [DEEPSEEK_VS_QWEN.md](qwen-ai-agent/DEEPSEEK_VS_QWEN.md)

### Q: 如何扩展功能？
**A**: 参考 [EXAMPLES.md](qwen-ai-agent/EXAMPLES.md) 中的"扩展开发"

---

## 📚 完整文档列表

### 项目根目录
1. ✅ [DOCUMENTATION_SUMMARY.md](DOCUMENTATION_SUMMARY.md) - 文档体系总结
2. ✅ [DEEPSEEK_AI_AGENT_DOCUMENTATION.md](DEEPSEEK_AI_AGENT_DOCUMENTATION.md) - DeepSeek说明
3. ✅ [QWEN_AI_AGENT_MODULE.md](QWEN_AI_AGENT_MODULE.md) - Qwen模块说明

### DeepSeek AI Agent
4. ✅ [deepseek-ai-agent/README.md](deepseek-ai-agent/README.md)
5. ✅ [deepseek-ai-agent/QUICKSTART.md](deepseek-ai-agent/QUICKSTART.md)
6. ✅ [deepseek-ai-agent/EXAMPLES.md](deepseek-ai-agent/EXAMPLES.md)
7. ✅ [deepseek-ai-agent/CREATION_SUMMARY.md](deepseek-ai-agent/CREATION_SUMMARY.md)
8. ✅ [deepseek-ai-agent/DOCUMENTATION_COMPLETE.md](deepseek-ai-agent/DOCUMENTATION_COMPLETE.md)

### Qwen AI Agent
9. ✅ [qwen-ai-agent/README.md](qwen-ai-agent/README.md)
10. ✅ [qwen-ai-agent/QUICKSTART.md](qwen-ai-agent/QUICKSTART.md)
11. ✅ [qwen-ai-agent/EXAMPLES.md](qwen-ai-agent/EXAMPLES.md)
12. ✅ [qwen-ai-agent/DEEPSEEK_VS_QWEN.md](qwen-ai-agent/DEEPSEEK_VS_QWEN.md)
13. ✅ [qwen-ai-agent/CREATION_SUMMARY.md](qwen-ai-agent/CREATION_SUMMARY.md)
14. ✅ [qwen-ai-agent/START_HERE.md](qwen-ai-agent/START_HERE.md)
15. ✅ [qwen-ai-agent/DELIVERY_REPORT.md](qwen-ai-agent/DELIVERY_REPORT.md)

---

## 🎉 开始使用

**推荐起点**: [qwen-ai-agent/START_HERE.md](qwen-ai-agent/START_HERE.md)

祝使用愉快！🚀

---

**文档创建时间**: 2026-02-27
**文档版本**: v1.0.0