toScriptReturn

Versionshinweise	26.4

Code

GROOVY

ScriptReturn toScriptReturn(IAIResult result);

Beschreibung

Konvertiert ein IAIResult in ein standardisiertes ScriptReturn-Objekt. Diese Methode ist der empfohlene Weg für die Verarbeitung von KI-Ergebnissen innerhalb von Skriptbibliotheken und komplexen Workflows.

Vorteile von ScriptReturn:

Einheitliches Fehler-Handling: Erfolg (successful), Nutzinformationen (variables) und Fehlermeldungen (errorCode/errorDescription) sind in einem Objekt gekapselt.
Testbarkeit: Ideal für Unit-Tests. Fehlermeldungen der KI können direkt in Assertions verwendet werden, was das Debugging massiv erleichtert.
Kaskadierung: Ergebnisse können über mehrere Aufrufebenen (Skript-Methoden) hinweg einfach "durchgereicht" werden.

Funktionsweise der Datenwandlung

Structured Output: Die Ergebnis-Map der KI wird eins zu eins in die variables-Map des ScriptReturn-Objekts übernommen.
Freitext (String): Ein einfacher Antwort-Text wird automatisch in die Map unter dem Key "AIResponseMessage" abgelegt (z. B. ["AIResponseMessage" : "Der Text der KI..."]).

Parameter

result: Das IAIResult aus einem vorherigen KI-Aufruf.

Rückgabe

Ein ScriptReturn-Objekt, das den Status und die Daten des KI-Aufrufs enthält.

Beispiele

Verarbeitung von Freitext-Ergebnissen

GROOVY

IAIResult result = AIUtils.executePrompt("ShortSummary", null, ["text": "Langer Inhalt..."], [:], null)
ScriptReturn sr = AIUtils.toScriptReturn(result)

if (sr.successful) {
    // Freitext wird automatisch unter 'AIResponseMessage' abgelegt
    String summary = sr.variables.get("AIResponseMessage")
}