Skip to content

Commit c6a820d

Browse files
committed
Update from SAP DITA CMS (squashed):
commit e5c81a58b3e14fc2007e2b94d33f0a761070c7ef Author: REDACTED Date: Mon Apr 14 14:06:57 2025 +0000 Update from SAP DITA CMS 2025-04-14 14:06:57 Project: dita-all/bex1621329160251 Project map: d3e749bbac3d4f728c12228db6629c45.ditamap Output: loiodaa66b2ef49f48539fa2882d82d5b619 Language: en-US Builddable map: f17fa8568d0448c685f2a0301061a6ee.ditamap commit 0324a4408d199b50282147327d1a375c4cac8001 Author: REDACTED Date: Mon Apr 14 13:25:49 2025 +0000 Update from SAP DITA CMS 2025-04-14 13:25:49 Project: dita-all/ayn1620809929290 Project map: 8a3894192639433b9ba1f87efe78bfd1.ditamap Output: loio62559d01add8414eb0c4d76d2d9f48bd Language: en-US Builddable map: 038a6194f65c4ef68885f6f16360dbc4.ditamap commit de7f4897a288e447034c252ed0ee1e99895e4c9b Author: REDACTED Date: Mon Apr 14 13:21:36 2025 +0000 Update from SAP DITA CMS 2025-04-14 13:21:36 Project: dita-all/bex1621329160251 Project map: d3e749bbac3d4f728c12228db6629c45.ditamap ################################################## [Remaining squash message was removed before commit...]
1 parent a3764d9 commit c6a820d

File tree

177 files changed

+4270
-1432
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

177 files changed

+4270
-1432
lines changed

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

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

55
Access to generative AI models falls under the global AI scenarios `foundation-models` and `orchestration`. SAP AI Core manages these scenarios. You can access individual models as executables through serving templates. To use a specific model, choose the corresponding template.
66

