feat: [Orchestration] Add Test and Sample Code for Response Format with Spring AI (#422)

* Add Test and Sample Code for Response Format with Spring AI

* PMD

Author: MatKuhr

sample-code/spring-app/src/main/java/com/sap/ai/sdk/app/services/OrchestrationService.java

@@ -391,13 +391,9 @@ public OrchestrationChatResponse groundingHelpSapCom(@Nonnull final String userM
   @Nonnull
   public OrchestrationChatResponse responseFormatJsonSchema(@Nonnull final String word) {
     //    Example class
-    class Translation {
-      @JsonProperty(required = true)
-      private String translation;
-
-      @JsonProperty(required = true)
-      private String language;
-    }
+    record Translation(
+        @JsonProperty(required = true) String translation,
+        @JsonProperty(required = true) String language) {}
 
     val schema =
         ResponseJsonSchema.fromType(Translation.class)

sample-code/spring-app/src/main/java/com/sap/ai/sdk/app/services/SpringAiOrchestrationService.java

@@ -3,18 +3,22 @@
 import static com.sap.ai.sdk.orchestration.OrchestrationAiModel.GEMINI_1_5_FLASH;
 import static com.sap.ai.sdk.orchestration.OrchestrationAiModel.GPT_4O_MINI;
 
+import com.fasterxml.jackson.annotation.JsonProperty;
 import com.sap.ai.sdk.orchestration.AzureContentFilter;
 import com.sap.ai.sdk.orchestration.AzureFilterThreshold;
 import com.sap.ai.sdk.orchestration.DpiMasking;
 import com.sap.ai.sdk.orchestration.OrchestrationClientException;
 import com.sap.ai.sdk.orchestration.OrchestrationModuleConfig;
+import com.sap.ai.sdk.orchestration.ResponseJsonSchema;
+import com.sap.ai.sdk.orchestration.TemplateConfig;
 import com.sap.ai.sdk.orchestration.model.DPIEntities;
 import com.sap.ai.sdk.orchestration.spring.OrchestrationChatModel;
 import com.sap.ai.sdk.orchestration.spring.OrchestrationChatOptions;
 import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 import javax.annotation.Nonnull;
+import javax.annotation.Nullable;
 import lombok.val;
 import org.springframework.ai.chat.client.ChatClient;
 import org.springframework.ai.chat.client.advisor.MessageChatMemoryAdvisor;
@@ -159,7 +163,7 @@ public ChatResponse outputFiltering(@Nonnull final AzureFilterThreshold policy)
    */
   @Nonnull
   public ChatResponse toolCalling(final boolean internalToolExecutionEnabled) {
-    final OrchestrationChatOptions options = new OrchestrationChatOptions(config);
+    val options = new OrchestrationChatOptions(config);
     options.setToolCallbacks(List.of(ToolCallbacks.from(new WeatherMethod())));
     options.setInternalToolExecutionEnabled(internalToolExecutionEnabled);
 
@@ -184,4 +188,36 @@ public ChatResponse chatMemory() {
     return Objects.requireNonNull(
         cl.prompt(prompt2).call().chatResponse(), "Chat response is null");
   }
+
+  /**
+   * A simple record to demonstrate the response format feature of the orchestration service.
+   *
+   * @param translation the translated text
+   * @param language the language of the translation
+   */
+  public record Translation(
+      @JsonProperty(required = true) String translation,
+      @JsonProperty(required = true) String language) {}
+
+  /**
+   * Perform a chat completion where the LLM response adheres to a JSON schema. Use a Java record or
+   * class to define the expected format and automatically parse the response into it.
+   *
+   * <p>In this case, we expect a {@code Translation} of the input text into Dutch.
+   *
+   * @return The translated text.
+   */
+  @Nullable
+  public Translation responseFormat() {
+    val cl = ChatClient.builder(new OrchestrationChatModel()).build();
+
+    val schema = ResponseJsonSchema.fromType(Translation.class);
+    val template = TemplateConfig.create().withJsonSchemaResponse(schema);
+
+    val options = new OrchestrationChatOptions(config.withTemplateConfig(template));
+    val prompt =
+        new Prompt("How do I say 'AI is going to revolutionize the world' in dutch?", options);
+
+    return cl.prompt(prompt).call().entity(Translation.class);
+  }
 }

sample-code/spring-app/src/test/java/com/sap/ai/sdk/app/controllers/SpringAiOrchestrationTest.java

@@ -15,7 +15,7 @@
 import org.springframework.ai.chat.model.ChatResponse;
 
 @Slf4j
-public class SpringAiOrchestrationTest {
+class SpringAiOrchestrationTest {
 
   SpringAiOrchestrationService service = new SpringAiOrchestrationService();
 
@@ -160,4 +160,12 @@ void testChatMemory() {
         .containsAnyOf(
             "French", "onion", "pastries", "cheese", "baguette", "coq au vin", "foie gras");
   }
+
+  @Test
+  void testResponseFormat() {
+    var translation = service.responseFormat();
+    assertThat(translation).isNotNull();
+    assertThat(translation.translation()).isNotEmpty();
+    assertThat(translation.language()).containsIgnoringCase("dutch");
+  }
 }