优秀 Spring AI

https://github.com/spring-ai-community/awesome-spring-ai

一份精心整理的资源列表，涵盖使用 Spring AI 构建生成式 AI 应用的优秀资料、工具、教程和项目。该仓库旨在帮助开发者在 Spring 生态中充分发挥大语言模型（LLM）的强大能力。

什么是 Spring AI？

Spring AI 是由 Spring 团队推出的项目，旨在为构建 AI 应用提供熟悉且一致的 Spring 风格开发体验。它简化了将大语言模型（LLM）及其他 AI 能力集成到 Spring 应用中的过程，并提供以下特性：

在不同 AI 提供商之间提供一致的抽象层
支持主流的大语言模型供应商
强大的提示词工程能力
内置缓存与重试机制
向量化存储集成
支持流式响应
可自定义的模型参数
原生集成 Spring Boot

官方资源

文档

Spring AI 博客

你的第一个 Spring AI 1.0 应用 —— 完整教程：使用 RAG、MCP、向量存储和 PostgreSQL 构建生产级的狗狗领养服务（2025 年 5 月）
仓库向量搜索方法 —— 技术指南：使用 Spring Data 3.5 实现向量搜索，涵盖 Vector 类型、SearchResults 和搜索方法（2025 年 5 月）
在 Spring AI 与 OAuth2 中实践 MCP 授权 —— 基于最新 MCP 规范：使用外部 OAuth2 授权服务器保护 Spring AI MCP 服务器与客户端（2025 年 5 月）
Spring AI 的 Model Context Protocol 中的动态工具更新 —— 如何基于 Spring AI 的 MCP 实现动态更新 AI 助手可用的工具（2025 年 5 月）
使用 Spring AI 1.0.0-SNAPSHOT：第 2 部分 —— 重要变更与更新 —— 继续介绍 snapshot 系列：讲解 Spring AI 模块重构、新 artifact ID 和迁移步骤（2025 年 4 月）
使用 OAuth2 保护 Spring AI MCP 服务器 —— 如何利用 Spring Security 与授权服务器为 Spring AI MCP 服务器添加 OAuth2 认证（2025 年 4 月）
Spring AI Prompt Engineering 模式 —— Spring AI 应用中的提示工程最佳实践与模式（2025 年 4 月）
Spring AI 与 Docker Model Runner —— 使用 Docker Model Runner 进行本地开发的集成教程（2025 年 4 月）
用 Spring AI 构建高效 Agents（第 1 部分） —— 介绍五种基础 Agent 模式（链式、并行、路由、协调者-工作者、评估器-优化器）及其 Spring AI 实现（2025 年 1 月）
Agentic AI 是未来！Agentic AI 就是现在！ —— 探讨在 Spring AI 中构建自主 AI 系统的 Agentic 模式（2025 年 1 月）
使用 Spring AI 与 Ollama 力量联动 45k+ 免费 Hugging Face 模型
用 Spring AI Advisors 超级增强你的 AI 应用
Spring AI + NVIDIA LLM API 集成
Spring AI 支持 OpenAI Structured Outputs：提升 JSON 响应的可靠性
Spring AI 与 Groq —— 超高速 AI 推理引擎集成
Spring AI 与 Ollama 工具调用支持
Spring AI —— 结构化输出
Spring AI —— 多模态：感官之书 Orbis Sensualium Pictus
使用最新 Mistral AI API 在 Java 与 Spring AI 中进行 Function Calling
AI 遇见 Spring Petclinic：利用 Spring AI 实现 AI 助手（第一部分）
AI 遇见 Spring Petclinic：利用 Spring AI 实现 AI 助手（第二部分）
Spring Pet Klinik —— Kotlin 版本

学习资源

书籍

文章