7+
8+
9+
<a name="loio4ca11f687fbd435b813b2726c3ddbaea__section_jmy_mng_xdc"/>
10+
11+
## When to Use Orchestration vs. Foundation Models
12+
13+
14+
15+
### Advantages of Using Orchestration
16+
17+
- Provider Agnostic: The orchestration service offers a unified interface for accessing LLMs from multiple providers, simplifying the process of testing and comparing models. You can switch models via a config parameter without creating new deployments.
18+
- Simplified Integration: It streamlines the integration of LLMs into applications, ensuring efficient and cost-effective development.
19+
- Expandability: The service allows you to start with basic features and add modules as needed, offering a smooth learning curve.
20+
21+
22+
23+
### Considerations Before Using Orchestration
24+
25+
- Function Calling Availability: Function calling, with its structured output aspects, isn't currently available.
26+
- 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.
27+
728
- **[Orchestration](orchestration-cdd4847.md "The orchestration service operates under the global AI scenario
829
orchestration, which is managed by SAP AI Core. This service
930
enables the use of various generative AI models with a unified code, configuration, and

docs/sap-ai-core/add-a-git-repository-b668176.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ You can use your own git repository to version control your SAP AI Core template
2121
- If you want to onboard a git repository hosted on GitLab, make sure that the repository URL contains the `.git` suffix.
2222
- Secrets aren't permitted in your repository. If secrets are used, it isn't possible to synchronize content.
2323

24-
- You have completed the Initial Setup. For more information, see [Initial Setup](initial-setup-38c4599.md).
24+
- You have completed the initial setup. For more information, see [Initial Setup](initial-setup-38c4599.md).
2525

2626

2727
> ### Note:
@@ -76,7 +76,7 @@ Create an application to sync your folders. For more information, see [Create an
7676

7777
<!-- task\_cxf\_n13\_tcc -->
7878

79-
## Using Postman
79+
## Using a Third-Party API Platform
8080

8181

8282

@@ -89,7 +89,7 @@ Create an application to sync your folders. For more information, see [Create an
8989
- If you want to onboard a git repository hosted on GitLab, make sure that the repository URL contains the `.git` suffix.
9090
- Secrets aren't permitted in your repository. If secrets are used, it isn't possible to synchronize content.
9191

92-
- You have completed the Initial Setup. For more information, see [Initial Setup](initial-setup-38c4599.md).
92+
- You have completed the initial setup. For more information, see [Initial Setup](initial-setup-38c4599.md).
9393

9494

9595
> ### Note:

docs/sap-ai-core/apis-and-api-extensions-0cb7275.md

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,40 @@ Explore the entities, methods, and endpoints provided by the runtime-agnostic AI
5757

5858
[AI API swagger specification](https://help.sap.com/doc/2cefe221fddf410aab23dce890b5c603/CLOUD/en-US/index.html)
5959

60+
</td>
61+
</tr>
62+
<tr>
63+
<td valign="top">
64+
65+
Prompt Registry
66+
67+
</td>
68+
<td valign="top">
69+
70+
Simplify the lifecycle management of prompt templates of your business AI scenarios.
71+
72+
</td>
73+
<td valign="top">
74+
75+
[Prompt Registry API](https://api.sap.com/api/PROMPT_REGISTRY_API/overview)
76+
77+
</td>
78+
</tr>
79+
<tr>
80+
<td valign="top">
81+
82+
Orchestration
83+
84+
</td>
85+
<td valign="top">
86+
87+
Enhance content generation with additional capabilities for business AI scenarios.
88+
89+
</td>
90+
<td valign="top">
91+
92+
[Orchestration API](https://api.sap.com/api/ORCHESTRATION_API/overview)
93+
6094
</td>
6195
</tr>
6296
</table>

docs/sap-ai-core/change-an-existing-training-schedule-18caf4b.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ curl --location --request PATCH $AI_API_URL/v2/lm/executions?executionScheduleId
4343

4444
<!-- task\_cxf\_n13\_tcc -->
4545

46-
## Using Postman
46+
## Using a Third-Party API Platform
4747

4848

4949

docs/sap-ai-core/choose-a-resource-plan-57f4f19.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -271,7 +271,7 @@ Infer-L
271271

272272
[Efficiency Features](efficiency-features-4cb76f7.md "Discover features of the SAP AI Core runtime that improve efficiency and help manage resource consumption.")
273273

274-
[Retrieve Execution Logs](retrieve-execution-logs-fbc55d3.md "accessed in the deployment and execution logs.")
274+
[Retrieve Execution Logs](retrieve-execution-logs-fbc55d3.md "Deployment and execution logs contain information about API processing and metrics.")
275275

276276
[Training Schedules](training-schedules-2b702f8.md "")
277277

docs/sap-ai-core/choose-a-resource-plan-abd672f.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -267,7 +267,7 @@ Infer-L
267267

268268
[Efficiency Features](efficiency-features-9fad26a.md "Discover features of the SAP AI Core runtime that improve efficiency and help manage resource consumption.")
269269

270-
[Retrieve Deployment Logs](retrieve-deployment-logs-4c86b88.md "accessed in the deployment and execution logs.")
270+
[Retrieve Deployment Logs](retrieve-deployment-logs-4c86b88.md "Deployment and execution logs contain information about API processing and metrics.")
271271

272272
<a name="loiocf3a9a5bb3f1476caf3099281da96a67"/>
273273

docs/sap-ai-core/consume-generative-ai-models-bf0373b.md

Lines changed: 50 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -116,6 +116,26 @@ curl --location '$DEPLOYMENT_URL/chat/completions?api-version=2023-05-15' \
116116

117117

118118

119+
### o1 | o3-mini
120+
121+
```
122+
curl --location '$DEPLOYMENT_URL/chat/completions?api-version=2024-12-01-preview' \
123+
--header 'AI-Resource-Group: default' \
124+
--header 'Content-Type: application/json' \
125+
--header "Authorization: Bearer $AUTH_TOKEN" \
126+
--data '{
127+
"messages": [
128+
{
129+
"role": "user",
130+
"content": "Hello!"
131+
}
132+
]
133+
}'
134+
}'
135+
```
136+
137+
138+
119139
### GPT-4o | GPT-4-Turbo | GPT-4o Mini
120140

121141
**Image input**
@@ -266,12 +286,12 @@ curl --request POST --location "$DEPLOYMENT_URL/models/gemini-1.5-pro:generateCo
266286

267287

268288

269-
### Gemini 1.5 Flash
289+
### Gemini 1.5 Flash Gemini 2.0 Flash | Gemini 2.0 Flash Lite
270290

271291
**Text Input**
272292

273293
```
274-
curl --request POST --location "$DEPLOYMENT_URL/models/gemini-1.5-flash:generateContent" \
294+
curl --request POST --location "$DEPLOYMENT_URL/models/<modelName>:generateContent" \ #example gemini-1.5-flash:generateContent
275295
--header 'AI-Resource-Group: default' \
276296
--header 'Content-Type: application/json' \
277297
--header "Authorization: Bearer $AUTH_TOKEN" \
@@ -295,7 +315,7 @@ curl --request POST --location "$DEPLOYMENT_URL/models/gemini-1.5-flash:generate
295315
**Image input**
296316

297317
```
298-
curl --request POST --location "$DEPLOYMENT_URL/models/gemini-1.5-flash:generateContent" \
318+
curl --request POST --location "$DEPLOYMENT_URL/models/<modelVersion>:generateContent" \ #example gemini-1.5-flash:generateContent
299319
--header 'AI-Resource-Group: default' \
300320
--header 'Content-Type: application/json' \
301321
--header "Authorization: Bearer $AUTH_TOKEN" \
@@ -444,6 +464,32 @@ curl --location '$DEPLOYMENT_URL/invoke' \
444464

445465

446466

467+
### Claude 3.7 Sonnet
468+
469+
```
470+
curl --location '$DEPLOYMENT_URL/converse' \
471+
--header 'AI-Resource-Group: default' \
472+
--header 'Content-Type: application/json' \
473+
--header "Authorization: Bearer $AUTH_TOKEN" \
474+
--data '{
475+
"inferenceConfig": {
476+
"maxTokens": 100,
477+
"stopSequences": [ "blab" ],
478+
"temperature": 0.7
479+
},
480+
"messages": [
481+
{
482+
"content": [ {
483+
"text": "Perplexity means?"
484+
}],
485+
"role": "user"
486+
}
487+
]
488+
}'
489+
```
490+
491+
492+
447493
### Titan Text Express | Titan Text Lite
448494

449495
```
@@ -510,7 +556,7 @@ curl --location '$DEPLOYMENT_URL/converse' \
510556

511557

512558

513-
### Llama-3-70b-instruct| Llama-3.1-70b-instruct | mistralai--mixtral-8x7b-instruct-v01
559+
### Llama-3.1-70b-instruct | mistralai--mixtral-8x7b-instruct-v01
514560

515561
```
516562
curl --location '$DEPLOYMENT_URL/chat/completions' \

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.
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).
5050

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

docs/sap-ai-core/metadata-9913885.md renamed to docs/sap-ai-core/contextualized-retrieval-using-metadata-9913885.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
<!-- loio991388516a8642b6aa49672937cbc937 -->
22

3-
# Metadata
3+
# Contextualized Retrieval Using Metadata
44

55
You can choose to include metadata in the output structure of the grounding module in orchestration. You can leverage the metadata in your prompt template.
66

@@ -150,8 +150,9 @@ Meta data inclusion is optional, and can be included using the `metadata_params`
150150
> ### Output Code:
151151
> ```
152152
> [
153+
> [
153154
> {
154-
> "content": "2 FeaturesnJoule is a multitenant software as a service (SaaS) application in SAP Business T echnology Platform. It enablesnthe companion of the Intelligent Enterprise, guiding you through content discovery within SAP Ecosystem,nand giving a transparent role-based access to the relevant processes from everywhere. This is the ONE digitalnassistant experience, a unified and delightful UX across SAPu2019s solution portfolio.nThe following features are available for Joule:nKey Feature UsenIntegration with SAP application Conversational user interface that is integrated with SAPnapplications. It is a rich web client that renders assistantnresponses using SAP Fiori compliant UI controls.nEnterprise-readiness Out-of-the-box integration with SAP backend systems. Com-npliant with AI ethics, GDPR, privacy controls with SOC-IIncompliance.nPublish and subscribe mechanism Capabilities based on your SAP solution portfolio are bun-ndled into a unique digital assistant.",
155+
> "content": "Joule is the AI copilot that truly understands your business. Joule revolutionizes how you interact with your SAP business systems, making every touchpoint count and every task simpler.",
155156
> "metadata": {
156157
> "source": [
157158
> "/tmp/document_1.pdf"
@@ -165,7 +166,7 @@ Meta data inclusion is optional, and can be included using the `metadata_params`
165166
> }
166167
> },
167168
> {
168-
> "content": "4 Compliance and SecuritynJoule ensures cloud security at multiple levels:nCertificates and ReportsnJoule regularly undergoes audits and reviews of its policies and controls.nu2022For the complete list of compliance and security standards that the Joule service is compliant with, seenSAP Cloud Platform ISO Certificatesn .nu2022For the complete list of Service Organizational Control (SOC) audit reports available for the Joule service,nsee SAP Cloud Platform SOC Reportsn .nData ProtectionnJoule follows SAP's global data protection and privacy guidelines. For more information on the guidelines, seenData Privacyn .nT o access the Personal Data Processing policy for your region, see Personal Data Processing for SAP CloudnServicesn .n6 PUBLICFeature Scope Description for JoulenCompliance and Security",
169+
> "content": "AI-powered capabilities in Joule with custom-developed enterprise skills tailored to your company's specific needs. By integrating with both SAP and third-party applications, Joule can instantly apply its newfound knowledge within SAP systems.",
169170
> "metadata": {
170171
> "source": [
171172
> "/tmp/document_1.pdf"

docs/sap-ai-core/create-a-collection-9cbfe27.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@
1010

1111
You have created a resource group for grounding purposes. For more information, see [Create a Resource Group for Grounding](create-a-resource-group-for-grounding-6712bfe.md)
1212

13-
You have created a generic secret for grounding purposes. For more information, see [Grounding Generic Secrets for Microsoft SharePoint](grounding-generic-secrets-for-microsoft-sharepoint-bdea357.md)
14-
1513

1614

1715
<a name="loio9cbfe270add641c291bb516d8afe3ce9__context_ov1_1wr_kdc"/>

0 commit comments

Comments
 (0)