Spring AI 应用与智能体示例集
为 Java 开发者提供 Spring AI 大模型应用与智能体开发示例。
- Star 数
- ★ 155
- 最近更新
- 3 个月前
- 主语言
- Java
- FA 评分
- 42/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台OpenAI API(部分支持)
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- Java 开发者想从提示词、上下文和结构化输出示例开始学习 Spring AI。
- 不适合
- 需要开箱即用托管智能体服务的团队
- 不愿配置模型和 API 密钥的用户
- 官网
- ppai.top ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-07-31
这个 Agent 能做什么,适合哪些场景?
这是一个面向 Java AI 应用开发的独立示例工程集合,主要使用 Spring Boot、Spring AI 和 Maven。仓库按基础、进阶、应用和源码解读等主题组织内容,也包含 LangGraph4J、Spring AI Alibaba 与 AgentScope Java 2.0 示例。示例覆盖提示词、结构化输出、对话上下文、工具调用、MCP、多模态、RAG、工作流及多智能体场景。各项目彼此独立,可选择对应 Application 启动类运行;启动前需按所用模型调整 resources/application.yml 配置。它适合希望学习或试做 Java 大模型应用的开发者,不是部署后即可直接使用的托管产品。
开发者选择一个示例项目,以该项目的 Application 启动类运行,并根据模型需求修改 resources/application.yml。示例展示 Spring AI 的提示词、ChatClient、Advisor、工具调用、MCP Client/Server、异步流式调用和多模态等用法;其他目录还提供 LangGraph4J、Spring AI Alibaba 与 AgentScope 的智能体和编排示例。具体示例可实现对话历史持久化、Agent 路由、天气旅游美食推荐、RAG 问答、发票信息提取、语音识别翻译及自然语言转 SQL 等流程。模型调用与输出取决于所选示例和配置,仓库没有声明统一的服务端 API 或产品部署方式。
- Java 开发者想从提示词、上下文和结构化输出示例开始学习 Spring AI。
- 需要验证 Spring AI 工具调用或 MCP Client/Server 集成的工程师。
- 希望用 LangGraph4J 学习对话流程或 Agent 路由的开发者。
- 正在构建知识库问答、发票提取或自然语言转 SQL 原型的应用团队。
- 想比较 Spring AI Alibaba 与 AgentScope Java 示例的 Java 团队。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 配置文件
resources/application.yml.env.example.env- 运行环境
- Java 17
如何安装或部署这个 Agent?
仓库说明各示例是独立项目,可选择一个项目并基于其 Application 启动类运行。README 没有提供克隆命令、通用 Maven 启动命令或所有示例的统一安装步骤。技术栈列出 Maven 与 Java 17;v2 示例使用 Java 21、Spring Boot 4.x 和 Spring AI 2.x。启动前需按所选示例及模型调整配置,并准备相应模型接入信息;具体模型和密钥要求因示例而异。
如何使用这个 Agent?
选择一个示例项目,检查其 resources/application.yml 并替换为实际模型配置。密钥可通过环境上下文、启动参数、配置文件硬编码,或将仓库根目录的 .env.example 复制为 .env 并填入 ApiKey;仓库称此方式由 spring-ai-demo-starter 支持。随后通过该项目的 Application 启动类运行。README 未给出通用启动命令或统一的首次 API 调用,因此具体启动方式取决于所选项目。
这个 Agent 有哪些优点和局限?
- 基础教程按主题提供 Spring AI 实例,覆盖提示词、结构化返回、工具调用、MCP 和多模态。
- 各示例项目相互独立,README 明确说明可选择项目并从其 Application 启动类运行。
- 仓库同时收录 LangGraph4J、Spring AI Alibaba 和 AgentScope Java 2.0 相关示例。
- 应用案例涉及 RAG、语音翻译、发票提取及自然语言转 SQL 等具体流程。
- 它是学习与参考用的示例工程集合,README 表明理论、架构设计和框架封装内容可能较少。
- 运行前需要按示例更改模型配置并自行提供密钥;README 未给出统一的首次运行命令。
- 各项目独立且技术栈版本不一,包括 Java 17/Spring Boot 3.5.3 与 v2 的 Java 21/Spring Boot 4.x。
- README 未明确许可证,也没有说明托管服务、统一 API 或成本。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Spring AI 应用与智能体示例集 当前 | 42 · 缺口较多 | 开发框架 | ★ 155 | 3 个月前 | Java | — |
| ReachAI 企业智能体开发平台 | 67 · 存在缺口 | 自托管服务免费 + 模型费 | ★ 1.1k | 6 天前 | Java | OpenAI API |
| ai4j — Java AI Agentic 开发套件 | 60 · 存在缺口 | 代码库 / SDK免费 + 模型费 | ★ 442 | 1 个月前 | Java | OpenAI API · Claude API |
| Agentica | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 365 | 今天 | Python | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
CI 工作流将 GitHub 权限限制为 contents:read、pull-requests:write,并发起 PR 评论;但 pull_request_target 运行代码审核流程,创建 App token,且通过密钥配置把差异发送到可配置的外部模型端点。README 建议可将密钥硬编码在配置文件,所示技能还要求读取本地风格文件;未见用户确认、数据流说明、敏感数据防护或回滚流程。依赖安全缺乏材料,归因仅有个人博客关联,身份未验证。
工作流有环境检查、HTTP/URL 错误处理和失败日志,但依赖 Python、GitHub API、App 凭证及模型端点;默认提示要求特定输出格式,代码还从密钥与变量读取提示配置,配置缺失时行为在材料中未充分说明。README 项目版本与示例说明可追踪,但未见交叉验证或运行证据。
README 明确面向 Java 开发者,列出基础、进阶、应用及多框架示例,展示适用场景与技术边界;技能触发词较明确,但 blog_creator 的适用范围很宽,且部分技能描述了不同平台工具/工作流。环境说明包括 Java、Spring Boot、Maven 与模型配置,仍需用户自行替换模型及凭证。
README 按教程层级与示例目录组织,提供本地启动、版本栈、教程链接和项目为示例用途的限制说明;技能文件包含结构模板和示例。未提供许可证信息;版本迁移信息零散且无变更日志,维护责任仅以个人体验项目和公众号说明,更新责任不清。
教程目录、独立启动说明和样例技能可帮助开发者入门与复用;代码审核工作流能产出 PR 评论,但审核提示倾向将条件性问题归为建议,且需要模型、GitHub App 与多项密钥配置,普通使用的维护成本较高。
README 的技术栈、目录和教程主张有具体名称及路径,工作流展示实际配置键与错误分支;技能内容可与其用途相互印证,但可见材料未提供测试结果、输出样例或独立验证,且技能规范中的“代码可运行”等属于指导性主张而非已验证事实。
- 源码中未见:依赖安全审查安装前固定版本并做一次依赖扫描(如 npm audit、pip-audit);优先放在容器里运行。
- 源码中未见:回滚或恢复路径运行前先备份,或在 git 分支、快照上操作,确保改动可以撤销。
- CI 审核会把 PR 差异发送到配置的模型服务;部署前应确认差异内容、服务端点及其数据处理方式符合预期。
- README 将配置文件硬编码密钥列为可选方式;避免把真实凭证提交到仓库。
常见问题
这是可以直接使用的在线智能体产品吗?
运行示例需要准备什么?
所有示例都使用同一套 Java 和 Spring 版本吗?
仓库是否只支持某一家模型提供商?
Spring AI 应用与智能体示例集 官网是什么?
Spring AI 应用与智能体示例集 开源吗?
Spring AI 应用与智能体示例集 安全吗?
Spring AI 应用与智能体示例集 还在维护吗?
Spring AI 应用与智能体示例集 是谁开发的?
谢谢反馈,我们会据此改进页面。