使用 Spring AI 与 Model Context Protocol 构建 AI 原生 API —— 以实践方式指导如何在 Spring Boot 应用中实现 MCP 服务器，介绍利用工具、资源和提示（prompts）与现有服务集成的 “双 API 模式”（2025 年 9 月）
使用 Spring AI 与 GPT OSS 创建私有 AI 应用 —— 全面教程展示如何通过 Spring AI 集成本地 gpt-oss:20b（基于 Ollama），涵盖 RAG、聊天记忆、结构化输出，并构建一个移民顾问聊天机器人（2025 年 9 月）
精通 Spring AI：轻松为 Spring Boot 应用添加 LLM 智能 —— 演示如何通过 Spring AI 配置在 GPT-4 与 Gemini 之间切换，并强调避免厂商锁定（2025 年 8 月）
Spring AI 概念教程与示例 —— Spring AI 1.0 GA 版本更新指南：模型、提示、嵌入（embeddings）、ChatModel/ChatClient、Advisors，以及聊天机器人示例（2025 年 3 月，2025 年 8 月更新）
通过 Spring AI 实现 Agentic AI：基础示例 —— 介绍在 Spring AI 中实现 Agent 模式的最小示例，包括向量数据库、对话记忆、工具调用、RAG、结构化输出、护栏（guardrails）及监控指标（2025 年 6 月）
从文档到对话：使用 Spring Boot 与 Milvus 构建生产级 AI 助手 —— 使用 Spring Boot + Spring AI 并结合 Milvus 构建基于 RAG 的 ChatClient 应用的分步教程（2025 年 6 月）
使用 Spring Boot 构建高效 AI Agents —— 深入探讨链式、并行化、编排式等 Agent 架构，并基于 Spring AI 实现，附带 GitHub 仓库（2025 年 5 月）
Vadym Kazulkin 的 Spring AI + Amazon Bedrock 系列文章 —— AWS Serverless Hero 撰写的四篇深度文章，探讨 Spring AI 与 Amazon Bedrock 集成及 MCP 实现：
- 第 1 部分：介绍及示例应用 —— 会议搜索应用，使用工具与聊天记忆（2024 年 8 月）
- 第 2 部分：MCP STDIO 传输 —— 通过 STDIO 实现 MCP 服务器，包含工具发现与自然语言交互（2024 年 8 月）
- 第 3 部分：MCP SSE 传输 —— 演示使用 SSE（服务器推送事件）的 MCP 实现（2024 年 9 月）
- 第 4 部分：MCP Streamable HTTP —— 使用可流式 HTTP 传输实现 MCP 服务器（2024 年 9 月）
理解 LLM 的工具/函数调用（REST 与 Spring AI 的逐步示例） —— 从原始 REST 到 Spring AI 注解式开发的工具调用实现（2025 年 7 月）
使用 Spring 与 Kotlin 进行语义搜索 —— Spring AI 中 embeddings 语义搜索的完整指南（2025 年 4 月）
Java 应用中的 Spring AI —— Spring 在企业 AI 集成中的愿景（2025 年 3 月）
使用 Spring AI 配置 MCP-Client SSE —— 介绍如何为 MCP 客户端配置服务端推送 SSE（2025 年 2 月）
Spring AI：初学者指南（第 1、2 部分） —— 多部分入门教程：
- 第 1 部分涵盖在 Spring Boot 中集成 OpenAI/Ollama
- 第 2 部分深入分析 Advisor API（2024 年 12 月）
Why Spring AI：通往生成式 AI 的无缝之路 —— 介绍 Spring AI 的优势及其相对其他 AI 框架的优点（2024 年 11 月）
使用 Spring AI 构建生成式 AI 应用 —— 项目式完整示例（2024 年 11 月）
Spring Boot 遇见 AI —— 在饮食计划应用中集成 OpenAI 与 Anthropic（2024 年 10 月）
Spring AI 入门（Java Code Geeks） —— 面向 Java 开发者的简单介绍（2024 年 9 月）
Spring AI 快速上手指南 —— Spring AI 核心组件和模型抽象的介绍（2024 年 8 月）
如何使用 Java 编写 GenAI 应用（Foojay.io） —— 涵盖 RAG 与 Spring AI 模板的全面指南（2024 年 7 月）

在线培训

Udemy 课程

