codebase/spring-ai-agent-skills [BAEL-9646]

spring-ai-modules/pom.xml

@@ -20,6 +20,7 @@
         <module>spring-ai-2</module>
         <module>spring-ai-3</module>
         <module>spring-ai-4</module>
+        <module>spring-ai-agent-skills</module>
         <module>spring-ai-agentic-patterns</module>
         <module>spring-ai-anthropic-agent-skills</module>
         <module>spring-ai-chat-stream</module>

spring-ai-modules/spring-ai-agent-skills/.openai/skills/article-summarizer/SKILL.md

@@ -0,0 +1,10 @@
+---
+name: article-summarizer
+description: Summarizes articles into concise digests. Useful when user asks to summarize or get key points from an article.
+---
+# Article Summarizer
+## Instructions
+When summarizing an article:
+1. If given a URL: Run `uv run scripts/fetch_article.py <url>` to retrieve the content.
+2. Once content is available, extract the main thesis, few key points, and conclusion.
+3. Structure the output as a TL;DR, key points, and a bottom line.

spring-ai-modules/spring-ai-agent-skills/pom.xml

@@ -0,0 +1,68 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <parent>
+        <groupId>com.baeldung</groupId>
+        <artifactId>spring-ai-modules</artifactId>
+        <version>0.0.1</version>
+        <relativePath>../pom.xml</relativePath>
+    </parent>
+
+    <groupId>com.baeldung</groupId>
+    <artifactId>spring-ai-agent-skills</artifactId>
+    <version>0.0.1</version>
+    <name>spring-ai-agent-skills</name>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-webmvc</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.ai</groupId>
+            <artifactId>spring-ai-starter-model-openai</artifactId>
+            <version>${spring-ai.version}</version>
+        </dependency>
+        <dependency>
+            <groupId>org.springaicommunity</groupId>
+            <artifactId>spring-ai-agent-utils</artifactId>
+            <version>${spring-ai-agent-utils.version}</version>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-webmvc-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+    <properties>
+        <java.version>21</java.version>
+        <spring-boot.version>4.0.6</spring-boot.version>
+        <spring-ai.version>2.0.0-M6</spring-ai.version>
+        <spring-ai-agent-utils.version>0.7.0</spring-ai-agent-utils.version>
+    </properties>
+
+    <repositories>
+        <repository>
+            <id>spring-milestones</id>
+            <name>Spring Milestones</name>
+            <url>https://repo.spring.io/milestone</url>
+            <snapshots>
+                <enabled>false</enabled>
+            </snapshots>
+        </repository>
+    </repositories>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+
+</project>

spring-ai-modules/spring-ai-agent-skills/src/main/java/com/baeldung/agentskills/Application.java

@@ -0,0 +1,13 @@
+package com.baeldung.agentskills;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+class Application {
+
+    public static void main(String[] args) {
+        SpringApplication.run(Application.class, args);
+    }
+
+}

spring-ai-modules/spring-ai-agent-skills/src/main/java/com/baeldung/agentskills/ChatbotConfiguration.java

@@ -0,0 +1,26 @@
+package com.baeldung.agentskills;
+
+import org.springaicommunity.agent.tools.FileSystemTools;
+import org.springaicommunity.agent.tools.ShellTools;
+import org.springaicommunity.agent.tools.SkillsTool;
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.ai.chat.model.ChatModel;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+class ChatbotConfiguration {
+
+    @Bean
+    ChatClient chatClient(ChatModel chatModel) {
+        return ChatClient
+            .builder(chatModel)
+            .defaultToolCallbacks(SkillsTool.builder()
+                .addSkillsDirectory(".openai/skills")
+                .build())
+            .defaultTools(FileSystemTools.builder().build())
+            .defaultTools(ShellTools.builder().build())
+            .build();
+    }
+
+}

spring-ai-modules/spring-ai-agent-skills/src/main/java/com/baeldung/agentskills/ChatbotController.java

@@ -0,0 +1,34 @@
+package com.baeldung.agentskills;
+
+import org.springframework.ai.chat.client.ChatClient;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+class ChatbotController {
+
+    private final ChatClient chatClient;
+
+    ChatbotController(ChatClient chatClient) {
+        this.chatClient = chatClient;
+    }
+
+    @PostMapping("/chat")
+    ResponseEntity<ChatResponse> chat(@RequestBody ChatRequest chatRequest) {
+        String answer = chatClient
+            .prompt()
+            .user(chatRequest.question)
+            .call()
+            .content();
+        return ResponseEntity.ok(new ChatResponse(answer));
+    }
+
+    record ChatRequest(String question) {
+    }
+
+    record ChatResponse(String answer) {
+    }
+
+}

spring-ai-modules/spring-ai-agent-skills/src/main/resources/application.yaml

@@ -0,0 +1,7 @@
+spring:
+  ai:
+    openai:
+      api-key: ${OPENAI_API_KEY}
+      chat:
+        options:
+          model: gpt-5.5

spring-ai-modules/spring-ai-agent-skills/src/test/java/com/baeldung/agentskills/AgentSkillLiveTest.java

@@ -0,0 +1,54 @@
+package com.baeldung.agentskills;
+
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfEnvironmentVariable;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.test.context.SpringBootTest;
+import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc;
+import org.springframework.http.MediaType;
+import org.springframework.test.web.servlet.MockMvc;
+import org.springframework.test.web.servlet.MvcResult;
+
+import static org.assertj.core.api.AssertionsForClassTypes.assertThat;
+import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
+import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
+
+@SpringBootTest
+@AutoConfigureMockMvc
+@EnabledIfEnvironmentVariable(named = "OPENAI_API_KEY", matches = ".*")
+class AgentSkillLiveTest {
+
+    private static final String API_PATH = "/chat";
+    private static final String REQUEST_BODY_TEMPLATE = """
+        {
+            "question": "%s"
+        }
+        """;
+
+    @Autowired
+    private MockMvc mockMvc;
+
+    @Test
+    void whenArticleSummaryRequested_thenResponseContainsExpectedSections() throws Exception {
+        String requestBody = REQUEST_BODY_TEMPLATE.formatted(
+            "Can you summarize the following article: https://www.baeldung.com/sample-non-existing-article"
+        );
+
+        MvcResult result = mockMvc
+            .perform(post(API_PATH)
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(requestBody)
+            )
+            .andExpect(status().isOk())
+            .andReturn();
+
+        String response = result
+            .getResponse()
+            .getContentAsString()
+            .toLowerCase();
+
+        assertThat(response)
+            .contains("tl;dr", "key points", "bottom line");
+    }
+
+}