Minor tweaks

Author: MatKuhr

docs/guides/ORCHESTRATION_CHAT_COMPLETION.md

@@ -103,16 +103,18 @@ The LLM response is available as the first choice under the `result.getOrchestra
 Use a prepared template and execute requests with by passing only the input parameters:
 
 ```java
-var template = ChatMessage.create().role("user").content("{{?input}}");
+var template = ChatMessage.create().role("user").content("Reply with 'Orchestration Service is working!' in {{?language}}");
 var templatingConfig = TemplatingModuleConfig.create().template(template);
+var configWithTemplate = config.withTemplateConfig(templatingConfig);
 
-var inputParams =
-    Map.of("input", "Reply with 'Orchestration Service is working!' in German");
+var inputParams = Map.of("language", "German");
 var prompt = new OrchestrationPrompt(inputParams);
 
-var result = client.chatCompletion(prompt, config.withTemplateConfig(templatingConfig));
+var result = client.chatCompletion(prompt, configWithTemplate);
 ```
 
+In this case the template is defined with the placeholder `{{?language}}` which is replaced by the value `German` in the input parameters.
+
 ### Message history
 
 Include a message history to maintain context in the conversation:
@@ -168,9 +170,11 @@ var filteringConfig =
         .input(InputFilteringConfig.create().filters(filterStrict))
         .output(OutputFilteringConfig.create().filters(filterStrict));
 
+var configWithFilter = config.withFilteringConfig(filteringConfig);
+
 // this fails with Bad Request because the strict filter prohibits the input message
 var result =
-    new OrchestrationClient().chatCompletion(prompt, config.withFilteringConfig(filteringConfig));
+    new OrchestrationClient().chatCompletion(prompt, configWithFilter);
 ```
 
 ### Data masking
@@ -186,6 +190,7 @@ var maskingProvider =
             DPIEntityConfig.create().type(DPIEntities.PHONE),
             DPIEntityConfig.create().type(DPIEntities.PERSON));
 var maskingConfig = MaskingModuleConfig.create().maskingProviders(maskingProvider);
+var configWithMasking = config.withMaskingConfig(maskingConfig);
 
 var systemMessage = ChatMessage.create()
         .role("system")
@@ -200,7 +205,7 @@ var userMessage = ChatMessage.create()
 var prompt = new OrchestrationPrompt(systemMessage, userMessage);
 
 var result =
-    new OrchestrationClient().chatCompletion(prompt, config.withMaskingConfig(maskingConfig));
+    new OrchestrationClient().chatCompletion(prompt, configWithMasking);
 ```
 
 In this example, the input will be masked before the call to the LLM. Note that data cannot be unmasked in the LLM output.

sample-code/spring-app/src/main/java/com/sap/ai/sdk/app/controllers/OrchestrationController.java

@@ -58,14 +58,14 @@ public CompletionPostResponse completion() {
   @GetMapping("/template")
   @Nonnull
   public CompletionPostResponse template() {
-    final var template = ChatMessage.create().role("user").content("{{?input}}");
+    final var template = ChatMessage.create().role("user").content("Reply with 'Orchestration Service is working!' in {{?language}}");
     final var templatingConfig = TemplatingModuleConfig.create().template(template);
+    final var configWithTemplate = config.withTemplateConfig(templatingConfig);
 
-    final var inputParams =
-        Map.of("input", "Reply with 'Orchestration Service is working!' in German");
-
+    final var inputParams = Map.of("language", "German");
     final var prompt = new OrchestrationPrompt(inputParams);
-    return client.chatCompletion(prompt, config.withTemplateConfig(templatingConfig));
+
+    return client.chatCompletion(prompt, configWithTemplate);
   }
 
   /**
@@ -106,8 +106,9 @@ public CompletionPostResponse filter(
             ```DISCLAIMER: The area surrounding the apartment is known for prostitutes and gang violence including armed conflicts, gun violence is frequent.
             """);
     final var filterConfig = createAzureContentFilter(threshold);
+    final var configWithFilter = config.withFilteringConfig(filterConfig);
 
-    return client.chatCompletion(prompt, config.withFilteringConfig(filterConfig));
+    return client.chatCompletion(prompt, configWithFilter);
   }
 
   /**
@@ -160,8 +161,9 @@ public CompletionPostResponse maskingAnonymization() {
     final var prompt = new OrchestrationPrompt(systemMessage, userMessage);
     final var maskingConfig =
         createMaskingConfig(MaskingProviderConfig.MethodEnum.ANONYMIZATION, DPIEntities.PERSON);
+    final var configWithMasking = config.withMaskingConfig(maskingConfig);
 
-    return client.chatCompletion(prompt, config.withMaskingConfig(maskingConfig));
+    return client.chatCompletion(prompt, configWithMasking);
   }
 
   /**
@@ -200,8 +202,9 @@ public CompletionPostResponse maskingPseudonymization() {
             MaskingProviderConfig.MethodEnum.PSEUDONYMIZATION,
             DPIEntities.PERSON,
             DPIEntities.EMAIL);
+    final var configWithMasking = config.withMaskingConfig(maskingConfig);
 
-    return client.chatCompletion(prompt, config.withMaskingConfig(maskingConfig));
+    return client.chatCompletion(prompt, configWithMasking);
   }
 
   /**