从 Java 开发者到 AI 工程师：Spring AI 快速通道 —— 使用 Spring AI、OpenAI、RAG、MCP、AI 测试、可观测性、语音与图像生成构建 AI 应用作者：Madan Reddy & Eazy Bytes（2024）
使用 Spring AI、OpenAI、Ollama 与 Spring Boot 构建 AI 应用 —— 学习基于 LLM 的聊天、检索增强生成（RAG）、工具调用、多模态 AI（2024 年 8 月）
Spring AI - 与 Telusko 一起学习 GenAI —— 使用 Spring AI、OpenAI、Ollama、RAG、向量数据库构建多模态能力的 Spring Boot AI 应用作者：Navin Reddy（2024）
使用 Java 和 Spring Boot 掌握生成式 AI｜Spring AI —— 使用 Java 与 Spring 构建 AI 驱动应用及其生命周期管理作者：Shabbir Dawoodi（2024）
深度解析：使用 Spring 开发生成式 AI 应用 —— 掌握 Spring AI 与高级生成式 AI 技术作者：Ken Krueger（2024）
使用 Spring AI 与 React 构建 AI 客服系统 —— 构建专业级 AI 客服系统，结合 Spring AI、Spring Boot 与 React 作者：Samson Alfred（2024）
Spring AI：创建工作流、智能体与数据解析 —— 创建智能工作流、自主代理（Agents）及高级数据解析作者：Verissimo Ribeiro（2024）
Spring AI：从 AI 基础到 Spring AI 深度解析 —— 使用 Java 结合 Spring AI 与 OpenAI 掌控生成式 AI 作者：Uladzislau Zhurauliou（2024）
Spring AI：从入门到大师 —— 使用 Java 与 Spring AI 解锁 OpenAI 的 ChatGPT 能力作者：John Thompson（2024）
精通 Spring AI：用 Java 构建 AI —— 利用 AI 的力量改造 Java 应用作者：Pritesh Mistry（2024）
Spring AI 初学者指南：构建 GenAI 与 LLM 应用 —— Spring AI 的循序渐进掌握指南作者：Bharath Thippireddy（2024）
Spring AI 与 Neo4j：知识图谱 RAG —— 使用 Spring AI、Neo4j 与 OpenAI 实现基于向量相似度与知识图谱的 RAG 作者：Timotius Pamungkas（2024）

YouTube

频道

演讲与视频

