App-Aktions-Tools sind in der Beta. Owner und Admins sehen sie, sobald der Schalter Beta-Funktionen unter Einstellungen → Workspace an ist, und der Plan des Workspace muss Automatisierungen enthalten. Andere Mitglieder sehen zugewiesene App-Aktions-Tools, können sie aber nicht ändern.
So arbeitet ein App-Aktions-Tool
Ein Friseursalon will Rückrufwünsche von Anrufern in einer Tabelle sammeln. Er legt ein App-Aktions-Tool für die Google-Sheets-Aktion „Add row“ an. Tabelle und Blatt sind feste Werte, den Namen und das Anliegen füllt der Assistent aus, die Telefonnummer kommt aus der übermittelten Rufnummer. Bevor der Assistent die Zeile schreibt, liest er die Angaben vor und bittet den Anrufer, sie zu bestätigen. Das Tool erscheint in Agent-Tools neben deinen anderen Tools, und du weist es Assistenten zu wie jedes andere Tool. Es funktioniert in allen Gesprächskanälen:- Telefonanrufe, Webanrufe und WhatsApp-Anrufe
- Web-Chat, auch im Test Chat
- alle Messaging-Kanäle, etwa WhatsApp, SMS, Telegram oder Slack
- E-Mail, sowohl die eigene Adresse des Assistenten als auch verbundene Postfächer
Die passende Tool-Art wählen
Ein App-Aktions-Tool deckt genau eine Aktion in einer App ab. Für alles andere passt eine andere Tool-Art besser:
Für eine einzelne Aktion ist ein App-Aktions-Tool schneller als eine aufrufbare Automatisierung. Der Assistent schickt jedes Feld direkt, also muss kein zusätzlicher KI-Schritt die Werte aus einem Freitext herauslesen.
Bevor du anfängst
Prüfe zuerst diese Voraussetzungen:- Du bist Owner oder Admin des Workspace.
- Der Schalter Beta-Funktionen unter Einstellungen → Workspace ist an.
- Der Plan des Workspace enthält Automatisierungen, und sein Limit Tools & MCP hat Platz für ein weiteres Tool.
- Die App ist unter Automationen → Verbindungen verbunden. Du kannst sie auch verbinden, während du das Tool anlegst.
Ein App-Aktions-Tool anlegen
1
App und Aktion wählen
Öffne Agent-Tools und wähle Neues Tool → App (Beta). Du kannst auch mit der Karte Apps unter Agent-Connectors starten, wo ein Klick auf ein App-Logo direkt diese App öffnet, oder unter Automationen → Verbindungen neben einer App Im Assistenten nutzen wählen. Der Editor zeigt deine verbundenen Apps. Für eine weitere App wähle App verbinden: Es öffnet sich dieselbe App-Liste wie in den Automationen, und nach der Anmeldung kommst du hierher zurück. Wähle dann die Aktion. Hat die App mehrere Verbindungen, wähle unter Verbindung die passende.
2
Tool benennen und Einsatz beschreiben
Name ist vorausgefüllt, zum Beispiel
google_sheets_add_row. Beschreibe unter Nutzen, wenn die Situation, in der der Assistent das Tool aufrufen soll, etwa „Wenn der Anrufer einen Rückruf wünscht.“ Nutze mindestens 10 Zeichen. Ein konkreter Satz funktioniert besser als ein kurzes Stichwort.3
Festlegen, woher jeder Wert kommt
Jedes Feld der Aktion hat die Einstellung Wert von, die der nächste Abschnitt erklärt. Pflichtfelder stehen oben. Optionale Felder starten mit Aus unter Weitere Felder.
4
Entscheiden, ob der Assistent vorher fragt
Bei Aktionen, die Daten ändern, ist Zuerst nachfragen aktiv. Lass es an, außer die Änderung braucht keine Bestätigung. Der Abschnitt zu „Zuerst nachfragen“ unten erklärt, wie es funktioniert.
5
Vorschau prüfen und testen
Was der Assistent sieht zeigt das Tool genau so, wie der Assistent es bekommt. Teste es unter Testen, bevor du speicherst, wie unten beschrieben.
6
Speichern und zuweisen
Wähle Tool erstellen und weise das Tool danach Assistenten zu. In den Einstellungen eines Assistenten zeigt Erweitert → Tools → Tool hinzufügen deine Verbundenen Apps: Wähle eine, um denselben Editor zu öffnen, oder wähle App verbinden, um zuerst eine weitere App zu verbinden. Das Tool wird zugewiesen, sobald du Zum Assistenten hinzufügen wählst. Als Tool-Knoten in einem Flow kannst du ein App-Aktions-Tool noch nicht nutzen; weise es stattdessen dem Assistenten zu.
Festlegen, woher jeder Wert kommt
Wert von bestimmt, wer den Wert eines Felds liefert:
Für KI-Felder schreibt Famulor eine Beschreibung aus den Feldangaben der App, mit dem erwarteten Format, etwa
YYYY-MM-DD, und einem Beispiel. Tippe eine eigene Beschreibung ein, um sie zu ersetzen. Bis zu 12 Felder können KI nutzen. Bleib bei 8 oder weniger: Weniger Felder machen Anrufe schneller und zuverlässiger.
Felder mit Fester Wert und Variable sieht der Assistent nie, und er kann sie nicht ändern. Ein fester Text kann Variablen wie {{caller_number}} enthalten und die Werte von KI-Feldern, geschrieben mit dem Parameternamen aus Was der Assistent sieht, etwa {{start_time}}. Fügst du einen Link zu einem Element aus Google Sheets, Docs, Drive, Notion oder Airtable ein, behält Famulor nur seine ID.
Für Felder gelten außerdem diese Regeln:
- Telefonfelder starten mit der Variable Anrufernummer. In Messaging-Kanälen enthält sie die Telefonnummer des Kontakts.
- Pflichtfelder können nicht auf Aus stehen.
- Manche Felder erwarten Tabellenzeilen, zum Beispiel die Werte einer neuen Zeile in einer Tabelle oder die Teilnehmer eines Termins. Sie zeigen Spalten. Für eine Tabellenzeile wählst du für jeden Wert Spalte hinzufügen und benennst die Spalte. Bei einer Liste wie den Teilnehmern gibt die App die Spalten vor, etwa Email und Name; wähle für jeden Eintrag Zeile hinzufügen. Wähle für jede Zelle KI, Fester Wert oder Variable. Eine Pflichtspalte braucht in jeder Zeile einen Wert.
- In einer Liste wie den Teilnehmern starten optionale Spalten auf Aus. Schalte sie für eine Zeile ein, wenn du sie brauchst. Zahlen- und Ja/Nein-Zellen nehmen KI oder Fester Wert.
Zuerst nachfragen
Bei Aktionen, die Daten ändern, etwa eine Zeile hinzufügen oder einen Kontakt anlegen, ist Zuerst nachfragen standardmäßig aktiv. Aktionen, die nur Daten lesen, fragen nie. Mit Zuerst nachfragen läuft eine Änderung so ab:- Der Assistent ruft das Tool auf. Noch ändert sich nichts: Famulor gibt eine Zusammenfassung der Werte zurück.
- Der Assistent liest dem Kunden die Zusammenfassung vor und fragt, ob sie stimmt.
- Der Assistent ruft das Tool mit denselben Werten erneut auf. Dieser Aufruf führt die Aktion in der App aus, wenn die Bedingung des Kanals erfüllt ist:
- Im Messaging und bei E-Mail hat der Kunde seit der Zusammenfassung eine neue Nachricht geschickt.
- In Anrufen und im Web-Chat sind seit dem ersten Aufruf mindestens 4 Sekunden vergangen. Ob der Kunde geantwortet hat, kann Famulor dort nicht erkennen.
Vor dem Einsatz testen
Teste jedes Tool, bevor du es einem Assistenten zuweist, der mit Kunden spricht. Gib unter Testen Beispielwerte für die KI- und Variablenfelder ein und wähle Test ausführen:- Aktionen, die Daten lesen, laufen echt.
- Aktionen, die Daten ändern, laufen zuerst als Probelauf. Er ändert nichts und zeigt, was der Assistent vorlesen würde. Wähle Wirklich ausführen und bestätige, um die Änderung in der App vorzunehmen.
Was der Assistent bekommt
Famulor kürzt jedes Ergebnis, bevor der Assistent es liest: Interne IDs, Versionsnummern und Werte, die wie Geheimnisse aussehen, fallen weg. Texte enden nach 500 Zeichen, Listen nach 10 Einträgen, und das gesamte Ergebnis umfasst höchstens 2.000 Zeichen. Wähle unter Erweitert → Ergebnis die Option Ausgewählte Felder, um nur Felder zu behalten, die du aus einem erfolgreichen Testergebnis auswählst. Über die API hebtresult_config.max_chars das Limit auf 3.500 Zeichen an. Der Assistent bekommt Ergebnisse als externe Daten gekennzeichnet, nicht als Anweisungen.
Limits
Antwortet die App nicht rechtzeitig, hängt das Ergebnis von der Aktion ab. Eine Aktion, die Daten liest, ist nicht gelaufen, und der Assistent kann es erneut versuchen. Bei einer Änderung ist der Ausgang unbekannt: Der Assistent versucht es nicht erneut und sagt dem Kunden, dass das Team es prüft.
Ein Tool bearbeiten, neu verbinden oder löschen
Öffne das Tool in Agent-Tools, um seine Felder, Nutzen, wenn oder Zuerst nachfragen zu ändern. Runs listet die letzten Läufe des Tools aus allen Kanälen auf, auch aus Messaging, E-Mail und Tests. Eine vorbereitete Änderung, die auf den Kunden wartet, und ein Probelauf erscheinen dort nicht, weil in der App nichts ausgeführt wurde. Fehlgeschlagene Läufe und Läufe mit unbekanntem Ausgang erscheinen als Fehler. Für eine andere Aktion legst du ein neues Tool an.- Du kannst das Tool auf eine andere Verbindung derselben App umstellen.
- Läuft eine Verbindung ab, zeigt das Tool Erneut verbinden und läuft erst wieder, wenn du die Verbindung erneuerst. Wähle Erneut verbinden und melde dich neu an: Famulor erneuert dieselbe Verbindung und bringt dich zurück zum Tool. Hat das Tool ungespeicherte Änderungen, fragt Famulor vorher, ob du sie verwerfen willst. Schlägt die Anmeldung fehl, zeigt das Tool den Fehler und wieder Erneut verbinden.
- Eine Verbindung, die App-Aktions-Tools nutzen, kannst du nicht löschen. Stell die Tools vorher auf eine andere Verbindung um oder lösche sie.
- Um ein App-Aktions-Tool zu löschen, entferne es zuerst bei jedem Assistenten, der es nutzt. Lösche es dann wie jedes andere Tool.
- App-Aktions-Tools lassen sich nicht in einen anderen Workspace verschieben. Leg das Tool im anderen Workspace neu an.
API, MCP, CLI und SDK
Du kannst App-Aktions-Tools auch ohne Dashboard anlegen, lesen, ändern und testen. Jede Anfrage braucht einen Zugang mit Owner- oder Admin-Rechten. Aktionen auflisten und lesen sowie ein Tool anlegen, ändern oder testen braucht außerdem einen Plan mit Automatisierungen. Aktionen auflisten und lesen braucht den Scopeautomations:read, ein Tool lesen assistants:read, und ein Tool anlegen, ändern oder testen braucht sowohl assistants:write als auch automations:write. Wie im Dashboard braucht das Anlegen außerdem Beta-Funktionen.
App-Aktions-Tools erscheinen auch in
GET /api/v1/tools, mit einer Zusammenfassung unter app_action. Weise sie mit PUT /api/v1/assistants/{id}/tools zu oder gib beim Anlegen assistant_id mit; ein unbekannter Assistent gibt 404 zurück, bevor das Tool angelegt wird. GET /api/v1/tools/{id}/runs und das MCP-Tool list_tool_runs liefern die Läufe, die unter Runs stehen. Entferne ein Tool bei seinen Assistenten und lösche es dann mit DELETE /api/v1/tools/{id}. Über das allgemeine PATCH /api/v1/tools/{id} kannst du ein Tool weiterhin umbenennen oder ein- und ausschalten; jede andere Änderung dort gibt 409 zurück. Auch der allgemeine Test, POST /api/v1/tools/test oder test_tool, gibt für ein App-Aktions-Tool 409 zurück.
Ein Tool über die API anlegen
Liste zuerst die Aktionen einer Verbindung auf.q sucht nach Namen. Aktionen, die Daten löschen, stehen nicht in der Liste.
get-app-action. Sie listen die fields der Aktion auf, jedes mit key, path, param und einem vorgeschlagenen mode. Schick beim Anlegen nur die Felder mit, die du ändern willst, erkennbar an path oder key. Du kannst mode, value, variable und description setzen; alle anderen Felder behalten ihre vorgeschlagene Einstellung. Diese Anfrage legt das Tool an und weist es einem Assistenten zu:
confirmation ist ask_first oder none; Aktionen, die Daten lesen, fragen nie. Damit sich die Aktion seit dem Lesen nicht geändert hat, schick auch ihre version mit: Gibt es inzwischen eine neuere Version, schlägt die Anfrage fehl. Speichere den Body als tool.json und schick ihn mit famulor create-app-action-tool --input tool.json oder POST /api/v1/tools/app-actions.
Teste das Tool danach. values enthält Beispielwerte für die KI- und Variablenfelder. Nimm dafür den param jedes Felds, also den Parameternamen, den der Assistent sieht, nicht den key. Beide unterscheiden sich oft: Das Feld startTime hat den param start_time, und eine Spalte übernimmt ihren Spaltennamen, etwa name. Bei einem Variablenfeld geht auch der Name der Variable, etwa caller_number:
mode ist dry_run, die Voreinstellung, oder live. Bei einer Aktion, die Daten ändert, braucht ein Live-Test zusätzlich "confirm_write": true und ändert echte Daten in der App. Die Antwort enthält model_text, also genau den Text, den der Assistent bekäme. Bei einer Aktion, die Daten ändert, zeigt read_back, was der Assistent vorlesen würde, auch im Probelauf.
Nächste Schritte
Agent Tools
Alle Tools deines Workspace zuweisen, bearbeiten und überwachen
App Catalog
Apps verbinden und sehen, was sie in Automatisierungen können