Skip to content

Commit a3be16e

Browse files
committed
Update from SAP DITA CMS (squashed):
commit 502090c145697141444c247315e689e925a30515 Author: REDACTED Date: Fri May 16 12:26:27 2025 +0000 Update from SAP DITA CMS 2025-05-16 12:26:27 Project: dita-all/ayn1620809929290 Project map: 8a3894192639433b9ba1f87efe78bfd1.ditamap Output: loio62559d01add8414eb0c4d76d2d9f48bd Language: en-US Builddable map: 038a6194f65c4ef68885f6f16360dbc4.ditamap commit f78c992fe2c313e2de725f0426b136bef19a92c0 Author: REDACTED Date: Fri May 16 10:05:00 2025 +0000 Update from SAP DITA CMS 2025-05-16 10:05:00 Project: dita-all/ayn1620809929290 Project map: 8a3894192639433b9ba1f87efe78bfd1.ditamap Output: loio62559d01add8414eb0c4d76d2d9f48bd Language: en-US Builddable map: 038a6194f65c4ef68885f6f16360dbc4.ditamap commit 7726d807a8439d9fb67009ce409696a59650375d Author: REDACTED Date: Fri May 16 09:39:47 2025 +0000 Update from SAP DITA CMS 2025-05-16 09:39:47 Project: dita-all/bex1621329160251 Project map: d3e749bbac3d4f728c12228db6629c45.ditamap ################################################## [Remaining squash message was removed before commit...]
1 parent 8c34251 commit a3be16e

30 files changed

+961
-74
lines changed

docs/sap-ai-core/accessing-generative-ai-models-through-global-scenarios-4ca11f6.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ Access to generative AI models falls under the global AI scenarios `foundation-m
2424

2525
- Open Source Framework Support: While we support LangChain, a popular open-source framework, we can't support every framework available. If a specific open-source framework is required, you might need to extend it for support or consider alternative integration methods.
2626

27-
- **[Orchestration](orchestration-cdd4847.md "The orchestration service operates under the global AI scenario
27+
- **[Orchestration](orchestration-8d02235.md "The orchestration service operates under the global AI scenario
2828
orchestration, which is managed by SAP AI Core. This service enables the use of various generative AI
2929
models with a unified code, configuration, and deployment.")**
3030
The orchestration service operates under the global AI scenario `orchestration`, which is managed by SAP AI Core. This service enables the use of various generative AI models with a unified code, configuration, and deployment.
@@ -35,7 +35,7 @@ The foundation models service operates under the global AI scenario `foundation-
3535
**Related Information**
3636

3737

38-
[Orchestration](orchestration-cdd4847.md "The orchestration service operates under the global AI scenario orchestration, which is managed by SAP AI Core. This service enables the use of various generative AI models with a unified code, configuration, and deployment.")
38+
[Orchestration](orchestration-8d02235.md "The orchestration service operates under the global AI scenario orchestration, which is managed by SAP AI Core. This service enables the use of various generative AI models with a unified code, configuration, and deployment.")
3939

4040
[Foundation Models](foundation-models-2d981fb.md "The foundation models service operates under the global AI scenario foundation-models, which is managed by SAP AI Core.")
4141

docs/sap-ai-core/consume-models-with-the-harmonized-api-2392d9a.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ curl --request POST $ORCH_DEPLOYMENT_URL/completion \
4646

4747
This request configures the templating module with a single user message with two parameters: `text` and `language`. The `language` parameter is also configured with English as the default. The LLM module is configured to use gpt-4o-mini in the latest available version and a set of model parameters. The `input_params` field contains the values for the parameters `text` and `language`. These values are used during this request in the prompt sent to the model.
4848

49-
The response contains a `request_id`, the module results from each module that was executed, and the `orchestration_result`, which includes the response of the call to the model. For more information about modules available for consumption using the Harmoized API, see [Orchestration](orchestration-cdd4847.md).
49+
The response contains a `request_id`, the module results from each module that was executed, and the `orchestration_result`, which includes the response of the call to the model. For more information about modules available for consumption using the Harmoized API, see [Orchestration](orchestration-8d02235.md).
5050

