Bael 9419 spring ai agentic patterns (#18804)

* [BAEL-9419] Introduce module for spring ai agentic patterns

* [BAEL-9419] Introduce the chain-workflow pattern

* [BAEL-9419] Introduce the parallelization-workflow pattern

* [BAEL-9419] Introduce the routing-workflow pattern

* [BAEL-9419] Introduce the orchestrator-workers-workflow pattern

* [BAEL-9419] Introduce the evaluator-optimizer-workflow pattern

Author: bpstelios10

spring-ai-modules/pom.xml

@@ -22,6 +22,6 @@
         <module>spring-ai-multiple-llms</module>
         <module>spring-ai-text-to-sql</module>
         <module>spring-ai-vector-stores</module>
+        <module>spring-ai-agentic-patterns</module>
     </modules>
-
-</project>
+</project>

spring-ai-modules/spring-ai-agentic-patterns/pom.xml

@@ -0,0 +1,62 @@
+<?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>
+
+    <artifactId>spring-ai-agentic-patterns</artifactId>
+    <name>spring-ai-agentic-patterns</name>
+
+    <dependencies>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.ai</groupId>
+            <artifactId>spring-ai-model</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>org.springframework.ai</groupId>
+            <artifactId>spring-ai-client-chat</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.ai</groupId>
+                <artifactId>spring-ai-bom</artifactId>
+                <version>${spring-ai.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
+    <properties>
+        <java.version>21</java.version>
+        <spring-ai.version>1.0.2</spring-ai.version>
+        <spring-boot.version>3.5.5</spring-boot.version>
+    </properties>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.springframework.boot</groupId>
+                <artifactId>spring-boot-maven-plugin</artifactId>
+            </plugin>
+        </plugins>
+    </build>
+</project>

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/Application.java

@@ -0,0 +1,12 @@
+package com.baeldung.springai.agenticpatterns;
+
+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-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/CodeReviewClient.java

@@ -0,0 +1,6 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.client.ChatClient;
+
+public interface CodeReviewClient extends ChatClient {
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/CodeReviewClientPrompts.java

@@ -0,0 +1,32 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+public final class CodeReviewClientPrompts {
+
+    private CodeReviewClientPrompts() {
+    }
+
+    /**
+     * Prompt for the code review of a given PR
+     */
+    public static final String CODE_REVIEW_PROMPT = """
+      Given a PR link -> generate a map with proposed code improvements.
+      The key should be {class-name}:{line-number}:{short-description}.
+      The value should be the code in one line. For example, 1 proposed improvement could be for the line 'int x = 0, y = 0;':
+      {"Client:23:'no multiple variables defined in 1 line'", "int x = 0;\\n int y = 0;"}
+      Rules are, to follow the checkstyle and spotless rules set to the repo. Keep java code clear, readable and extensible.
+      
+      Finally, if it is not your first attempt, there might feedback provided to you, including your previous suggestion.
+      You should reflect on it and improve the previous suggestions, or even add more.""";
+
+    /**
+     * Prompt for the evaluation of the result
+     */
+    public static final String EVALUATE_PROPOSED_IMPROVEMENTS_PROMPT = """
+      Evaluate the suggested code improvements for correctness, time complexity, and best practices.
+      
+      Return a Map with one entry. The key is the value the evaluation. The value will be your feedback.
+      
+      The evaluation field must be one of: "PASS", "NEEDS_IMPROVEMENT", "FAIL"
+      Use "PASS" only if all criteria are met with no improvements needed.
+      """;
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/DummyCodeReviewClient.java

@@ -0,0 +1,33 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.prompt.Prompt;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+
+@Component
+public class DummyCodeReviewClient implements CodeReviewClient {
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull String input) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull Prompt prompt) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public Builder mutate() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/DummyOpsClient.java

@@ -0,0 +1,33 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.prompt.Prompt;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+
+@Component
+public class DummyOpsClient implements OpsClient {
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull String input) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull Prompt prompt) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public Builder mutate() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/DummyOpsOrchestratorClient.java

@@ -0,0 +1,33 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.prompt.Prompt;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+
+@Component
+public class DummyOpsOrchestratorClient implements OpsOrchestratorClient {
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull String request) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull Prompt prompt) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public Builder mutate() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/DummyOpsRouterClient.java

@@ -0,0 +1,33 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.prompt.Prompt;
+import org.springframework.lang.NonNull;
+import org.springframework.stereotype.Component;
+
+@Component
+public class DummyOpsRouterClient implements OpsRouterClient {
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull String request) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public ChatClientRequestSpec prompt(@NonNull Prompt prompt) {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+
+    @Override
+    @NonNull
+    public Builder mutate() {
+        throw new UnsupportedOperationException("Not supported yet.");
+    }
+}

spring-ai-modules/spring-ai-agentic-patterns/src/main/java/com/baeldung/springai/agenticpatterns/aimodels/OpsClient.java

@@ -0,0 +1,6 @@
+package com.baeldung.springai.agenticpatterns.aimodels;
+
+import org.springframework.ai.chat.client.ChatClient;
+
+public interface OpsClient extends ChatClient {
+}