初识Spring AI Alibaba

Miku16
675 阅读3分钟

在Spring AI Alibaba主页，点击“快速开始”。

来到Spring AI Alibaba的文档页面。

A:\study\javaee\Spring AI>git clone --depth=1 https://github.com/springaialibaba/spring-ai-alibaba-examples.git
Cloning into 'spring-ai-alibaba-examples'...
remote: Enumerating objects: 1060, done.
remote: Counting objects: 100% (1060/1060), done.
remote: Compressing objects: 100% (580/580), done.
remote: Total 1060 (delta 178), reused 912 (delta 100), pack-reused 0 (from 0)
Receiving objects: 100% (1060/1060), 31.70 MiB | 6.66 MiB/s, done.
Resolving deltas: 100% (178/178), done.

使用git clone --depth=1 https://github.com/springaialibaba/spring-ai-alibaba-examples.git命令拉取示例程序到本地。

使用IDEA打开项目。

我们尝试运行其中的agent-example项目，查看它的README.md文档。该文档翻译为中文如下所示。

AI 驱动的专家系统演示

这个应用展示了如何使用 Spring AI Alibaba 构建一个 AI 驱动的系统，它可以：

  • 访问条款和条件（检索增强生成，RAG）
  • 访问工具（Java 方法）来执行操作（函数调用）
  • 使用 LLM 与用户交互

要求

  • Java 17+
  • Dashscope API 密钥，设置在 AI_DASHSCOPE_API_KEY 环境变量中

运行

通过在 IDE 中运行 Application.java 或在命令行中运行 mvn spring-boot:run 来运行此应用。

将 Spring AI Alibaba boot starter 添加到 POM 文件中：

<dependency>
   <groupId>org.springframework.ai</groupId>
   <artifactId>spring-ai-alibaba-starter</artifactId>
   <version>1.0.0-M6.1</version>
</dependency>

将 DashScope 配置添加到 application.properties 文件中：

spring.ai.dashscope.api-key=${AI_DASHSCOPE_API_KEY}
spring.ai.dashscope.chat.options.model=qwen-max

构建 Jar 包

./mvnw clean package

java -jar ./target/playground-flight-booking-example-0.0.1-SNAPSHOT.jar

构建前端 (按需)

运行以下命令来构建前端，仅当您修改了前端代码时才需要这样做。

mvn clean compile -Pbuild-frontend

按照说明文档，我使用了JDK21运行。接下来需要在环境变量中配置API密钥。

按照文档说明，我们前往阿里云百炼平台创建API-KEY。

按照说明，登录阿里云百炼大模型服务平台。

开通百炼的模型服务。

前往API-KEY页面，单击创建我的API-KEY。在已创建的API Key操作列，单击查看，获取API KEY。接下来将其配置到环境变量。

A:\study\javaee\Spring AI\spring-ai-alibaba-examples>setx AI_DASHSCOPE_API_KEY "sk-0d75f71279834fad88807898587dc060"

成功: 指定的值已得到保存。

A:\study\javaee\Spring AI\spring-ai-alibaba-examples>

在命令行通过setx AI_DASHSCOPE_API_KEY "YOUR_AI_DASHSCOPE_API_KEY"命令设置永久环境变量，用于存储模型的API密钥。

A:\study\javaee\Spring AI\spring-ai-alibaba-examples>echo %AI_DASHSCOPE_API_KEY%
sk-0d75f71279834fad88807898587dc060

A:\study\javaee\Spring AI\spring-ai-alibaba-examples>

在新的CMD窗口运行echo %AI_DASHSCOPE_API_KEY%命令，检查环境变量是否生效。

或通过高级系统设置 AI_DASHSCOPE_API_KEY 环境变量。

该示例项目中，spring-ai-alibaba-starter依赖已在pom文件中配置，DashScope 配置也已添加到 application.properties 文件中。因此接下来启动Application.java即可。启动之前，需要重启IDEA，使其能够加载最新的环境变量。

启动Application.java，如图所示。

打开http://localhost:9000/，在左侧对话界面尝试发送消息，成功和AI客服进行了对话。

avatar
文章
阅读
粉丝