SAP Prompt Registry

Was es ist

Die Prompt Registry ist eine Komponente des Generative AI Hub in SAP AI Core, die „Prompt-Templates in SAP AI Core integriert und sie für Ihre Anwendungen und die Orchestrierung auffindbar macht“. Sie verwaltet den Lebenszyklus zweier Asset-Typen: Prompt-Templates und seit Februar 2026 Orchestration Configs — die vollständige Beschreibung eines Orchestrierungsaufrufs (Modell, Parameter, Filter, Maskierung, Grounding). Beide lassen sich direkt über die API nutzen oder aus Orchestrierungsanfragen referenzieren. Zugänglich ist die Registry über die AI API (/v2/lm/promptTemplates und verwandte Endpunkte), über AI Launchpad und über das SAP Cloud SDK for AI in JavaScript, Java und Python.

Aufbau eines Prompt-Templates

Ein Template hat Namen, Version, Szenario und Spec. Die Spec enthält die Nachrichtenvorlage — Rollen system, user und assistant mit Platzhaltern in der Form {{?platzhalter}} —, optionale Standardwerte und ein unstrukturiertes Objekt additional_fields für Metadaten wie Modellparameter oder eine Liste gesperrter Modelle. Versionen müssen der semantischen Versionierung folgen; die jüngste Iteration ist die Head-Version, markiert mit isVersionHead: true, und jede Iteration ist über den History-Endpunkt einsehbar. Standardmäßig liegen Templates auf Tenant-Ebene; mit den Headern AI-Resource-Group-Scope: true und AI-Resource-Group werden sie einer Resource Group zugeordnet — so trennen Sie Teams oder Umgebungen. Zur Laufzeit füllen Sie ein Template per ID oder über das Tripel Szenario, Name und Version am Substitution-Endpunkt, oder Sie referenzieren es in einem Orchestrierungsaufruf mit template_ref, per ID oder über Name, Szenario und Version, optional mit dem Scope resource_group oder tenant.

Warum es zählt

• Ohne Registry leben Prompts in Code und Umgebungsvariablen, wo niemand rekonstruieren kann, was dem System an einem bestimmten Tag aufgetragen wurde.
• Die Registry hat keinen eigenen Freigabe-Workflow — wer einen voraussetzt, bringt ungeprüfte Prompts in Produktion; erst der Git-basierte deklarative Modus macht Reviews durchsetzbar.
• Template-Historie allein ist kein Beweis: Die von jeder Inferenz genutzte Version muss die Anwendung oder die Inference Observability protokollieren.

Kernpunkte

• Komponente des Generative AI Hub: verwaltet Prompt-Templates und (seit Feb. 2026) Orchestration Configs als wiederverwendbare, auffindbare Assets.
• Template = Name + Version (SemVer) + Szenario + Spec (Nachrichten mit {{?platzhaltern}}, Standardwerte, additional_fields).
• Head-Version markiert mit isVersionHead: true; der History-Endpunkt listet jede Iteration.
• Scope: standardmäßig Tenant; Resource-Group-Scope über die Header AI-Resource-Group-Scope: true + AI-Resource-Group.
• Imperative API (CRUD, Designzeit) oder deklarativ (Git-Dateien *.prompttemplate.ai.sap.yaml, synchronisiert, managedBy: declarative, CI/CD).
• Laufzeit: Substitution per ID oder Szenario/Name/Version, oder template_ref in einem Orchestrierungsaufruf.
• Keine eingebaute Prüferrolle, kein Freigabe-Gate: Reviews über geschützte Branches und Pull Requests im deklarativen Modus erzwingen.
• Die Prompt-Optimierung schreibt verbesserte Prompts in die Registry zurück; Evaluierungen vergleichen Templates und Modelle auf Ihrem Datensatz.

Begriffe auf dieser Seite

Prompt-Template

Versionierte, wiederverwendbare Prompt-Definition mit rollenbasierten Nachrichten, Platzhaltern, Standardwerten und Metadaten in der Prompt Registry.

Head-Version

Jüngste Iteration eines Templates, markiert mit isVersionHead: true.

Imperative API

CRUD-Schnittstelle der Registry, empfohlen für Iterationen zur Designzeit; Änderungen stehen im History-Endpunkt.

Deklarative API

Git-basierte Verwaltung von Templates und Configs, von AI Core synchronisiert; empfohlen für Laufzeit und CI/CD.

template_ref

Verweis auf ein gespeichertes Template in einer Orchestrierungsanfrage, per ID oder über Name, Szenario und Version.

Substitution

Endpunkt, der die Platzhalter eines Templates mit Eingabewerten füllt und die resultierenden Nachrichten zurückgibt.

Gespeicherte Orchestration Config

Versionierte Beschreibung eines Orchestrierungsaufrufs, in der Registry abgelegt und aus Anfragen referenziert.

Prompt-Optimierung

Hub-Funktion, die ein Registry-Template anhand eines Datensatzes und einer Metrik verbessert und das Ergebnis zurückschreibt.

Quellen

1. SAP AI Core — Prompt Registry (SAP-docs)
2. SAP AI Core — Prompt Template Management (SAP-docs)
3. SAP AI Core — Create a Prompt Template (Imperative) (SAP-docs)
4. SAP AI Core — Create a Prompt Template (Declarative) (SAP-docs)
5. SAP AI Core — Orchestration Config Management (SAP-docs)
6. SAP AI Core — Prompt Optimization (SAP-docs)
7. SAP Cloud SDK for AI — prompt registry references in orchestration (JS)
8. EU AI Act — Article 18 (documentation keeping)
9. EU AI Act — Article 26 (obligations of deployers)
10. European Commission — AI Omnibus enters into force (27 Jul 2026)
11. SAP Help — Prompt Registry (generative AI hub)
12. SAP Developers — Tutorial: generative AI hub prompt registry
13. SAP Help — Orchestration service (generative AI hub) overview