实用的 Agentic RAG 与 Spring AI 在现代企业应用中的实践 • Dan Dobrin @ Spring I/O 2025 —— 面向企业的、基于 Spring AI 的 Agentic RAG 实现（2025 年 5 月）
Spring AI 的最新进展 • Josh Long • GOTO 2025 —— 2025 年中对 Spring AI 当前状态、进展、路线图与能力的全面概述（2025 年 5 月）
更聪明地编程，而不是更辛苦：面向所有人的 AI 驱动开发技巧 • Dan Vega @ Spring I/O 2025 —— 在 Spring 应用中通过 Spring AI 提升生产力的实用开发技巧（2025 年 5 月）
使用 Java 与 Spring AI 构建模块化 RAG 架构 • Thomas Vitale @ Spring I/O 2025 —— 用 Java 和 Spring AI 构建检索增强生成（RAG）架构的实用指南（2025 年 5 月）
代码末日：LangChain4j vs. Spring AI | J-Spring 2025 —— 对比 Spring AI 与 LangChain4j 的框架特性、权衡与适用场景（2025 年 5 月）
在 Java Spring AI 中使用 OpenRouter —— 使用 Spring AI 集成 OpenRouter，通过单一 API 访问多家 AI 模型供应商（2025 年 5 月）
Spring AI 与 Cloud Foundry：Bootiful、Agentic、生产级 —— 在 Cloud Foundry 上构建生产级 Spring AI 应用（2025 年 4 月）
从单轮 LLM 到智能代理（Agents） —— 介绍利用 Spring AI 构建智能代理系统（2025 年 4 月）
Spring AI 教程 — Advisors —— 深入解析 Spring AI 中的 Advisor（2025 年 4 月）
Spring AI 教程 — Model Context Protocol (MCP) —— 在 Spring AI 中使用 MCP 的完整指导（2025 年 4 月）
面向 Java 开发者的 Spring AI 全课程 / 工作坊 —— 涵盖 Spring AI 基础与实践的完整培训课程（2025 年 6 月）
重大新闻：Spring AI 将于 2025 年 5 月正式 GA！1.0.0-M7 —— 宣布 Spring AI 达到生产可用（GA）里程碑（2025 年 5 月）
Spring AI 教程：将 ChatGPT 集成到 Spring Boot 与 OpenAI 中 —— 如何在 Spring Boot 应用中集成 ChatGPT（2025 年 5 月）
在几分钟内将 AI 集成到你的企业应用中 — Spring AI —— 使用 Spring AI 快速实现企业级 AI 集成（2025 年 4 月）
使用 Spring AI 进行 Prompt Engineering • Josh Long 在 Christian Tzolov 评论中 —— 2025 年 4 月
Spring AI 深度解析 • Mark Pollack & Josh Long @ Devnexus —— 2025 年 4 月
#1 Spring AI 教程 | 入门篇 —— 涵盖 Spring AI 基础和环境配置（2025 年 3 月）
MCP，就像 ABC 那么简单… —— Model Context Protocol 的入门介绍（2025 年 3 月）
Bootiful Spring AI —— 多谢 Devnexus 授权重新呈现该视频（2025 年 3 月）
Spring AI M4 有什么新内容 • Josh Long —— 2025 年 2 月
智能应用程序与 Spring AI • Patrick Baumgartner @ JFokus 2025 —— 2025 年 2 月
Spring Boot + Vaadin 与 Spring AI MCP • Marcus Hellberg —— 2025 年 2 月
Spring AI 课程 • freeCodeCamp —— 2024 年 12 月
使用 AWS 构建 Agents：完整教程 • Josh Long & James Ward —— 2024 年 11 月
Spring AI 介绍：使用 Spring 构建 AI 应用 —— Spring AI 架构与 Java 实践（2024 年 4 月）
Java 与 AI 的协奏曲：构建生产级 LLM 应用 • Spring I/O 2024 —— 构建生产就绪的 LLM 应用的方法与案例（2024 年 5 月）
使用 Spring AI 构建和盈利化生成式 AI 插件 • SpringOne 2024 —— 如何创建和盈利化 AI 插件（2024 年 9 月）
用 Spring AI Advisors 为你的 AI 应用提速 • Spring 团队 —— 2024 年 10 月
Spring AI 是你所需要的一切 • Christian Tzolov • GOTO Amsterdam 2024 —— 2024 年 6 月
Spring AI 实用生成式 AI • Rod Johnson @ YOW! 2024 —— 2024 年 6 月
Introducing Spring AI • Christian Tzolov / Mark Pollack @ Spring I/O 2024 —— 2024 年 5 月
将 GenAI 带入现代企业：一个生产级无服务器 Java 案例 • Dan Dobrin • Devoxx Belgium 2024 —— 2024 年 5 月
Bootiful Spring Boot • Josh Long @ SpringOne 2024 —— 2024 年 1 月
Bootiful 人工智能 • Josh Long, Mark Pollack & Rod Johnson @ SpringOne 2024 —— 2024 年 1 月
Spring AI：无缝集成 AI 到你的企业 Java 应用中 —— 2023 年 12 月
Spring AI 概览 @ Devoxx 2023 —— 2023 年 11 月
Spring Tips：Spring AI —— 2023 年 10 月
Introducing Spring AI • 将生成式 AI 加入你的 Spring 应用 —— 2023 年 10 月
Spring AI 在 Spring.IO Keynotes 中亮相 —— 2023 年 10 月

通用播放列表

Spring AI 教程 - SivaLabs —— 全面的 Spring AI 教程系列，涵盖基础知识、集成方法及实用实现（2025 年 9 月）
AI Native DevCon - Spring 2025 —— 大会播放列表，包含 Spring AI 相关内容及 AI 原生开发主题（2025 年春季）
Craig Walls 的 Spring AI 播放列表
Dan Vega 的播放列表
Devoxx 播放列表
Telusko Spring AI 教程播放列表 —— 全面教程系列，涵盖 Spring AI 与 OpenAI、Anthropic 及 Ollama 的集成实现
AI - 人工智能播放列表 —— 涵盖 Spring AI 以及通用人工智能概念和实现的视频合集

播客

工作坊

