大家好!我是你们的 AI 技术向导。今天带来一篇超级实用的 Spring AI 上手教程,专为零基础的 AI 爱好者设计。无需高深技术背景,只需 10 分钟,你就能创建一个能对话的智能体!
什么是 Spring AI?
Spring AI 是 Spring 生态中用于简化 AI 应用开发的框架,让开发者能轻松集成大语言模型。今天的 Demo 将基于阿里云的 DashScope 平台,创建一个专业的心理咨询师智能体。
环境准备
首先,我们需要创建一个 Spring 项目。推荐使用 IDEA 开发工具:
- 打开 IDEA,选择新建 Spring 项目

- 设置 Spring Boot 版本以及依赖

- 项目创建成功后,进入下一步
添加关键依赖
在项目的 pom.xml 文件中,添加以下两个核心依赖:
<dependency><groupId>com.alibaba.cloud.ai</groupId><artifactId>spring-ai-alibaba-agent-framework</artifactId><version>1.1.0.0-M5</version>
</dependency>
<dependency><groupId>com.alibaba.cloud.ai</groupId><artifactId>spring-ai-alibaba-starter-dashscope</artifactId><version>1.1.0.0-M5</version>
</dependency>
这两个依赖分别提供了智能体框架和 DashScope 模型的支持。
编写核心代码
在 com.jackson.aiagent 包下创建 AgentExample.java 文件:
package com.jackson.aiagent;// 导入必要的类
public class AgentExample {public static void main(String[] args) throws Exception {// 1. 创建模型实例(记得替换成你自己的API Key)DashScopeApi dashScopeApi = DashScopeApi.builder().apiKey("sk-309xxxxxxxxxxxxxxxxxxxxxxxx").build();ChatModel chatModel = DashScopeChatModel.builder().dashScopeApi(dashScopeApi).build();// 2. 创建智能体角色ReactAgent agent = ReactAgent.builder().name("智能心理咨询师").model(chatModel).instruction("你是一名10年经验的资深心理咨询师.").build();// 3. 与智能体对话var response = agent.call("抑郁症有些什么症状?该如何缓解?");System.out.println(response.getText());}
}
运行你的第一个 AI 智能体
代码编写完成后,直接运行 main 方法。你会看到控制台输出类似以下内容:

技术要点解析
- API Key 配置:需要到 DashScope 平台申请自己的 API Key
- 智能体定制:通过 instruction 参数定义智能体的专业背景
- 对话交互:使用 call 方法即可与智能体进行对话
拓展思路
这个 Demo 虽然简单,但已经包含了 AI 智能体的核心要素。你可以尝试:
- 更换不同的专业角色(如法律顾问、编程助手等)
- 设计更复杂的对话流程
- 集成到 Web 应用中提供在线服务
总结
通过这个教程,我们见证了 Spring AI 的强大之处——用极简的代码实现智能对话功能。作为 AI 新手,这是一个完美的起点。未来你可以在此基础上探索更复杂的 AI 应用场景。
动手试试吧! 在评论区分享你的第一个智能体作品,遇到问题随时提问哦~
本文基于技术文档整理,适合 AI 入门学习。实际开发中请参考官方最新文档。
_Reference: _https://github.com/alibaba/spring-ai-alibaba