Workflow-Builder
Ein Workflow führt seine Schritte selbstständig aus: Er startet nach Zeitplan, durch einen API-Aufruf, durch eine WebSocket-Nachricht oder von Hand, liest und schreibt dann Daten, wendet Ihre Regeln an, ruft andere Dienste auf und gibt ein Ergebnis zurück. Sie bauen ihn auf einer visuellen Arbeitsfläche, von Hand oder indem Sie Vira fragen.
Den Builder öffnen
- Studio - klicken Sie auf der Karte Workflow auf Start a workflow.
- Ein bestehender Workflow - öffnen Sie ihn aus Studio. Auch die Workflows, die Qira und Vira für eine Web-App angelegt haben, finden Sie dort.
- Import a flow - Sie haben bereits einen Workflow als JSON? Klicken Sie in Studio unter den Karten auf Import a flow.
Die Arbeitsfläche
| Bereich | Was er tut |
|---|---|
| Oben links | Der Name des Workflows (zum Umbenennen auf den Stift klicken) |
| Arbeitsfläche | Die Nodes und die Linien zwischen ihnen. Die Daten fließen vom Trigger oben der Reihe nach durch jeden Node |
| Rückgängig, Wiederholen und Zoom | Oben rechts auf der Arbeitsfläche, mit einer Schaltfläche, die den ganzen Workflow auf den Bildschirm einpasst |
| Minikarte | Unten rechts. Ziehen Sie daran, um sich in großen Workflows zu bewegen |
| Active | Schaltet den Workflow ein oder aus. Ein inaktiver Workflow antwortet nicht auf seiner API-Adresse und läuft nicht nach Zeitplan |
| History | Frühere Versionen des Workflows. Öffnen Sie eine, um sie anzusehen oder zu ihr zurückzukehren |
| Publish | Schaltet Ihre Änderungen live |
| Ask Vira | Unten links. Der Chat, in dem Vira den Workflow für Sie baut und ändert |
Klicken Sie auf einen Node, um seine Einstellungen zu öffnen. Doppelklicken Sie auf die Arbeitsfläche, um einen Node hinzuzufügen: Im Dialog Add Node suchen Sie nach Namen oder durchstöbern alle 32 Nodes in fünf Gruppen: Flow Control, AI & Models, Data, Code & Transform und Integrations & I/O. Jeder Node hat seine eigene Seite im Bereich Workflows dieser Dokumentation.
Trigger
Jeder Workflow beginnt mit einem Trigger:
| Trigger | Startet den Workflow, wenn |
|---|---|
| Manual | Sie im Editor auf Run klicken |
| Schedule | eine von Ihnen festgelegte Zeit erreicht ist: jeden Morgen, jeden Freitag um 17:00, alle 5 Minuten |
| API | etwas seine Adresse aufruft. Sie legen erlaubte Methoden, Authentifizierung, Rate-Limit, Timeout, IP-Allow-List und CORS fest |
| WebSocket | eine Nachricht über eine WebSocket-Verbindung eintrifft |
Agenten beginnen stattdessen mit einem Chat-Trigger. Siehe Agent-Builder.
Mit Vira bauen
Klicken Sie auf Ask Vira, um ihr Panel zu öffnen. Beschreiben Sie, was der Workflow tun soll, so wie Sie es einer Kollegin oder einem Kollegen erklären würden. Vira wählt die Nodes aus, richtet sie ein und verbindet sie direkt vor Ihren Augen auf der Arbeitsfläche.
Neben dem Nachrichtenfeld:
- @ - verweisen Sie Vira auf etwas in Ihrem Arbeitsbereich, etwa eine Tabelle
- Upload - hängen Sie eine Datei an, zum Beispiel eine Beispielanfrage oder eine Spezifikation
- Mikrofon - sprechen Sie, statt zu tippen
- Papierkorb - leeren Sie das Gespräch
- Modellauswahl - das KI-Modell, das Vira verwendet. Ihre verbleibenden Credits werden darunter angezeigt
Das Uhr-Symbol oben im Panel öffnet Ihre früheren Gespräche mit Vira.
Einen Workflow ändern
Vira arbeitet an dem Workflow, der gerade geöffnet ist. Sie können also nicht nur neue Workflows anfordern, sondern auch Änderungen:
- „Einen Schritt hinzufügen, der mir eine E-Mail schickt, wenn die Bestellsumme über 500 € liegt“
- „Wenn der Kunde nicht gefunden wird, 404 statt einer leeren Liste zurückgeben“
- „Den Zahlungsaufruf in ein try/catch packen und den Fehler in die Tabelle errors schreiben“
Jede Änderung erscheint auf der Arbeitsfläche, und History bewahrt die Version von davor auf.
Beispielanfragen
Tägliche Zusammenfassung
„Jeden Morgen um 8 die neuen Registrierungen von gestern aus der Tabelle users lesen und mir als Liste per E-Mail schicken.“
Trigger: Schedule. Danach Query Data, Code zum Formatieren der Liste und Mail.
Endpunkt für ein Kontaktformular
„Ein API-Endpunkt, der Name, E-Mail und Nachricht entgegennimmt, prüft, ob die E-Mail gültig ist, alles in einer Tabelle contacts speichert und 201 zurückgibt.“
Trigger: API. Danach Data Validator, Write Data und Simple Output.
Bestellalarm
„Wenn eine Bestellung über die API eingeht, den Bestand in der Tabelle products nachschlagen. Liegt er unter 5, eine Nachricht in unserem Slack posten.“
Trigger: API. Danach Query Data, Condition und ein MCP Server Node, der mit Slack verbunden ist. Siehe Apps.
Testen und Läufe verfolgen
Führen Sie den Workflow im Editor aus, um ihn zu testen. Jeder Lauf, ob aus dem Editor oder live, erscheint in Activity mit Status, Dauer, Ein- und Ausgabe sowie seinen schrittweisen Ausführungsprotokollen.
Nächste Schritte
- So funktionieren Workflows - Nodes, Verbindungen und Variablen
- Trigger - alle Arten, wie ein Workflow starten kann
- API-Referenz - Ihre Workflows aus Ihrem eigenen Code aufrufen