5步掌握Spring AI集成Google Gemini 2.5模型的技术实践

5步掌握Spring AI集成Google Gemini 2.5模型的技术实践

【免费下载链接】spring-aiAn Application Framework for AI Engineering项目地址: https://gitcode.com/GitHub_Trending/spr/spring-ai

Spring AI是一个强大的AI工程应用框架，它为开发者提供了便捷的方式来集成各种AI模型。本文将详细介绍如何通过5个简单步骤，在Spring AI中集成Google Gemini 2.5模型，让你快速上手AI应用开发。

步骤一：准备开发环境与项目初始化

首先，确保你的开发环境满足以下要求：

• JDK 17或更高版本
• Maven 3.6+或Gradle 7.0+
• Google Cloud账号（用于获取API密钥）

通过以下命令克隆项目仓库：

git clone https://gitcode.com/GitHub_Trending/spr/spring-ai

步骤二：添加依赖配置

在你的Spring Boot项目的pom.xml文件中添加Google GenAI模型的依赖：

<dependency> <groupId>org.springframework.ai</groupId> <artifactId>spring-ai-starter-model-google-genai</artifactId> </dependency>

这个依赖会自动引入Google Gemini模型所需的核心类库，包括自动配置类GoogleGenAiChatAutoConfiguration.java，它负责处理与Google Gemini API的连接和配置。

步骤三：配置API密钥与模型参数

在application.properties或application.yml中添加Google Gemini API密钥和相关配置：

# Google Gemini API配置 spring.ai.google.genai.api-key=your_api_key_here spring.ai.model.chat=google-genai spring.ai.google.genai.chat.options.model=gemini-2.5-pro spring.ai.google.genai.chat.options.temperature=0.7

你需要从Google Cloud控制台获取API密钥。配置中的model参数指定使用Gemini 2.5 Pro模型，temperature参数控制生成内容的随机性。

步骤四：创建和使用Gemini聊天模型

创建一个服务类，注入GoogleGenAiChatModel并使用它进行对话：

import org.springframework.ai.google.genai.GoogleGenAiChatModel; import org.springframework.ai.chat.messages.UserMessage; import org.springframework.ai.chat.response.ChatResponse; import org.springframework.stereotype.Service; @Service public class GeminiChatService { private final GoogleGenAiChatModel chatModel; public GeminiChatService(GoogleGenAiChatModel chatModel) { this.chatModel = chatModel; } public String chat(String message) { ChatResponse response = chatModel.call(new UserMessage(message)); return response.getResult().getOutput().getContent(); } }

Spring AI的自动配置机制会根据我们在步骤三中的配置，自动创建GoogleGenAiChatModel的实例并注入到服务类中。

步骤五：测试与优化

创建一个控制器来测试我们的聊天服务：

import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; @RestController public class ChatController { private final GeminiChatService chatService; public ChatController(GeminiChatService chatService) { this.chatService = chatService; } @GetMapping("/chat") public String chat(@RequestParam String message) { return chatService.chat(message); } }

启动应用后，访问http://localhost:8080/chat?message=你好即可与Gemini 2.5模型进行对话。

Spring AI提供了强大的功能调用机制，允许模型根据需要调用外部工具。下图展示了Spring AI中函数调用的基本流程：

此外，Spring AI还提供了统一的嵌入模型API，使你能够轻松地在不同的嵌入模型之间切换：

通过这5个简单步骤，你已经成功地在Spring AI中集成了Google Gemini 2.5模型。现在你可以开始构建更复杂的AI应用，利用Gemini的强大能力为你的项目增添智能功能。

记得定期查看官方文档以获取最新的功能和最佳实践，持续优化你的AI应用性能和用户体验。

【免费下载链接】spring-aiAn Application Framework for AI Engineering项目地址: https://gitcode.com/GitHub_Trending/spr/spring-ai