Die AIUtils stehen nur zur Verfügung, wenn man das Modul „KI-Assistent“ lizenziert hat.
Code
AIStructuredOutputConfig addBooleanList(AIStructuredOutputConfig config, String key, boolean required, String description)
AIStructuredOutputConfig addBooleanList(AIStructuredOutputConfig config, String key, boolean required, String description, List<Boolean> defaultValue)
Beschreibung
Fügt einer AIStructuredOutputConfig ein Listenfeld mit Boolean-Werten hinzu.
Mit dieser Methode definieren Sie ein Feld für eine Liste von Wahrheitswerten innerhalb einer strukturierten KI-Antwort. Dabei legen Sie den Feldnamen, die fachliche Beschreibung und fest, ob die Liste 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."decisions". -
required(boolean) - Legt fest, ob die Liste erforderlich ist.-
true: Die Liste ist erforderlich. -
false: Die KI darf die gesamte Liste weglassen.
-
-
description(String) - Fachliche Beschreibung des Felds. Diese Beschreibung wird verwendet, um der KI die Bedeutung und den erwarteten Inhalt der Liste zu verdeutlichen. -
defaultValue(List<Boolean>) - optional Standardwert vom TypList<Boolean>, 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 Boolean-Listenfeld definieren
AIStructuredOutputConfig config = AIUtils.createStructuredConfig()
AIUtils.addBooleanList(
config,
"decisions",
false,
"List of yes/no decisions from the text"
)
Optionales Listenfeld mit Standardwert
AIStructuredOutputConfig defaultConfig = AIUtils.createStructuredConfig()
AIUtils.addBooleanList(
defaultConfig,
"decisionFlags",
false,
"List of recognized yes/no statements. If no clear statements are recognizable, omit the field.",
[false]
)
Verwendung in einer strukturierten Antwort
AIStructuredOutputConfig analysisConfig = AIUtils.createStructuredConfig()
AIUtils.addBooleanList(
analysisConfig,
"decisionFlags",
true,
"List of recognized yes/no statements from the text"
)
Map<String, Object> systemVars = [:]
Map<String, Object> userVars = ["text": "The customer is already registered, but does not want an upgrade at the moment."]
IAIResult result = AIUtils.executePrompt("AnalyseCheck", analysisConfig, systemVars, userVars)
if (AIUtils.isAIResponseSuccessful(result)) {
Map<String, Object> data = AIUtils.getAIStructuredResponse(result)
List<Boolean> decisionFlags = (List<Boolean>) data.get("decisionFlags")
} else {
String errorMessage = AIUtils.getAIResponseError(result)
}