Spring AI 从零到高手工作坊 - 展示如何使用 Spring AI 构建生成式 AI 项目的示例应用程序。
（过时）Azure OpenAI 工作坊材料 - 包含从 “hello world” 到 “检索增强生成（RAG）” 的逐步示例。
Spring AI Java 开发者的 Gemini 工作坊 • Dan Dobrin - 针对使用 Spring AI 构建 Gemini 模型生成式 AI 应用的 Java 开发者的工作坊材料。
探索与大型语言模型的交互：使用 Spring AI 的实用见解 - 一门自学式工作坊，旨在练习 Spring AI 基础知识并探索与 LLM 的交互。

非英文资源

其他语言的文章

“深度学习” 关于 Spring AI：入门指南 - 西班牙语介绍 Spring AI 概念并构建一个简单的 Spring Boot 聊天机器人（2025 年 5 月）
Spring AI 与 Groq：创建智能助手的完整指南 - 葡萄牙语教程，讲解如何将 Spring AI 与 Groq 结合使用，包括使用 CATS 框架进行提示工程（2025 年 8 月）
Spring AI 入门教学：从零搭建智能应用（2025 最新实践） - 中文指南，介绍 Spring AI，使用 Azure OpenAI 构建聊天机器人，支持流式响应、记忆、多模态（2025 年 3 月）

其他语言的视频

2025 年最新 Spring AI Alibaba 入门到进阶实战教程（Bilibili 系列） - 中文 54 集视频课程，涵盖 Spring AI Alibaba、LLM、RAG、函数调用及电商聊天机器人构建（2025 年 6 月）

代码与示例

综合示例集合

Spring AI 样例合集（Thomas Vitale）- 大量示例展示如何构建由生成式 AI 和大型语言模型（LLM）驱动的 Java 应用程序。包含不同 AI 模型、RAG 实现以及各种 Spring AI 特性的示例。
Spring AI 示例（Craig Walls）- 全面的示例仓库，包含数十个示例，涵盖所有主要的 Spring AI 功能、模型集成和实现模式。由《Spring AI in Action》一书的作者创建。
Spring AI 展示项目（Piotr Minkowski）- 模块化演示项目，展示多个 Spring AI 特性，包括提示模板、聊天记忆、结构化输出、函数调用、使用 Pinecone 向量库的 RAG，以及图像模型。通过配置不同的 Profile 支持多个 AI 服务提供商（OpenAI、Mistral、Ollama、Azure OpenAI）。

代码示例

Spring AI 官方示例 - 全面的官方示例仓库，包含所有 Spring AI 特性的示例，包括 MCP 动态工具、提示工程模式、智能体工作流、向量存储，以及各种模型集成（2025）。
Spring AI Docker Model Runner 示例 - 展示如何在本地开发与测试中，将 Docker Model Runner 与 Spring AI 集成使用的示例（2025）。
Spring PetClinic AI - 经典的 Spring PetClinic 应用加入了由 Spring AI 驱动的聊天机器人。演示如何通过自然语言与应用数据交互，用户可以通过对话查询和修改宠物诊所信息。支持 OpenAI 和 Azure OpenAI 作为 LLM 提供商。相关内容记录在 spring.io 的两篇博客系列中。
航班预订助手 - 一个由 Spring AI 提供支持的专家系统演示，用于模拟航班预订助手。展示如何使用 Spring AI 构建特定领域的 AI 助手。
Spring AI 与千帆（QianFan） - 展示 Spring AI 对千帆多种语言模型的支持。演示如何与千帆语言模型交互，以及如何基于千帆模型构建多语言对话助手。
使用 Spring AI 实现相似度搜索 - 实现一个简单的相似度搜索。演示如何使用 Kotlin 或 Java 搭配 Spring AI 生成向量嵌入并执行简单的相似度检索（2025 年 3 月）。

UI 客户端

Spring AI HTMX MCP - 使用 HTMX 为 Spring AI 应用构建现代交互式 UI 的示例。演示如何结合 HTMX 的服务端渲染能力与 Spring AI 的 Model Context Protocol，以最少的 JavaScript 创建响应式聊天界面。
Spring AI Vaadin - 将 Spring AI 与 Vaadin 集成，Vaadin 是一个用于构建现代 Web 应用的 Java 框架。该示例提供组件和案例，帮助使用纯 Java 创建丰富、交互式、由 AI 驱动的用户界面，无需了解 JavaScript 或 HTML。
DocumentGPT - Sergi Almar 开发的基于 RAG 的文档查询系统，允许用户上传文档并通过 Spring AI 的向量搜索能力与之对话。提供基于 Web 的界面，用于文档上传和交互式查询。
Spring AI Playground - 一个为 Java 开发者设计的 Web UI，使其能够轻松试验并集成 AI 模型。提供交互界面用于测试不同的提示和模型。

