1. 项目概述
作为一名长期深耕Java生态的开发者,我最近被各种AI应用刷屏了。看着Python开发者们轻松调用各种大模型,心里难免痒痒的。直到发现了Spring AI Alibaba这个宝藏框架,终于让我在Java世界里也能玩转AI智能体开发。今天就用这篇实战指南,带大家用10分钟快速构建一个具备思考能力的天气查询智能体。
这个项目最大的价值在于:它打破了Java生态与AI应用之间的技术壁垒。通过阿里云百炼平台提供的DashScope模型(通义千问),我们可以用最熟悉的Spring风格代码实现:
- 自然语言交互
- 工具函数调用
- 多轮对话记忆
- 复杂任务分解
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 基础环境配置
工欲善其事必先利其器,我们先确认基础环境:
bash复制# 确认JDK版本(必须≥17)
java -version
# 确认Maven版本(必须≥3.8)
mvn -version
注意:低版本JDK会遇到
var语法兼容性问题,建议使用Amazon Corretto-17这类长期支持版本
2.2 获取模型API Key
- 访问阿里云百炼平台
- 完成企业实名认证(个人开发者可用支付宝认证)
- 在"模型服务"中开通DashScope
- 在"API密钥管理"创建新密钥
建议将API Key设置为环境变量(避免硬编码):
bash复制# Linux/macOS
export AI_DASHSCOPE_API_KEY=your_api_key
# Windows
setx AI_DASHSCOPE_API_KEY "your_api_key"
3. 项目搭建
3.1 初始化Spring Boot项目
使用start.spring.io生成项目时注意勾选:
- Spring Web(可选)
- Lombok(推荐)
3.2 关键依赖配置
在pom.xml中添加这些核心依赖:
xml复制<dependencies>
<!-- 智能体框架核心 -->
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-agent-framework</artifactId>
<version>1.1.2.0</version>
</dependency>
<!-- 通义千问模型支持 -->
<dependency>
<groupId>com.alibaba.cloud.ai</groupId>
<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
<version>1.1.2.0</version>
</dependency>
</dependencies>
刷新Maven依赖时可能会遇到阿里云仓库鉴权问题,建议在settings.xml中添加:
xml复制<mirror>
<id>aliyunmaven</id>
<mirrorOf>*</mirrorOf>
<name>阿里云公共仓库</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
3.3 配置文件设置
application.yml最小化配置:
yaml复制spring:
ai:
dashscope:
api-key: ${AI_DASHSCOPE_API_KEY} # 从环境变量读取
connect-timeout: 5000 # 连接超时(ms)
socket-timeout: 10000 # 响应超时(ms)
