Spring AI Alibaba 5分钟快速开始

一个生产级Java AI框架,快速构建智能体应用

环境要求

支持的操作系统

macOS Windows Linux

运行环境

JDK 17+ 必需

所需工具

Git

克隆示例代码

必需
Maven

构建Java项目

必需

操作步骤

1

克隆示例项目

从GitHub下载ChatBot示例代码

克隆项目仓库
git clone https://github.com/alibaba/spring-ai-alibaba.git

预期结果::克隆成功,本地生成spring-ai-alibaba目录

确保网络连接正常

2

设置API密钥

获取并配置LLM提供商的API密钥(如DashScope)

在终端设置环境变量(Linux/macOS)
export SPRING_AI_ALIBABA_API_KEY='your-api-key-here'
在命令提示符设置环境变量(Windows)
set SPRING_AI_ALIBABA_API_KEY=your-api-key-here

预期结果::环境变量设置成功,无错误消息

从阿里云百炼获取API密钥,替换your-api-key-here

3

运行ChatBot

进入示例目录并启动Spring Boot应用

切换到ChatBot示例目录
cd spring-ai-alibaba/examples/chatbot
使用Maven启动应用
mvn spring-boot:run

预期结果::看到 'Started Application in X seconds' 日志,表示应用启动成功

首次运行可能需要下载依赖,请耐心等待

4

测试应用

在浏览器中访问ChatBot界面进行交互

无命令行,直接浏览器操作
打开浏览器,访问 http://localhost:8080/chatui/index.html

预期结果::浏览器显示聊天界面,可输入消息并收到AI回复

确保应用在运行,端口8080未被占用

验证成功

ChatBot正常运行并响应消息

应用启动日志无错误
浏览器界面加载成功
AI能回复消息

快速提示

环境

使用JDK 17或更高版本

配置

API密钥需正确设置,否则应用可能失败

进阶

查看官方Quick Start文档以编写自定义智能体

常见问题

1

应用启动失败,提示端口占用

停止占用8080端口的进程,或修改application.properties中的server.port

2

AI无响应或报错

检查API密钥是否正确,网络是否通畅,LLM服务是否可用

3

Maven构建慢或失败

检查网络,尝试使用阿里云Maven镜像

下一步

探索Agent Framework教程

学习构建更复杂的智能体和工作流

尝试Graph API

直接使用底层图计算引擎进行高级编排

访问官方文档

查看详细指南和API参考

助手