App-Module
Installierte App-Module können direkt im Flow Builder als eigenständige Schritte eingebunden werden. So lassen sich externe Dienste gezielt an bestimmten Stellen im Flow ausführen.
Wo finde ich App-Module im Flow Builder?
App-Module stehen im Flow Builder als eigener Schritt zur Verfügung. Beim Hinzufügen eines neuen Schritts sind die installierten Apps mit ihren Modulen am Ende der Schritt-Liste aufgeführt – gruppiert nach App-Namen: Schritt hinzufügen → [App-Name] → [Modul].
App-Modul-Schritt konfigurieren
Ein Klick auf ein Modul öffnet das Bearbeitungspanel. Es zeigt:
Name – vorausgefüllt mit
[App-Name] – [Modulname]. Du kannst den Namen anpassen, um den Schritt im Flow leichter identifizieren zu können.Beschreibung – optional. Hier kannst du eine kurze Erläuterung zum Schritt hinterlegen.
Eingabefelder der Parameter – die vom App-Ersteller definierten Eingabeparameter des Moduls erscheinen als eigene Felder. Pflichtfelder müssen ausgefüllt werden, bevor der Schritt ausgeführt werden kann. In die Felder können sowohl statische Werte als auch Variablen über den Variablen-Picker eingetragen werden – am schnellsten per
Alt + V, auf dem MacOption + V.
Ausgaben des Moduls verwenden
Nach der Ausführung eines App-Modul-Schritts stehen die Ausgabewerte des Moduls als Variablen im Flow zur Verfügung. Sie sind im Variablen-Picker unter der Kategorie des jeweiligen Moduls auffindbar.
Diese Variablen lassen sich im weiteren Verlauf des Flows einsetzen – z. B. in Nachrichten, Bedingungen oder als Eingabe für weitere Module.
Beispiel: Das Modul get_random_joke der App „Chuck Norris“ liefert die Ausgabevariablen Witz und ID. Diese können anschließend in einer Nachricht verwendet werden:
Der heutige Witz: Witz (Chuck Norris → get_random_joke → Witz)
Gibt ein Modul eine Liste aus, z. B. alle Bestellungen eines Kunden, verarbeitest du die Elemente mit der Schleife.
App-Module als Tool in Gespräch führen
App-Module können alternativ auch als Tool im Schritt Gespräch führen eingebunden werden. Der AI Agent entscheidet dabei automatisch, ob und wann er ein Modul während der Konversation aufruft.
Hinweise
Inaktive Verbindung: Ist die Verbindung einer App nicht eingerichtet oder inaktiv, kann das zugehörige Modul im Flow zwar eingebunden, aber nicht ausgeführt werden. Richte zunächst die Verbindung unter AI Agent → Einstellungen → App Store ein.
Parameter mit Pflichtfeldern: Enthält ein Modul Pflichtparameter (
required: true), müssen diese im Bearbeitungspanel zwingend befüllt sein. Andernfalls wird der Schritt nicht korrekt ausgeführt.Body-Format des Requests: Wie der Request-Body eines Moduls übertragen wird, bestimmt der
Content-Type-Header, den der App-Ersteller im Modul hinterlegt hat. Nebenapplication/jsonwird auchapplication/x-www-form-urlencodedunterstützt. Schlägt ein Modulaufruf fehl, weil das Zielsystem den Body nicht auswerten kann, prüfe diese Einstellung im Request des Moduls.
Last updated