Codeblöcke ermöglichen es Ihnen, Python-Logik direkt innerhalb einer Fin Procedure auszuführen und liefern konsistente, genaue Ergebnisse für Aufgaben, bei denen ein LLM unvorhersehbar sein kann.
Wann man Codeblöcke verwendet
Verwenden Sie Codeblöcke für deterministische, wiederholbare Logik – besonders dort, wo Fin sonst inkonsistent sein könnte:
Datums- & Zeitberechnungen – Werktage, Zeitzonenumrechnungen, Fristprüfungen
Mathematische Operationen – Rückerstattungsbeträge, Prozentsätze, Währungsumrechnungen
String-Manipulation – Formatierung von IDs, Extrahieren von Teilstrings, Regex-Abgleiche
Datenumwandlung – Umformen von Connector-Antworten, Filtern oder Abbilden von Listen
Komplexe bedingte Logik – Berechtigungsprüfungen mit mehreren Kriterien
Tipp: Verwenden Sie Codeblöcke, wenn das Ergebnis exakt und wiederholbar sein muss – nicht wenn Interpretation von Vorteil ist.
Wann man keine Codeblöcke verwendet
Vermeiden Sie Codeblöcke für Aufgaben, die Fin natürlich gut bewältigt, wie zum Beispiel:
Interpretation der Benutzerabsicht
Generierung von Gesprächsantworten
Wie man Codeblöcke verwendet
1. Erstellen Sie einen Codeblock
Öffnen Sie den Werkzeugauswahl durch Eingabe von @ oder /
Wählen Sie ＋Codeblock erstellen
2. Schreiben und testen Sie Ihren Code
Der Codeblock-Editor öffnet sich
Klicken Sie auf Code testen, um Ihre Logik auszuführen, dies öffnet das Testfenster
Eingabefelder erscheinen für alle Attribute, auf die Sie verwiesen haben
Führen Sie Tests durch und sehen Sie Ergebnisse im JSON- oder Listenformat an
3. Verstehen Sie Attribute
Attribute werden aus der zurückgegebenen Antwort erstellt. Zum Beispiel erzeugt folgender Code:
return {
"result": {
"nested_result": "This is nested"
},
"date": "05-04-2025"
}Erstellt die folgenden Attribute:
Ein Root-Attribut (die gesamte Antwort)
Verschachtelte Attribute: result, result.nested_result und date
Hinweis: Das Root-Attribut wird immer erstellt und enthält stets die vollständige zurückgegebene Antwort, es muss nicht JSON sein.
4. Verwenden Sie den Codeblock in einem Verfahren
Gehen Sie zurück zum Verfahrens-Editor
Öffnen Sie den Werkzeugauswahl durch Eingabe von @ oder /
Wählen Sie Code ausführen – dies listet alle verfügbaren Codeblöcke auf
Wählen Sie Ihren Codeblock aus
Nach der Auswahl können Sie die Attribute im gesamten Verfahren verwenden und wie gewohnt fortfahren.
Verfügbare Bibliotheken
Diese Python-Standardbibliotheksmodule sind auf der Whitelist und vorimportiert. Sie können sie direkt ohne Import-Anweisung verwenden, obwohl das Hinzufügen von Imports zur Klarheit empfohlen wird.
Modul | Verwendung für | Beispiel |
math | Mathematische Funktionen | math.floor(3.7), math.ceil(2.1) |
decimal | Präzise Dezimalarithmetik | Decimal("19.99") * Decimal("0.15") |
re | Reguläre Ausdrücke | re.match(r"\d{4}", order_id) |
datetime | Daten, Zeiten, Zeitspannen | datetime.date.today(), timedelta(days=5) |
json | JSON kodieren/dekodieren | json.loads(raw_string) |
random | Zufallsgenerator | random.randint(1, 100) |
zoneinfo | Zeitzonenverwaltung | ZoneInfo("America/New_York") |
time | Zeitbezogene Funktionen | time.time() |
Hinweis: Nur Importe auf oberster Ebene sind erlaubt. Vermeiden Sie Submodul-Importe – zum Beispiel wird from json import loads nicht unterstützt.