5151
> ### Output Code:
5252
> ```

docs/sap-ai-core/deploy-models-dd16e8e.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -145,15 +145,15 @@
145145
146146
147147
148-
<a name="concept_z3s_f3h_vcc__d94e1165"/>
148+
<a name="concept_z3s_f3h_vcc__d95e1165"/>
149149
150150
## Optional Parameters
151151
152152
The duration of a deployment can be limited using the `ttl` parameter. It takes an integer for quantity, and a single letter to specify units of time. Only minutes \(`m`\), hours \(`h`\) and days \(`d`\), are supported, and values must be natural numbers. For example, `"ttl": "5h"` gives the deployment a duration of 5 hours. `4.5h` and `4h30m` are not valid inputs. If no value is passed, the duration of the deployment if indefinite. Once the duration expires, the deployment is stopped and deleted.
153153
154154
155155
156-
<a name="concept_z3s_f3h_vcc__d94e1196"/>
156+
<a name="concept_z3s_f3h_vcc__d95e1196"/>
157157
158158
## Deployment Quotas
159159

docs/sap-ai-core/edit-an-object-store-secret-d0af61c.md

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,6 @@
22

33
# Edit an Object Store Secret
44

5-
6-
7-
> ### Note:
8-
> For input artifacts only
9-
>
10-
> You can create multiple secrets using different values for `name`, but you must create a default first.
11-
12-
> ### Tip:
13-
> The `pathPrefix` is useful if you share the same bucket for different projects. You can set the name of your project folder to `my-ml-project1`, for example. All data is then stored in that folder.
14-
15-
> ### Note:
16-
> If the `AI-Resource-Group` header is not specified, the *<Resource Group\>* is assigned the value `"default"` automatically.
17-
18-
> ### Restriction:
19-
> When using an SAP HANA Data Lake object store with output artifacts pointing to a directory, you cannot use `archive: none: {}` in your workflow templates to disable artifact archiving. For more information, see [Workflow Templates](workflow-templates-83523ab.md).
20-
215
<a name="task_i3h_n13_tcc"/>
226

237
<!-- task\_i3h\_n13\_tcc -->
@@ -151,12 +135,18 @@ Edit your object store secret details using the endpoint `$AI_API_URL/v2/admin/o
151135
>
152136
> You can create multiple secrets using different values for `name`, but you must create a default first.
153137
138+
> ### Restriction:
139+
> Output artifacts can only use the default object store.
140+
154141
> ### Tip:
155142
> The `pathPrefix` is useful if you share the same bucket for different projects. You can set the name of your project folder to `my-ml-project1`, for example. All data is then stored in that folder.
156143
157144
> ### Note:
158145
> If the `AI-Resource-Group` header is not specified, the *<Resource Group\>* is assigned the value `"default"` automatically.
159146
147+
> ### Restriction:
148+
> When using an SAP HANA Data Lake object store with output artifacts pointing to a directory, you cannot use `archive: none: {}` in your workflow templates to disable artifact archiving. For more information, see [Workflow Templates](workflow-templates-83523ab.md).
149+
160150
<a name="task_cxf_n13_tcc"/>
161151
162152
<!-- task\_cxf\_n13\_tcc -->
@@ -269,17 +259,23 @@ SAP AI Core supports multiple hyperscaler object stores, including the following
269259
```
270260
271261
272-
3. Send the request.
273-
274262
> ### Note:
275263
> For input artifacts only
276264
>
277265
> You can create multiple secrets using different values for `name`, but you must create a default first.
278266
267+
> ### Restriction:
268+
> Output artifacts can only use the default object store.
269+
279270
> ### Tip:
280271
> The `pathPrefix` is useful if you share the same bucket for different projects. You can set the name of your project folder to `my-ml-project1`, for example. All data is then stored in that folder.
281272
282273
> ### Note:
283274
> If the `AI-Resource-Group` header is not specified, the *<Resource Group\>* is assigned the value `"default"` automatically.
284275
276+
> ### Restriction:
277+
> When using an SAP HANA Data Lake object store with output artifacts pointing to a directory, you cannot use `archive: none: {}` in your workflow templates to disable artifact archiving. For more information, see [Workflow Templates](workflow-templates-83523ab.md).
278+
279+
3. Send the request.
280+
285281

docs/sap-ai-core/get-a-repository-a64179d.md

Lines changed: 0 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -14,20 +14,12 @@ You have created a generic secret for grounding purposes. For more information,
1414

1515

1616

17-
<a name="loioa64179d1b8684a519d39dda0afa11e38__context_e42_ngh_jdc"/>
18-
19-
## Context
20-
21-
22-
2317
<a name="loioa64179d1b8684a519d39dda0afa11e38__steps_uyc_chh_jdc"/>
2418

2519
## Procedure
2620

2721
Send a GET request to the endpoint `$AI_API_URL/v2/lm/document-grounding/retrieval/dataRepositories`
2822

29-
To search within a specific repository specify it's `repositoryid` in `dataRepositories` attribute of the request or specify `*` to search in all the repositories.
30-
3123
Example for all repositories:
3224

3325
> ### Sample Code:

docs/sap-ai-core/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@
6161
- [Consume Models with the Harmonized API](consume-models-with-the-harmonized-api-2392d9a.md)
6262
- [Next Steps](next-steps-6106eed.md)
6363
- [Accessing Generative AI Models Through Global Scenarios](accessing-generative-ai-models-through-global-scenarios-4ca11f6.md)
64-
- [Orchestration](orchestration-cdd4847.md)
64+
- [Orchestration](orchestration-8d02235.md)
6565
- [Orchestration Workflow](orchestration-workflow-b233648.md)
6666
- [Grounding](grounding-454c558.md)
6767
- Prerequisites
@@ -102,6 +102,7 @@
102102
- [Few-Shot Learning](few-shot-learning-4fe47b1.md)
103103
- [Chat](chat-39321a9.md)
104104
- [Minimal Call](minimal-call-949e773.md)
105+
- [Tool Calling](tool-calling-f959929.md)
105106
- [Input Translation](input-translation-c43ad1d.md)
106107
- [Enhance Model Consumption with Input Translation](enhance-model-consumption-with-input-translation-0291151.md)
107108
- [Data Masking](data-masking-8b87002.md)
@@ -233,5 +234,6 @@
233234
- [Docker](docker-1945aa4.md)
234235
- [Deployment](deployment-a10fa8a.md)
235236
- [Miscellaneous](miscellaneous-10622b5.md)
237+
- [Support Process](support-process-c484783.md)
236238
- [Service Offboarding](service-offboarding-08303fe.md)
237239

docs/sap-ai-core/kubernetes-security-3864a9c.md

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,110 @@
44

55
We recommend that you enable the relevant and applicable Kubernetes security features on your workflow templates and serving templates. Ensure that you enable the appropriate Kubernetes features for your workloads.
66

7+
8+
9+
<a name="loio3864a9c5401f4115966a737e4b3a8026__section_g3x_srj_3fc"/>
10+
11+
## Restricted Pod Settings
12+
13+
To ensure proper security configurations for containers, certain security-related pod fields must adhere to specific values. There is a large number of pod fields, which change over time. Here, we list the most important fields and their required settings. You do not have to explicitly set these values on your own, however if you set these fields incorrectly, the pod will be rejected.
14+
15+
16+
17+
<a name="loio3864a9c5401f4115966a737e4b3a8026__section_jy1_5rj_3fc"/>
18+
19+
## Setting for `PodSecurityContext`
20+
21+
22+
<table>
23+
<tr>
24+
<th valign="top">
25+
26+
Capability
27+
28+
</th>
29+
<th valign="top">
30+
31+
Setting
32+
33+
</th>
34+
</tr>
35+
<tr>
36+
<td valign="top">
37+
38+
`Add`
39+
40+
</td>
41+
<td valign="top">
42+
43+
Must not be set
44+
45+
</td>
46+
</tr>
47+
<tr>
48+
<td valign="top">
49+
50+
`Drop`
51+
52+
</td>
53+
<td valign="top">
54+
55+
Must contain exactly one element: `['all']`
56+
57+
</td>
58+
</tr>
59+
<tr>
60+
<td valign="top">
61+
62+
`RunAsUser`
63+
64+
</td>
65+
<td valign="top">
66+
67+
Must be set to `65534`
68+
69+
</td>
70+
</tr>
71+
<tr>
72+
<td valign="top">
73+
74+
`RunAsGroup`
75+
76+
</td>
77+
<td valign="top">
78+
79+
Must be set to `65534`
80+
81+
</td>
82+
</tr>
83+
<tr>
84+
<td valign="top">
85+
86+
`RunAsNonRoot`
87+
88+
</td>
89+
<td valign="top">
90+
91+
Must be set to `true`. The pod must run as a non-root user
92+
93+
</td>
94+
</tr>
95+
<tr>
96+
<td valign="top">
97+
98+
`AllowPrivilegeEscalation`
99+
100+
</td>
101+
<td valign="top">
102+
103+
Must be set to `false`
104+
105+
</td>
106+
</tr>
107+
</table>
108+
109+
These settings are enforced internally. If your pod is rejected, it is likely due to one or more of these fields being set incorrectly. Please review your configuration and ensure compliance with the above requirements.
110+
7111
**Related Information**
8112

9113

docs/sap-ai-core/manage-data-pipelines-2f94a67.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ You can retrieve details of indexing pipelines in the following ways:
1515
> ### Sample Code:
1616
> ```
1717
> curl --request GET \ # Use GET method to retrieve all pipelines
18-
> --url $AI_API_URL/v2/lm/document-grounding/pipelines$AI_API_URL/v2/lm/document-grounding/pipelines \ # URL to fetch all pipelines
18+
> --url $AI_API_URL/v2/lm/document-grounding/pipelines\ # URL to fetch all pipelines
1919
> --header 'AI-Resource-Group: {{resource_group}}' # Add the resource group ID in the header
2020
>
2121
> ```
@@ -70,6 +70,8 @@ You can list all executions within a pipeline including status details by pipeli
7070
>
7171
> ```
7272
73+
The `lastExecution` parameter is Boolean, taking `true` or `false` values. Setting the value to `true` will retrieve only the latest execution in the pipeline. Setting the value to `false` will retrieve all executions in the pipeline.
74+
7375
You can get details of an execution including its status by pipeline ID and execution ID using the following:
7476
7577
> ### Sample Code:

