Spring AI Alibaba 学习项目

基于 Spring AI Alibaba 框架的系列学习示例项目，包含 19 个完整示例，涵盖从基础到高级的各种 AI 应用场景。

项目结构

本仓库包含多个独立的 Spring Boot 子项目，每个项目演示 Spring AI Alibaba 的不同功能特性：

项目	说明
SAA-01HelloWorld	Hello World 入门示例
SAA-02Ollama	Ollama 本地模型集成
SAA-03ChatModelChatClient	聊天模型与客户端使用
SAA-04StreamingOutput	流式输出实现
SAA-05Prompt	Prompt 提示词工程
SAA-06PromptTemplate	Prompt 模板使用
SAA-07StructuredOutput	结构化输出
SAA-08Persistent	数据持久化
SAA-09Text2image	文本转图像
SAA-10Text2voice	文本转语音
SAA-11Embed2vector	文本向量化
SAA-12RAG4AiOps	RAG检索增强生成(AiOps)
SAA-13ToolCalling	工具调用
SAA-14LocalMcpServer	本地MCP服务器
SAA-15LocalMcpClient	本地MCP客户端
SAA-16ClientCallBaiduMcpServer	调用百度MCP服务
SAA-17BailianRAG	百炼RAG集成
SAA-18TodayMenu	今日菜单推荐
SAA-19AIEduAssistant	AI教育助手(RAG+向量数据库)

环境要求

• JDK 8 或更高版本
• Maven 3.6+
• Redis（部分项目需要）

快速开始

1. 配置环境变量

# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，填入你的 DashScope API Key
# 获取地址: https://dashscope.console.aliyun.com/apiKey

.env 文件内容：

DASHSCOPE_API_KEY=your_dashscope_api_key_here

2. 运行项目

每个子项目都是独立的 Spring Boot 应用，可以单独运行：

# 进入具体项目目录
cd SAA-01HelloWorld

# 运行项目
mvn spring-boot:run

技术栈

• Spring Boot 3.x
• Spring AI Alibaba
• DashScope (通义千问)
• Redis (部分项目)
• Maven

注意事项

1. API Key 安全：所有敏感配置通过环境变量管理，请勿将 .env 文件提交到版本控制系统
2. Redis 配置：部分项目需要本地运行 Redis 服务
3. 端口占用：各项目默认端口不同，请查看各项目的 application.properties 配置

许可证

MIT License