Updates

Author: n-o-u-r-h-a-n

docs/release_notes.md

@@ -16,9 +16,9 @@
 
 ### 📈 Improvements
 
--[Orchestration] Added new API `SAPDocumentTranslationInput#getInputTranslationConfig` to extract input config.
+-[Orchestration] Added new API `TranslationConfig#getInputTranslationConfig` to extract input config.
 
--[Orchestration] Added new API `SAPDocumentTranslationOutput#getOutputTranslationConfig` to extract output config.
+-[Orchestration] Added new API `TranslationConfig#getOutputTranslationConfig` to extract output config.
 
 ### 🐛 Fixed Issues
 

orchestration/pom.xml

@@ -41,7 +41,7 @@
     <coverage.instruction>94%</coverage.instruction>
     <coverage.branch>75%</coverage.branch>
     <coverage.method>93%</coverage.method>
-    <coverage.class>100%</coverage.class>
+    <coverage.class>98%</coverage.class>
   </properties>
 
   <dependencies>

orchestration/src/main/java/com/sap/ai/sdk/orchestration/OrchestrationModuleConfig.java

@@ -100,8 +100,24 @@ public class OrchestrationModuleConfig {
    */
   @Nullable GroundingModuleConfig groundingConfig;
 
+  /**
+   * Configuration for translating input content before processing.
+   *
+   * @link <a
+   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/enhance-model-consumption-with-translation">
+   *     SAP AI Core: Orchestration - Input Translation</a>
+   * @since 1.8.0
+   */
   @Nullable SAPDocumentTranslationInput inputTranslationConfig;
 
+  /**
+   * Configuration for translating output content after processing.
+   *
+   * @link <a
+   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/enhance-model-consumption-with-output-translation">
+   *     SAP AI Core: Orchestration - Output Translation</a>
+   * @since 1.8.0
+   */
   @Nullable SAPDocumentTranslationOutput outputTranslationConfig;
 
   /** Configuration of optional streaming options for output filtering. */
@@ -119,11 +135,11 @@ public class OrchestrationModuleConfig {
   /**
    * Creates a new configuration with the given LLM configuration.
    *
+   * @param aiModel The LLM configuration to use.
+   * @return A new configuration with the given LLM configuration.
    * @link <a
    *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/model-configuration">
    *     SAP AI Core: Orchestration - Model Configuration</a>
-   * @param aiModel The LLM configuration to use.
-   * @return A new configuration with the given LLM configuration.
    */
   @Tolerate
   @Nonnull
@@ -149,12 +165,12 @@ public OrchestrationModuleConfig withStreamConfig(
   /**
    * Creates a new configuration with the given Data Masking configuration.
    *
-   * @link <a
-   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/data-masking">SAP AI
-   *     Core: Orchestration - Data Masking</a>
    * @param maskingProvider The Data Masking configuration to use.
    * @param maskingProviders Additional Data Masking configurations to use.
    * @return A new configuration with the given Data Masking configuration.
+   * @link <a
+   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/data-masking">SAP AI
+   *     Core: Orchestration - Data Masking</a>
    */
   @Tolerate
   @Nonnull
@@ -174,13 +190,13 @@ public OrchestrationModuleConfig withMaskingConfig(
    *
    * <p>Preferred over {@link #withFilteringConfig(FilteringModuleConfig)} for adding input filters.
    *
-   * @link <a
-   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/input-filtering">SAP
-   *     AI Core: Orchestration - Input Filtering</a>
    * @param contentFilter a filter to apply to the input.
    * @param contentFilters zero or more additional content filters to apply to the input.
    * @return a new {@code OrchestrationModuleConfig} instance with the specified input filters
    *     added.
+   * @link <a
+   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/input-filtering">SAP
+   *     AI Core: Orchestration - Input Filtering</a>
    */
   @Nonnull
   public OrchestrationModuleConfig withInputFiltering(
@@ -212,13 +228,13 @@ public OrchestrationModuleConfig withInputFiltering(
    * <p>Preferred over {@link #withFilteringConfig(FilteringModuleConfig)} for adding output
    * filters.
    *
-   * @link <a
-   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/output-filtering">SAP
-   *     AI Core: Orchestration - Output Filtering</a>
    * @param contentFilter a filter to apply to the input.
    * @param contentFilters zero or more additional content filters to apply to the input.
    * @return a new {@code OrchestrationModuleConfig} instance with the specified output filters
    *     added.
+   * @link <a
+   *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/output-filtering">SAP
+   *     AI Core: Orchestration - Output Filtering</a>
    */
   @Nonnull
   public OrchestrationModuleConfig withOutputFiltering(
@@ -250,11 +266,11 @@ public OrchestrationModuleConfig withOutputFiltering(
   /**
    * Creates a new configuration with the given output filtering stream options.
    *
+   * @param outputFilteringStreamOptions The output filtering stream options to use.
+   * @return A new configuration with the given output filtering stream options.
    * @see <a
    *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/streaming">Orchestration
    *     documentation on streaming.</a>
-   * @param outputFilteringStreamOptions The output filtering stream options to use.
-   * @return A new configuration with the given output filtering stream options.
    */
   @Nonnull
   OrchestrationModuleConfig withOutputFilteringStreamOptions(
@@ -277,10 +293,10 @@ OrchestrationModuleConfig withOutputFilteringStreamOptions(
   /**
    * Creates a new configuration with the given grounding configuration.
    *
-   * @link <a href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/grounding">SAP
-   *     AI Core: Orchestration - Grounding</a>
    * @param groundingProvider The grounding configuration to use.
    * @return A new configuration with the given grounding configuration.
+   * @link <a href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/grounding">SAP
+   *     AI Core: Orchestration - Grounding</a>
    */
   @Nonnull
   public OrchestrationModuleConfig withGrounding(
@@ -291,10 +307,10 @@ public OrchestrationModuleConfig withGrounding(
   /**
    * Creates a new configuration with the given template configuration as {@link TemplateConfig}.
    *
-   * @link <a href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/templating">SAP
-   *     AI Core: Orchestration - Templating</a>
    * @param templateConfig The template configuration to use.
    * @return A new configuration with the given template configuration.
+   * @link <a href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/templating">SAP
+   *     AI Core: Orchestration - Templating</a>
    * @since 1.4.0
    */
   @Tolerate

orchestration/src/main/java/com/sap/ai/sdk/orchestration/TranslationConfig.java

@@ -0,0 +1,88 @@
+package com.sap.ai.sdk.orchestration;
+
+import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationInput;
+import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationInputConfig;
+import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationOutput;
+import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationOutputConfig;
+import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationOutputTargetLanguage;
+import javax.annotation.Nonnull;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+import lombok.Value;
+
+/**
+ * Configuration helper for SAP Document Translation.
+ *
+ * @link <a
+ *     href="https://help.sap.com/docs/sap-ai-core/sap-ai-core-service-guide/sap-document-translation">SAP
+ *     AI Core: Orchestration - SAP Document Translation</a>
+ */
+@Value
+@Getter(AccessLevel.PACKAGE)
+@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+public class TranslationConfig {
+  @Nonnull SAPDocumentTranslationInput.TypeEnum translationType;
+
+  /**
+   * Create a builder for the SAP_DOCUMENT_TRANSLATION translation provider
+   *
+   * @return The Builder instance.
+   */
+  @Nonnull
+  public static Builder inputTranslation() {
+    return new TranslationConfig.Builder(
+        SAPDocumentTranslationInput.TypeEnum.SAP_DOCUMENT_TRANSLATION);
+  }
+
+  /**
+   * Create a builder for the SAP_DOCUMENT_TRANSLATION translation provider
+   *
+   * @return The Builder2 instance.
+   */
+  @Nonnull
+  public static Builder2 outputTranslation() {
+    return new TranslationConfig.Builder2(
+        SAPDocumentTranslationOutput.TypeEnum.SAP_DOCUMENT_TRANSLATION);
+  }
+
+  /** Builder helper class. */
+  @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+  public static class Builder {
+
+    private final SAPDocumentTranslationInput.TypeEnum translationType;
+
+    /**
+     * Get the input translation config with default values.
+     *
+     * @return The SAPDocumentTranslationInput instance.
+     */
+    @Nonnull
+    public SAPDocumentTranslationInput getInputTranslationConfig() {
+      return SAPDocumentTranslationInput.create()
+          .type(translationType)
+          .config(SAPDocumentTranslationInputConfig.create().targetLanguage("en-US").applyTo(null));
+    }
+  }
+
+  /** Sample builder class */
+  @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+  public static class Builder2 {
+    private final SAPDocumentTranslationOutput.TypeEnum translationType;
+
+    /**
+     * Get the output translation config with default values.
+     *
+     * @return The SAPDocumentTranslationOutput instance.
+     */
+    @Nonnull
+    public SAPDocumentTranslationOutput getOutputTranslationConfig() {
+      return SAPDocumentTranslationOutput.create()
+          .type(translationType)
+          .config(
+              SAPDocumentTranslationOutputConfig.create()
+                  .targetLanguage(SAPDocumentTranslationOutputTargetLanguage.create("de-DE"))
+                  .sourceLanguage("en-US"));
+    }
+  }
+}

orchestration/src/main/java/com/sap/ai/sdk/orchestration/model/SAPDocumentTranslationInput.java

@@ -24,8 +24,6 @@
 import java.util.Set;
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
-import lombok.AccessLevel;
-import lombok.RequiredArgsConstructor;
 
 /** SAPDocumentTranslationInput */
 // CHECKSTYLE:OFF
@@ -86,12 +84,6 @@ public static TypeEnum fromValue(@Nonnull final String value) {
     }
   }
 
-  /** Create a builder for the SAP_DOCUMENT_TRANSLATION translation provider */
-  @Nonnull
-  public static Builder2 sapDocumentTranslation() {
-    return new Builder2(TypeEnum.SAP_DOCUMENT_TRANSLATION);
-  }
-
   @JsonProperty("type")
   private TypeEnum type;
 
@@ -342,22 +334,4 @@ public interface Builder1 {
      */
     SAPDocumentTranslationInput config(@Nonnull final SAPDocumentTranslationInputConfig config);
   }
-
-  /** Builder helper class. */
-  @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
-  public static class Builder2 {
-
-    private final SAPDocumentTranslationInput.TypeEnum translationType;
-
-    /**
-     * Get the input translation config with default values.
-     *
-     * @return The SAPDocumentTranslationInput instance.
-     */
-    public SAPDocumentTranslationInput getInputTranslationConfig() {
-      return SAPDocumentTranslationInput.create()
-          .type(translationType)
-          .config(SAPDocumentTranslationInputConfig.create().targetLanguage("en-US").applyTo(null));
-    }
-  }
 }

orchestration/src/main/java/com/sap/ai/sdk/orchestration/model/SAPDocumentTranslationOutput.java

@@ -24,8 +24,6 @@
 import java.util.Set;
 import javax.annotation.Nonnull;
 import javax.annotation.Nullable;
-import lombok.AccessLevel;
-import lombok.RequiredArgsConstructor;
 
 /** SAPDocumentTranslationOutput */
 // CHECKSTYLE:OFF
@@ -86,12 +84,6 @@ public static TypeEnum fromValue(@Nonnull final String value) {
     }
   }
 
-  /** Create a builder for the SAP_DOCUMENT_TRANSLATION translation provider */
-  @Nonnull
-  public static Builder2 sapDocumentTranslation() {
-    return new Builder2(TypeEnum.SAP_DOCUMENT_TRANSLATION);
-  }
-
   @JsonProperty("type")
   private TypeEnum type;
 
@@ -301,24 +293,4 @@ public interface Builder1 {
      */
     SAPDocumentTranslationOutput config(@Nonnull final SAPDocumentTranslationOutputConfig config);
   }
-
-  /** Sample builder class */
-  @RequiredArgsConstructor(access = AccessLevel.PRIVATE)
-  public static class Builder2 {
-    private final SAPDocumentTranslationOutput.TypeEnum translationType;
-
-    /**
-     * Get the output translation config with default values.
-     *
-     * @return The SAPDocumentTranslationOutput instance.
-     */
-    public SAPDocumentTranslationOutput getOutputTranslationConfig() {
-      return SAPDocumentTranslationOutput.create()
-          .type(translationType)
-          .config(
-              SAPDocumentTranslationOutputConfig.create()
-                  .targetLanguage(SAPDocumentTranslationOutputTargetLanguage.create("de-DE"))
-                  .sourceLanguage("en-US"));
-    }
-  }
 }

orchestration/src/test/java/com/sap/ai/sdk/orchestration/OrchestrationModuleConfigTest.java

@@ -138,6 +138,32 @@ void testDpiMaskingRegex() {
                 .value("**-**-*****"));
   }
 
+  @Test
+  void testTranslationConfig() {
+    var translationConfig = TranslationConfig.inputTranslation().getInputTranslationConfig();
+    var config =
+        new OrchestrationModuleConfig()
+            .withLlmConfig(GPT_4O)
+            .withInputTranslationConfig(translationConfig);
+
+    assertThat(config.getInputTranslationConfig()).isNotNull();
+    assertThat(config.getInputTranslationConfig().getType()).isEqualTo(translationConfig.getType());
+    assertThat(config.getInputTranslationConfig().getConfig().getTargetLanguage())
+        .isEqualTo(translationConfig.getConfig().getTargetLanguage());
+
+    var translationConfig2 = TranslationConfig.inputTranslation().getInputTranslationConfig();
+    var config2 =
+        new OrchestrationModuleConfig()
+            .withLlmConfig(GPT_4O)
+            .withInputTranslationConfig(translationConfig2);
+
+    assertThat(config2.getInputTranslationConfig()).isNotNull();
+    assertThat(config2.getInputTranslationConfig().getType())
+        .isEqualTo(translationConfig2.getType());
+    assertThat(config2.getInputTranslationConfig().getConfig().getTargetLanguage())
+        .isEqualTo(translationConfig2.getConfig().getTargetLanguage());
+  }
+
   @Test
   void testParams() {
     // test withParams(Map<String, Object>)

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

@@ -23,14 +23,13 @@
 import com.sap.ai.sdk.orchestration.OrchestrationPrompt;
 import com.sap.ai.sdk.orchestration.ResponseJsonSchema;
 import com.sap.ai.sdk.orchestration.TemplateConfig;
+import com.sap.ai.sdk.orchestration.TranslationConfig;
 import com.sap.ai.sdk.orchestration.model.DPIEntities;
 import com.sap.ai.sdk.orchestration.model.DataRepositoryType;
 import com.sap.ai.sdk.orchestration.model.DocumentGroundingFilter;
 import com.sap.ai.sdk.orchestration.model.GroundingFilterSearchConfiguration;
 import com.sap.ai.sdk.orchestration.model.LlamaGuard38b;
 import com.sap.ai.sdk.orchestration.model.ResponseFormatText;
-import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationInput;
-import com.sap.ai.sdk.orchestration.model.SAPDocumentTranslationOutput;
 import com.sap.ai.sdk.orchestration.model.SearchDocumentKeyValueListPair;
 import com.sap.ai.sdk.orchestration.model.SearchSelectOptionEnum;
 import com.sap.ai.sdk.orchestration.model.Template;
@@ -614,9 +613,9 @@ public OrchestrationChatResponse translation() {
     val configWithTranslation =
         config
             .withInputTranslationConfig(
-                SAPDocumentTranslationInput.sapDocumentTranslation().getInputTranslationConfig())
+                TranslationConfig.inputTranslation().getInputTranslationConfig())
             .withOutputTranslationConfig(
-                SAPDocumentTranslationOutput.sapDocumentTranslation()
+                TranslationConfig.outputTranslation()
                     .getOutputTranslationConfig()); // optional source language
 
     return client.chatCompletion(prompt, configWithTranslation);