docs/sap-ai-core/monitoring-and-troubleshooting-f559038.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ Explore solutions to potential issues, and find out how to get support.
66

77

88

9-
<a name="loiof559038fef1b4661bf62e26ee02442e8__section_uys_xk4_snb"/>
9+
<a name="loiof559038fef1b4661bf62e26ee02442e8__section_c34_zrv_hfc"/>
1010

1111
## Getting Support
1212

@@ -64,7 +64,7 @@ SAP AI Core
6464

6565
We recommend that you include the following information when you submit the incident:
6666

67-
- Region information \(Canary, EU10, US10\)
67+
- Region information
6868
- Subaccount technical name
6969
- URL of the page where the incident or error occurs
7070
- Steps or clicks used to replicate the error

docs/sap-ai-core/next-steps-6106eed.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
In the section above, we've outlined the basic steps for model consumption.
66

7-
If you're interested in exploring advanced use cases for enhancing LLM responses with capabilities like grounding, data masking, and content filtering, see [Orchestration](orchestration-cdd4847.md).
7+
If you're interested in exploring advanced use cases for enhancing LLM responses with capabilities like grounding, data masking, and content filtering, see [Orchestration](orchestration-8d02235.md).
88

99
Alternatively, you can deploy and consume models using direct model access. For more information, see [Foundation Models](foundation-models-2d981fb.md).
1010

0 commit comments

Comments
 (0)