chore: [Orchestration] Clarify response format (#637)

Author: CharlesDuboisSAP

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

@@ -33,6 +33,11 @@ public class ResponseJsonSchema {
   @Nonnull Map<String, Object> schemaMap;
   @Nonnull String name;
   @Nullable String description;
+
+  /**
+   * ⚠️ Fields of the schema class should be annotated with {@code @JsonProperty(required = true)}
+   * to not fail requests if set to true.
+   */
   @Nullable Boolean strict;
 
   /**
@@ -51,6 +56,9 @@ public static ResponseJsonSchema fromMap(
   /**
    * Create a new instance of {@link ResponseJsonSchema} from a given class.
    *
+   * <p>⚠️ Fields of the schema class should be annotated with {@code @JsonProperty(required =
+   * true)}.
+   *
    * @param classType The class to generate the schema from
    * @return The new instance of {@link ResponseJsonSchema}
    */