Spring AI, AI mühendisliği için Spring’in taşınabilirlik ve modüler tasarım ilkelerini AI iş yüklerine uygulayan bir çerçevedir. Tanıdık Spring kalıpları ve POJO’ları kullanarak AI odaklı uygulamalar geliştirmenizi sağlar.
Spring AI, AI mühendisliği için Spring’in taşınabilirlik ve modüler tasarım ilkelerini AI iş yüklerine uygulayan bir çerçevedir. Tanıdık Spring kalıpları ve POJO’ları kullanarak AI odaklı uygulamalar geliştirmenizi sağlar.
Bu bölümde Neden Spring AI Kullanılmalı? konusunu netleştirip uygulamada kullanacağınız temel noktaları özetliyoruz.
Aşağıdakilere sahip olduğunuzdan emin olun:
OPENAI_API_KEY olarak tanımlı)Spring AI OpenAI başlatıcısı, Spring Web ve Lombok’u projenize ekleyin.
application.yml dosyanıza OpenAI anahtarınızı ve ChatClient model ayarlarını ekleyin:
spring: ai: openai: api-key: ${OPENAI_API_KEY} chat: options: model: gpt-4.1-mini
ChatClient.Builder ile ChatClient’i oluşturup sarmalayan bir AIService sınıfı yazın.
AIService’i HTTP üzerinden sunmak için bir ChatController sınıfı oluşturun.
Spring Boot uygulamanızı başlatın:
./mvnw spring-boot:run # veya gradle bootRun
HTTP üzerinden servisinizi çağırın:
curl -X GET "http://localhost:8080/joke?topic=dogs" # AI modelinin döndürdüğü köpek şakası
Artık Spring Boot AI Entegrasyonu için üretim odaklı bir Spring Boot temeliniz var. Sonraki adımda ayarları kendi domainine uyarlayıp test ve gözlemlenebilirlik katmanını ekleyerek gerçek trafik altında doğrulayın.
<dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <dependency> <groupId>org.springframework.ai</groupId> <artifactId>spring-ai-starter-model-openai</artifactId> </dependency> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <scope>provided</scope> </dependency> </dependencies>
plugins { id 'org.springframework.boot' version '3.2.0' } dependencies { implementation 'org.springframework.boot:spring-boot-starter-web' implementation 'org.springframework.ai:spring-ai-starter-model-openai' compileOnly 'org.projectlombok:lombok' annotationProcessor 'org.projectlombok:lombok' }
package com.example.ai.service; import org.springframework.ai.chat.client.ChatClient; import org.springframework.stereotype.Service; @Service public class AIService { private final ChatClient chatClient; public AIService(ChatClient.Builder builder) { this.chatClient = builder.build(); } public String getJoke(String topic) { return chatClient.prompt() .user(u -> u.text("Tell me a joke about {topic}").param("topic", topic)) .call() .content(); } }
package com.example.ai.service import org.springframework.ai.chat.client.ChatClient import org.springframework.stereotype.Service @Service class AIService(builder: ChatClient.Builder) { private val chatClient: ChatClient = builder.build() fun getJoke(topic: String): String = chatClient.prompt() .user { it.text("Tell me a joke about {topic}").param("topic", topic) } .call() .content()
package com.example.ai.controller; import com.example.ai.service.AIService; 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 AIService aiService; public ChatController(AIService aiService) { this.aiService = aiService; } @GetMapping("/joke") public String getJoke(@RequestParam(defaultValue = "dogs") String topic) { return aiService.getJoke(topic); } }
package com.example.ai.controller import com.example.ai.service.AIService import org.springframework.web.bind.annotation.GetMapping import org.springframework.web.bind.annotation.RequestParam import org.springframework.web.bind.annotation.RestController @RestController class ChatController(private val aiService: AIService) { @GetMapping("/joke") fun getJoke(@RequestParam(defaultValue = "dogs") topic: String): String = aiService.getJoke(topic)