For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.

Voraussetzung: Die App ist im AI Agent installiert und alle erforderlichen Verbindungen sind eingerichtet und aktiv.

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].

Welche Eingabeparameter ein Modul erwartet und welche Werte es zurückgibt, siehst du vorab in der App-Detailansicht im App Store.


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 Mac Option + V.

Auf ein App-Modul sollte immer ein weiterer Schritt folgen, da im Anschluss sonst der Fallback greift.


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. Neben application/json wird auch application/x-www-form-urlencoded unterstützt. Schlägt ein Modulaufruf fehl, weil das Zielsystem den Body nicht auswerten kann, prüfe diese Einstellung im Request des Moduls.

Last updated