开始构建 Spring AI Alibaba-智能体

✅Playground 智能体

Spring AI Alibaba 官方社区开发了一个包含完整 前端 UI +后端 的智能体 Playground 示例，可帮助开发者快速体验聊天、多轮对话、图片生成、文档总结、多模态、工具调用、MCP 集成、RAG 知识库等所有框架核心能力。

✅快速体验

运行以下 Docker 命令，可以在本地快速部署并体验 Playground：

Terminal window

powershell 复制代码

docker run -d -p 8080:8080 \
  -e AI_DASHSCOPE_API_KEY=xxxxxxxxxxxxxxxxx \
  --name spring-ai-alibaba-playground \
  sca-registry.cn-hangzhou.cr.aliyuncs.com/spring-ai-alibaba/playground:1.0.0.2-x

打开浏览器访问 http://localhost:8080 查看前端页面：

Playground 作为一个 AI 智能体应用，依赖大模型等在线服务，需要通过环境变量指定访问凭证。如果要开启 Playground 全部能力，需要通过环境变量指定百度翻译、阿里云信息检索服务等工具访问凭证，具体请查看查看 Playground 完整部署文档。

✅开启更多组件

Playground 作为一个 AI 智能体应用，依赖大模型等在线服务，需要通过环境变量指定访问凭证。如果要开启 Playground 全部能力，需要通过环境变量指定访问凭证：

● 【必须】阿里云百炼 API-KEY，大模型服务，示例 export AI_DASHSCOPE_API_KEY=xxx

● 【可选】阿里云百炼创建知识库，知识库服务，默认知识库名为saa-playground-2

● 【可选】百度翻译 appId 和 secretKey，使用 Tool Call 时必须，示例 export BAIDU_TRANSLATE_APP_ID=xxx、export BAIDU_TRANSLATE_SECRET_KEY=xxx

● 【可选】百度地图 api key，使用 Tool Call 必须，示例 export BAIDU_MAP_API_KEY=xxx

● 【可选】阿里云 IQS 服务 apikey，使用联网搜索必须，示例 export IQS_SEARCH_API_KEY=xxx

● 【可选】阿里云 AnalyticDB 向量数据库，使用 RAG 时可开启（默认使用内存向量数据库）。先使用 export VECTOR_STORE_TYPE=analyticdb 开启 AnalyticDB，然后配置相关参数

示例 Docker 运行命令：

powershell 复制代码

docker run -d -p 8080:8080 \
  -v "$(pwd)/logs:/app/logs" \
  -e AI_DASHSCOPE_API_KEY=your_api_key \
  -e ADB_ACCESS_KEY_ID=your_access_key \
  -e ADB_ACCESS_KEY_SECRET=your_secret_key \
  -e BAIDU_TRANSLATE_APP_ID=your_app_id \
  -e BAIDU_TRANSLATE_SECRET_KEY=your_secret_key \
  -e BAIDU_MAP_API_KEY=your_api_key \
  -e VECTOR_STORE_TYPE=analyticdb \
  -e IQS_SEARCH_API_KEY=your_api_key \
  --name spring-ai-alibaba-playground \
  sca-registry.cn-hangzhou.cr.aliyuncs.com/spring-ai-alibaba/playground:1.0.0.2-x

🔥源码启动

idea 配置

配置工作目录为当前启动项目

配置环境变量,将申请的api-key填入其中

db not exist的问题

在启动当前目录创建一个db目录即可

启动成功,可以开始调试和修改代码啦😃

👉重新构建docker镜像

修改代码后如果需要用docker 部署需要重新打包docker 镜像

powershell 复制代码

docker build -t spring-ai-playground:latest -f deploy/docker/Dockerfile .

启动自己构建的新镜像

shell 复制代码

docker run -d -p 8080:8080   -e AI_DASHSCOPE_API_KEY=xxxxxxxxxxxxx   --name my-spring-ai-alibaba-playground    spring-ai-playground:latest

启动成功