Die AIUtils stehen nur zur Verfügung, wenn man das Modul „KI-Assistent“ lizenziert hat.
Code
AIStructuredOutputConfig addInt(AIStructuredOutputConfig config, String key, boolean required, String description)
AIStructuredOutputConfig addInt(AIStructuredOutputConfig config, String key, boolean required, String description, Integer defaultValue)
Beschreibung
Fügt einer AIStructuredOutputConfig ein Integer-Feld hinzu.
Mit dieser Methode definieren Sie ein numerisches Ganzzahlfeld innerhalb einer strukturierten KI-Antwort. Dabei legen Sie den Feldnamen, die fachliche Beschreibung und fest, ob das Feld erforderlich ist oder von der KI weggelassen werden darf.
Optional kann zusätzlich ein Standardwert angegeben werden. Dieser wird bei der Nachverarbeitung verwendet, wenn das Feld in der KI-Antwort fehlt oder null ist.
Die übergebene Konfiguration wird direkt verändert. Eine erneute Zuweisung des Rückgabewerts ist daher nicht erforderlich.
Parameter
-
config(AIStructuredOutputConfig) - DieAIStructuredOutputConfig, die erweitert werden soll. -
key(String) - Der Feldschlüssel innerhalb des aktuellen Objekts, z. B."quantity". -
required(boolean) - Legt fest, ob das Feld erforderlich ist.-
true: Das Feld ist erforderlich. -
false: Die KI darf das Feld weglassen.
-
-
description(String) - Fachliche Beschreibung des Felds. Diese Beschreibung wird verwendet, um der KI die Bedeutung und den erwarteten Inhalt des Felds zu verdeutlichen. -
defaultValue(Integer) - optional Standardwert vom TypInteger, der bei der Nachverarbeitung eingesetzt wird, wenn das Feld fehlt odernullist.
Rückgabe
AIStructuredOutputConfig - Im Erfolgsfall gibt die Methode dieselbe AIStructuredOutputConfig-Instanz zurück. Im Fehlerfall wird keine Konfiguration zurückgegeben. Stattdessen wird eine IllegalArgumentException ausgelöst, z. B. wenn übergebene Argumente ungültig sind.
Beispiele
Einfaches Integer-Feld definieren
AIStructuredOutputConfig config = AIUtils.createStructuredConfig()
AIUtils.addInt(
config,
"quantity",
true,
"Number of ordered items"
)
Optionales Feld mit Standardwert
AIStructuredOutputConfig defaultConfig = AIUtils.createStructuredConfig()
AIUtils.addInt(
defaultConfig,
"age",
false,
"Age of the person in years. If not clearly recognizable, omit the field.",
0
)
Verwendung in einer strukturierten Antwort
AIStructuredOutputConfig analysisConfig = AIUtils.createStructuredConfig()
AIUtils.addInt(
analysisConfig,
"priorityScore",
true,
"Priority of the request as an integer between 1 and 10"
)
Map<String, Object> systemVars = [:]
Map<String, Object> userVars = ["text": "The request is very urgent and should be processed today."]
IAIResult result = AIUtils.executePrompt("AnalyseCheck", analysisConfig, systemVars, userVars)
if (AIUtils.isAIResponseSuccessful(result)) {
Map<String, Object> data = AIUtils.getAIStructuredResponse(result)
Integer priorityScore = (Integer) data.get("priorityScore")
} else {
String errorMessage = AIUtils.getAIResponseError(result)
}