@jerome-benoit/sap-ai-provider 4.7.0 → 4.8.0

package/README.md

@@ -531,29 +531,15 @@ const dpiConfig = buildDpiMaskingProvider({
 
 ### Content Filtering
 
-```typescript
-import "dotenv/config"; // Load environment variables
-import { buildAzureContentSafetyFilter, createSAPAIProvider } from "@jerome-benoit/sap-ai-provider";
-
-const provider = createSAPAIProvider({
-  defaultSettings: {
-    filtering: {
-      input: {
-        filters: [
-          buildAzureContentSafetyFilter("input", {
-            hate: "ALLOW_SAFE",
-            violence: "ALLOW_SAFE_LOW_MEDIUM",
-          }),
-        ],
-      },
-    },
-  },
-});
-```
+Content filtering is available through the Orchestration API.
 
+**Complete example:**
+[examples/example-content-filtering.ts](./examples/example-content-filtering.ts)\
 **Complete documentation:**
 [API Reference - Content Filtering](./API_REFERENCE.md#buildazurecontentsafetyfiltertype-config)
 
+**Run it:** `npx tsx examples/example-content-filtering.ts`
+
 ### Document Grounding (RAG)
 
 Ground LLM responses in your own documents using vector databases.
@@ -567,24 +553,27 @@ Ground LLM responses in your own documents using vector databases.
 const provider = createSAPAIProvider({
   defaultSettings: {
     grounding: buildDocumentGroundingConfig({
-      filters: [
-        {
-          id: "vector-store-1", // Your vector database ID
-          data_repositories: ["*"], // Search all repositories
-        },
-      ],
-      placeholders: {
-        input: ["?question"],
-        output: "groundingOutput",
-      },
+      filters: [{ id: "vector-store-1", data_repositories: ["*"] }],
+      placeholders: { input: ["groundingRequest"], output: "groundingOutput" },
     }),
   },
 });
 
-// Queries are now grounded in your documents
-const model = provider("gpt-4.1");
+const result = await generateText({
+  model: provider("gpt-4.1"),
+  prompt: "Question: {{?groundingRequest}}\nContext: {{?groundingOutput}}",
+  providerOptions: {
+    "sap-ai": {
+      escapeTemplatePlaceholders: false,
+      placeholderValues: { groundingRequest: "What is SAP?" },
+    },
+  },
+});
 ```
 
+Set `escapeTemplatePlaceholders` to `false` only when intentionally sending SAP
+or Jinja placeholders in prompts or messages.
+
 **Run it:** `npx tsx examples/example-document-grounding.ts`
 
 ### Translation
@@ -659,6 +648,11 @@ authentication, model parameters, data masking, content filtering, and more.
   `providerOptions`/`providerMetadata`.
 - `resourceGroup`: SAP AI Core resource group (default: 'default')
 - `deploymentId`: Specific deployment ID (auto-resolved if not set)
+- `requestConfig`: Custom HTTP request configuration (headers, params, timeout, etc.)
+  forwarded to the underlying SAP AI SDK client on every call. Provider-level scope
+  only; use `requestConfig.headers` for SAP-specific headers such as
+  `AI-Object-Store-Secret-Name` (feedback service). See
+  [API Reference](./API_REFERENCE.md#sapaiprovidersettings) for portability caveats.
 - `modelParams`: Temperature, maxTokens, topP, and other generation parameters
 - `masking`: SAP Data Privacy Integration (DPI) configuration
 - `filtering`: Content safety filters (Azure Content Safety, Llama Guard)
@@ -736,6 +730,7 @@ features:
 | `example-streaming-chat.ts`         | Streaming responses         | Real-time text generation, SSE          |
 | `example-image-recognition.ts`      | Multi-modal with images     | Vision models, image analysis           |
 | `example-data-masking.ts`           | Data privacy integration    | DPI masking, anonymization              |
+| `example-content-filtering.ts`      | Content filtering           | Azure Content Safety, orchestration     |
 | `example-document-grounding.ts`     | Document grounding (RAG)    | Vector store, retrieval-augmented gen   |
 | `example-translation.ts`            | Input/output translation    | Multi-language support, SAP translation |
 | `example-embeddings.ts`             | Text embeddings             | Vector generation, semantic similarity  |