docs: document RptInferenceClient as intentional public API

.github/actions/scan-with-sonar/action.yml

@@ -69,7 +69,7 @@ runs:
         mvn org.sonarsource.scanner.maven:sonar-maven-plugin:sonar
         -Dsonar.host.url=https://sonar.tools.sap
         -Dsonar.token="${SONAR_TOKEN}"
-        -Dsonar.projectKey=cds-ai
+        -Dsonar.projectKey=com.sap.cds.cds-ai
         -Dsonar.projectVersion=${{ steps.get-revision.outputs.REVISION }}
         -Dsonar.qualitygate.wait=true
         -Dsonar.java.source=17

cds-feature-recommendations/src/main/java/com/sap/cds/feature/recommendation/RptInferenceClient.java

@@ -22,6 +22,22 @@
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+/**
+ * Client for invoking the SAP RPT-1 foundation model for tabular predictions. This class is part of
+ * the public API and can be used directly by applications that need to perform custom inference
+ * outside the automatic Fiori recommendation flow.
+ *
+ * <p>Example usage:
+ *
+ * <pre>{@code
+ * AICoreService service = ...;
+ * String rg = service.resourceGroupForTenant(tenantId);
+ * String deploymentId = service.deploymentId(rg, RptModelSpec.rpt1());
+ * RptInferenceClient client =
+ *     new RptInferenceClient(service.inferenceClient(rg, deploymentId), service.getRetry());
+ * List<CdsData> predictions = client.predict(rows, List.of("targetColumn"), "ID");
+ * }</pre>
+ */
 public class RptInferenceClient implements RecommendationClient {
 
   private static final Logger logger = LoggerFactory.getLogger(RptInferenceClient.class);