CLI 应用

Spring AI Chat Bot CLI - 具有检索增强生成（RAG）和对话记忆功能的命令行聊天机器人。展示了如何使用 Spring AI 构建交互式 CLI 应用程序。
Spring AI Powered Local CLI Chat Bot - 完全本地运行的、由 Spring AI 驱动的 CLI 聊天机器人，运行时完全不依赖任何外部服务。非常适合离线开发或对隐私敏感的应用场景。

扩展与分支

Spring AI Alibaba - Spring AI 的扩展，为 Java 开发者提供一个代理式（agentic）的 AI 框架。新增对阿里云 QWen 模型和 Dashscope 服务的支持，并提供会话记忆、RAG 支持和函数调用等额外功能。在保持与 Spring AI API 兼容的同时，为阿里云的 AI 生态提供专有能力。

开发工具

Arconia Ollama Dev Service - 一个 Spring Boot 开发服务，可自动管理 Ollama 实例，方便进行本地大语言模型（LLM）开发。通过处理容器生命周期与配置，简化使用本地模型进行测试和开发的流程。同时与 Spring AI 的 Ollama 支持无缝集成。

模型上下文协议（Model Context Protocol）

核心资源

MCP Client Documentation - Model Context Protocol 客户端在 Spring AI 应用中的官方实现文档。
MCP Client Examples - 展示 Model Context Protocol 在 Spring AI 中实现的完整示例，包括客户端-服务器通信、工具发现、文件系统操作、天气服务、网络搜索集成以及动态工具更新。
MCP Annotations - 用于实现 MCP 服务器和客户端的基于注解的编程模型。提供一种简洁、声明式的方式来处理 MCP 操作，减少样板代码。包含仅依赖 MCP Java SDK 的核心注解，以及一个 Spring AI 集成模块。

Spring 项目的 MCP 服务器

Spring Batch MCP Server - 一个用于自省 Spring Batch 应用的 MCP 服务，为 AI 助手提供批处理任务信息的访问能力。
Spring Cloud Config MCP Server - 一个针对 Spring Cloud Config 的实验性 MCP 服务器实现，将配置管理操作暴露为 AI 工具，使 AI 助手能够检索、更新、刷新应用配置，并对敏感值进行加密/解密。
JVM Diagnostics MCP - 一个用于获取 JVM 诊断信息的 Model Context Protocol 服务，使 AI 助手能够访问 Java 应用的运行时信息。

面向特定领域的 MCP 实现

Kotlin Crypto Price MCP Server - 一个基于 Kotlin 的 Spring AI MCP 服务器，从 Binance 提供实时加密货币价格信息。
Spring AI MCP Database Integration Example - 一个基于 Spring AI 的 MCP 实践示例，包含两个通过 @Tool 注解暴露数据库操作（人员与账户数据）的服务器应用，以及一个使用 OpenAI 模型发现并调用这些工具的客户端应用。
GitHub MCP Application - 一个由 Devoxx 创始人 Stephan Janssen 构建的、100% Java 实现并基于 Spring AI 的 GitHub MCP 应用。
Druid MCP Server - 一个面向 Apache Druid 的 Java 企业级 MCP 服务器，基于 spring-ai-1.1.0 Milestone，使用全新的 @Mcp 注解（@McpTool）和 OAuth，提供大量工具、资源以及 AI 辅助提示，用于管理和分析 Druid 集群。
AWS Sample MCP Demos - 一组展示如何在 AWS 服务中使用 Model Context Protocol 的示例，包括 Spring AI 的相关实现。

社区

工具与性能

基准测试

贡献指南

Testcontainers

Spring AI 提供了 Spring Boot 自动配置，用于建立与通过 Testcontainers 运行的模型服务或向量存储的连接。要启用此功能，请将以下依赖项添加到项目的 Maven pom.xml 文件中：

MCP（模型上下文协议）入门

模型上下文协议（MCP）标准化了 AI 应用与外部工具和资源的交互方式。