Workflows und Aufträge

Ein Workflow ist eine Kette von Schritten, die Ihre Agenten für Sie ausführen: jeden Morgen die neuen Nachrichten eines Kontexts lesen und eine Zusammenfassung posten, eingehende Dokumente lesen und die Daten herausziehen, auf einen Webhook aus einem anderen System antworten. Sie bauen ihn einmal in SweetHive, danach läuft er von selbst.

Workflows laufen auf Ihren eigenen Computern, nicht in der Cloud: auf Ihrem SweetHive Agents Node oder auf dem Agents Server Ihres Unternehmens. Die KI-Modelle, die Dokumente und die verarbeiteten Daten bleiben auf diesen Rechnern.

Alles, was für Sie läuft, steht unter My agents, Aufträge: Ihre Workflows und die Anfragen von SweetHive-Apps (zum Beispiel SweetTimetable, das Ihre Belege liest, oder SweetReach, das ein Video rendert).

Einen Workflow erstellen

1. Öffnen Sie My agents und wählen Sie den Tab Workflows.
2. Klicken Sie auf Neuer Workflow. Der Editor öffnet sich mit einer Arbeitsfläche:
   • links die Liste der Schritte, die Sie hinzufügen können;
   • in der Mitte die Arbeitsfläche mit Ihren Schritten und den Verbindungen zwischen ihnen;
   • rechts die Einstellungen des ausgewählten Schritts.
3. Klicken Sie auf einen Schritt in der Liste, um ihn nach dem ausgewählten einzufügen. Um zwei Schritte zu verbinden, ziehen Sie vom Punkt rechts an einem Schritt zu einem anderen Schritt.
4. Wählen Sie den Agenten, mit dem der Workflow läuft (obere Leiste). Schritte, die in Ihren Hives lesen oder posten, nutzen diesen Agenten - der Workflow sieht also nie mehr, als der Agent sehen darf.
5. Speichern Sie. Jede Änderung an den Schritten speichert eine neue Version; bereits gestartete Ausführungen behalten die Version, mit der sie begonnen haben.
6. Klicken Sie auf Ausführen, um ihn zu testen: Jeder Schritt auf der Arbeitsfläche zeigt seinen Status live (wartet, läuft, erledigt, fehlgeschlagen) und, sobald er fertig ist, sein Ergebnis.

Wann ein Workflow startet

Wählen Sie den ersten Schritt (den Auslöser), um festzulegen, wie der Workflow startet:

• Manuell - wenn Sie auf Ausführen klicken, im Editor oder in der Workflow-Liste.
• Geplant - zu festen Zeiten: jede Stunde, jeden Tag um 8:00, Montag bis Freitag um 9:00 oder nach einem beliebigen selbst geschriebenen Zeitplan (cron) in Ihrer Zeitzone.
• Hive-Ereignis - wenn es in einem Hive eine neue Nachricht, Datei, Aufgabe, einen neuen Termin oder eine neue E-Mail gibt (wahlweise nur in einem Kontext).
• Webhook - wenn ein anderes System die URL des Workflows aufruft. Das Geheimnis wird nur einmal angezeigt: Kopieren Sie es beim Erstellen.
• App-Ereignis - wenn eine verbundene App ein Ereignis auslöst (zum Beispiel ein neuer Lead in SweetCRM).

Mit dem Schalter Aktiv können Sie einen Workflow jederzeit pausieren.

Die Schritte

Ein Schritt kann die Ergebnisse der vorherigen verwenden. Fügen Sie in jedem Textfeld eine Variable über die Schaltflächen unter den Einstellungen ein, zum Beispiel {{ $steps.summary.output.text }} (der vom Schritt summary generierte Text) oder {{ $trigger }} (was den Workflow gestartet hat). Sie müssen keinen Code schreiben.

Wo die Schritte laufen

Jeder Schritt läuft auf einem Ihrer Computer:

• standardmäßig bleibt er auf demselben Computer wie der vorherige Schritt (das Modell ist schon geladen, die Dateien sind schon da);
• er wechselt auf einen anderen Computer, wenn er etwas braucht, das der erste nicht hat: ein Modell, das Bilder sieht, einen größeren Kontext, einen Render-Worker. Sie können einen Schritt auch auf jedem verfügbaren Computer laufen lassen (Wo er läuft in seinen Einstellungen).

Wenn gerade keiner Ihrer Computer einen Schritt ausführen kann, wartet der Auftrag und sagt Ihnen, warum (zum Beispiel Wartet auf einen deiner Computer: öffne SweetHive Agents Node, dann startet er von selbst). Er startet von selbst, sobald ein geeigneter Computer online ist.

Ihre Aufträge verfolgen

My agents, Aufträge listet, was gerade läuft und was gelaufen ist, das Neueste zuerst. Jeder Auftrag zeigt, wer ihn gestartet hat (ein Workflow oder eine App), wie viele Schritte erledigt sind, welcher Computer ihn ausführt und, wenn etwas schiefgeht, den Grund in einfachen Worten: Das Modell ist nicht installiert, das Dokument ist zu lang für das Modell, der Link zur Datei ist abgelaufen, der Computer antwortet nicht mehr.

• Abbrechen stoppt einen wartenden oder laufenden Auftrag.
• Erneut versuchen führt einen fehlgeschlagenen oder abgebrochenen Auftrag noch einmal aus.
• Öffnen Sie einen Auftrag, um jeden Schritt zu sehen, den verwendeten Computer und das Modell, die Dauer und das Ergebnis.

Liegt das Problem am Computer (ein fehlendes Modell, ein zu kleiner Kontext, der Computer ist ausgeschaltet), verbraucht der Auftrag keine Versuche: Er wechselt auf einen anderen Computer oder wartet. Liegt das Problem an den Eingabedaten (ein unlesbares Dokument, eine Antwort, die das Modell nicht richtig formatieren konnte), wird er einmal wiederholt und dann gemeldet.

Der SweetHive Agents Node zeigt dieselbe Liste in seinem Bereich Aufträge: was er gerade tut und was er zuletzt getan hat.

Datenschutz

• Ein Workflow läuft als einer Ihrer Agenten: Er sieht nur die Hives und Kontexte, die dieser Agent sehen darf, und kann nur posten, wenn dieser Agent posten darf.
• KI-Schritte laufen auf Ihren Computern mit lokalen Modellen.
• Dateien, die zwischen Schritten weitergegeben werden, bleiben 7 Tage gespeichert und werden dann gelöscht. Links zu Dokumenten, die von Apps gesendet werden, erscheinen nie in den Auftragslisten.