executePrompt

Versionshinweise	25.5

Code

GROOVY

IAIResult executePrompt(String promptDefinitionPlainKey, Map<String, Object> userPromptVars, String systemPromptVars, String entryPk)

Hinweis

Die AIUtils stehen nur zur Verfügung, wenn man das Modul "KI-Assistent" lizenziert hat.

Beschreibung

Führt die Eingabe-Verwaltung mit dem angegebenen Namen aus und füllt die System- bzw. User-Prompt-Vorlage mit den übergebenen Werten. Die userPromptVars und systemPromptVars sollten für jeden in der Prompt angegebenen Platzhalter Werte enthalten. Die Prompt-Vorlage erfordert möglicherweise einen Datensatz, für den der PK angegeben werden muss.

Parameter

promptDefinitionPlainKey - Der PlainKey einer Eingabe-Verwaltung, welche für den Aufruf der KI verwendet werden soll..
userPromptVars - Die Map welche die Werte für die Platzhalter in der User-Prompt enthält.
systemPromptVars - Die Map welche die Werte für die Platzhalter in der System-Prompt enthält.
entryPk - [optional] Der PK eines Datensatzes, welcher in die Prompt übergeben wird.

Returns

Das IAIResult, welches die Antwort der KI enthält.

Beispiele

GROOVY

Map userPromptVars = new HashMap();
userPromptVars.put("Ansprechform", "Siezen");
userPromptVars.put("ThemaDesTermins", "Brandneues Produkt");
userPromptVars.put("AgendaDesTermins", "Funktionen, KI, Günstiger Preis");

List<String> dates = new ArrayList<String>();
Date date = DateUtils.parseDate("01.04.1987 10:00", "dd.MM.yyyy HH:mm");
dates.add(DateUtils.convertDateTimePattern(date, "yyyy-MM-dd'T'HH:mm:ssX"));
date = DateUtils.setDateField(date, DateUtils.HOUR, 12);
dates.add(DateUtils.convertDateTimePattern(date, "yyyy-MM-dd'T'HH:mm:ssX"));
userPromptVars.put("Datum", dates);

userPromptVars.put("Dauer", "1 Stunde");
userPromptVars.put("Ort", "vor Ort");

Map systemPromptVars = new HashMap();

IAIResult result = AIUtils.executePrompt("Terminvereinbarung", userPromptVars, systemPromptVars, "fvvvvvvkarpvi1ium3j2qcAc");

if (AIUtils.isAIResponseSuccessful(result)) {
    String aiResponse = AIUtils.getAIResponseMessage(result);
} else {
    String errorMessage = AIUtils.getAIResponseError(result);
}

Versionshinweise	26.4

Code

CODE

IAIResult executePrompt(String promptDefinitionPlainKey, Map<String, Object> userPromptVars, Map<String, Object> systemPromptVars);
IAIResult executePrompt(String promptDefinitionPlainKey, StructuredOutputConfig structuredOutput, Map<String, Object> userPromptVars, Map<String, Object> systemPromptVars);
IAIResult executePrompt(String promptDefinitionPlainKey, Map<String, Object> userPromptVars, Map<String, Object> systemPromptVars, String entryPk);
IAIResult executePrompt(String promptDefinitionPlainKey, StructuredOutputConfig structuredOutput, Map<String, Object> userPromptVars, Map<String, Object> systemPromptVars, String entryPk);

Beschreibung

Führt eine in der Eingabe-Verwaltung definierte Prompt-Vorlage aus. Die Methode füllt die Platzhalter der User- und System-Prompts mit den übergebenen Werten aus den entsprechenden Maps. Je nach Überladung kann ein Datensatz-Kontext (entryPk) für die Vorlage mitgegeben oder ein festes Antwortschema (StructuredOutputConfig) definiert werden.

Hinweis

Die AIUtils stehen nur zur Verfügung, wenn man das Modul "KI-Assistent" lizenziert hat.

Parameter

promptDefinitionPlainKey: Der PlainKey einer Eingabe-Verwaltung, welche für den Aufruf der KI verwendet werden soll.
userPromptVars: Die Map mit Werten für die Platzhalter im User-Prompt der Vorlage.
systemPromptVars: Die Map mit Werten für die Platzhalter im System-Prompt der Vorlage.
structuredOutput: [optional] Ein StructuredOutputConfig Objekt, welches die gewünschte JSON-Struktur der Antwort definiert.
entryPk: [optional] Der Primärschlüssel eines Datensatzes, auf den innerhalb der Prompt-Vorlage zugegriffen werden soll.

Rückgabe

Das IAIResult, welches die Antwort der KI enthält. Nutzen Sie AIUtils.isAIResponseSuccessful(result), um den Erfolg zu prüfen.

Beispiele

Einfacher Aufruf (Freitext)

GROOVY

// 1. Variablen vorbereiten
Map userVars = ["Thema": "Projekt-Update"]
Map systemVars = [:]

// 2. Prompt ausführen
IAIResult result = AIUtils.executePrompt("MailVorlage", userVars, systemVars)

// 3. Ergebnis prüfen
if (AIUtils.isAIResponseSuccessful(result)) {
    String message = AIUtils.getAIResponseMessage(result)
}

Aufruf mit Datensatz-Bezug (entryPk)

GROOVY

// 1. Variablen und PK definieren
Map userVars = ["Anrede": "Herr"]
String kundenPk = "fvvvvvvkarpvi1ium3j2qcAc"

// 2. Prompt ausführen (Vorlage greift auf Daten des Kunden-PKs zu)
IAIResult result = AIUtils.executePrompt("IndividuellesAngebot", userVars, [:], kundenPk)

Aufruf mit strukturiertem Output

GROOVY

// 1. Schema definieren
def config = AIUtils.createStructuredConfig()
AIUtils.addExpectedReturn(config, "status", String.class, false, "Klassifizierung der Anfrage")

// 2. Variablen vorbereiten
Map userVars = ["text": "Ich habe mein Passwort vergessen."]

// 3. Prompt ausführen (mit Schema und ohne PK)
IAIResult result = AIUtils.executePrompt("AnalyseCheck", config, userVars, [:])

// 4. Strukturierte Daten auslesen
if (AIUtils.isAIResponseSuccessful(result)) {
    Map data = AIUtils.getAIStructuredResponse(result)
    String status = data.get("status")
}