addBooleanList

Versionshinweise	26.6

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

Code

GROOVY

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 Default-Wert 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: Die AIStructuredOutputConfig, die erweitert werden soll.
key: Der Feldschlüssel innerhalb des aktuellen Objekts, z. B. "decisions".
required: Legt fest, ob die Liste erforderlich ist.
- true: Die Liste ist erforderlich.
- false: Die KI darf die gesamte Liste weglassen.
description: Fachliche Beschreibung des Felds. Diese Beschreibung wird verwendet, um der KI die Bedeutung und den erwarteten Inhalt der Liste zu verdeutlichen.
defaultValue: Optionaler Fallback-Wert vom Typ List<Boolean>, der bei der Nachverarbeitung eingesetzt wird, wenn das Feld fehlt oder null ist.

Rückgabe und Fehlerverhalten

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

1. Einfaches Boolean-Listenfeld definieren

GROOVY

AIStructuredOutputConfig config = AIUtils.createStructuredConfig()

AIUtils.addBooleanList(
    config,
    "decisions",
    false,
    "Liste von Ja-/Nein-Entscheidungen aus dem Text"
)

2. Optionales Listenfeld mit Default-Wert

GROOVY

AIStructuredOutputConfig config = AIUtils.createStructuredConfig()

AIUtils.addBooleanList(
    config,
    "decisionFlags",
    false,
    "Liste erkannter Ja-/Nein-Aussagen. Wenn keine klaren Aussagen erkennbar sind, Feld weglassen.",
    [false]
)

3. Verwendung in einer strukturierten Antwort

GROOVY

AIStructuredOutputConfig config = AIUtils.createStructuredConfig()

AIUtils.addBooleanList(
    config,
    "decisionFlags",
    true,
    "Liste erkannter Ja-/Nein-Aussagen aus dem Text"
)

Map<String, Object> systemVars = [:]
Map<String, Object> userVars = ["text": "Der Kunde ist bereits registriert, möchte aber aktuell kein Upgrade."]

IAIResult result = AIUtils.executePrompt("AnalyseCheck", config, 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)
}