Die in diesem Beitrag beschriebenen Funktionen werden vom 11. Mai bis zum 12. Juni 2026 schrittweise für alle Suite- und Support-Pläne eingeführt. Unter Umständen sind sie in Ihrem Konto noch nicht verfügbar. Weitere Informationen finden Sie in dieser Ankündigung.
Möglicherweise haben Sie eine API, die mehrere Anfrageparameter akzeptiert, von denen aber nicht alle für einen erfolgreichen Aufruf erforderlich sind. Wenn ein erwarteter Parameter nicht übergeben wird, schlägt die Integration möglicherweise fehl, weil die API einen gültigen Wert, eine leere Zeichenfolge, ”” oder null erwartet. In diesem Fall müssen Sie diese Parameter im Integration Builder nullifizieren, damit der Aufruf nicht fehlschlägt.
So nullifizieren Sie optionale Parameter
- Machen Sie sich mit dem Verhalten optionaler Parameter vertraut.
Stellen Sie zunächst sicher, dass Ihre API fehlende optionale Werte in eine leere Zeichenfolge oder einen Nullwert transformieren kann. - Initialisieren Sie die optionalen Parameter beim Starten des Chats als null oder leere Zeichenfolge.
Dadurch verhindern Sie, dass der API-Aufruf aufgrund eines fehlenden Parameters fehlschlägt. Weitere Informationen finden Sie im Beitrag Überblick über Aktionen für AI Agents.
- Richten Sie die Integration im Integration Builder so ein, dass die Parameter als Anfrageparameter erfasst werden und das Kontrollkästchen „Erforderlich“ deaktiviert ist.
- Setzen Sie den Mauszeiger auf das Eingabefeld „Testwert“. Das Symbol „Werte neu formatieren“ wird angezeigt.
Wenn Sie auf dieses Symbol klicken, wird ein Dialogfeld angezeigt. Hier sollten Sie den folgenden JSONata-Ausdruck zum Textfeld „Neuformatierung von JSONata“ hinzufügen:
‚$a and $not($a = "null") ? $a : ""‘
Dieser JSONata-Ausdruck prüft, ob der Parameter vorhanden ist und einen Wert aufweist.- Wenn dies der Fall ist, übergeben Sie den Parameterwert an die API.
- Wenn dies nicht der Fall ist, übergeben Sie eine leere Zeichenfolge oder lassen Sie den Parameter ganz weg.
Weitere Informationen finden Sie unter Neuformatieren von Werten in Anfrageparametern für AI Agents.
Nun werden optionale Werte für den API-Aufruf vom Integration Builder nahtlos verarbeitet.