Eine Automatisierung ist ein Trigger, der an einen Workflow angehängt ist. Der Workflow sagt, was zu tun ist; die Automatisierung sagt, wann ein neuer Run gestartet wird.
Eine Automatisierung verwendet:
- Einen Workflow, einschließlich des Agents, dem er gehört
- Einen Besitzer, dessen Automatisierungs-Chat und verbundene Zugänge verwendet werden
- Einen Trigger, etwa einen Zeitplan, ein Ereignis eines verbundenen Dienstes oder einen eingehenden Webhook
Was bei jedem Auslösen passiert
Jedes Auslösen startet einen neuen Run im Automatisierungs-Chat für diesen Workflow und Besitzer. Es wird nicht bei jedem Auslösen ein komplett neuer Chat erstellt. Automatisierungen desselben Mitglieds für denselben Workflow verwenden denselben Automatisierungs-Chat erneut.
Der Run verwendet die aktuelle Anweisung des Workflows und die Trigger-Nutzdaten. Da der Chat wiederverwendet wird, bleiben frühere Runs im Thread-Verlauf erhalten. Wenn eine Aufgabe zustandslos ablaufen muss, sag das in der Workflow-Anweisung und weise Okou an, nur das aktuelle Ereignis oder ein explizites Zeitfenster zu verwenden.
Das Modell wird im Automatisierungs-Chat-Thread ausgewählt, nicht am Agent oder Workflow. Wenn der Automatisierungs-Chat zum ersten Mal erstellt wird, beginnt sein Modell mit dem Mitglieds-Standard und dann dem Workspace-Standard. Spätere Auslösungen verwenden das für diesen Thread gewählte Modell erneut.
Öffne den Automatisierungs-Chat, um seine Runs, Ausgaben und sichtbaren Fehler zu prüfen. Ein fehlgeschlagenes Auslösen bleibt dort sichtbar, damit du den Workflow, den Konnektor-Zugang oder den Trigger korrigieren und erneut ausführen kannst.
Trigger-Referenz
Die Automatisierungs-Auswahl an einem Workflow ist die Quelle der Wahrheit dafür, was der aktuelle Workspace erstellen kann. Einige Ereignistypen werden hinter Workspace-Feature-Schaltern veröffentlicht und erscheinen daher möglicherweise nicht überall.
Zeitpläne
| Typ | Verhalten |
|---|---|
| Geplant | Läuft zu Wanduhr-Zeiten mit einem Cron-Zeitplan und einer IANA-Zeitzone. |
| Intervall | Wartet nach Abschluss eines Runs das konfigurierte Intervall und plant dann den nächsten Run. Runs überschneiden sich nicht mit sich selbst. |
| Einmalig | Läuft zum gewählten Datum und zur gewählten Uhrzeit und deaktiviert sich danach selbst. |
Bestätige die in der Automatisierung angezeigte Zeitzone vor dem Speichern. Verwende eine geplante Automatisierung für Wanduhr-Zeiten und eine Intervall-Automatisierung für Polling, bei dem der Abstand nach dem Abschluss zählt.
Gmail
| Ereignis | Filter |
|---|---|
| Neue Nachricht | Optionale Matcher für Von, An, Cc, Betreff und Nachrichtentext. Ohne Matcher ist jede neue Nachricht berechtigt. |
| Label angewendet | Ein Gmail-Label-Name. |
Beginne mit engen Neue-Nachricht-Filtern, damit ein volles Postfach keine unerwartete Anzahl an Runs erzeugt.
GitHub
| Ereignis | Häufige Filter |
|---|---|
| Pull Request | Ein Repository und eine Aktion: opened, reopened, closed, ready for review, converted to draft, synchronized, added to or removed from the merge queue, labeled oder unlabeled. Eingrenzen nach Base-Branch, Autor, PR-Nummer oder Label. Bei closed kannst du merged von closed without merging unterscheiden. |
| Workflow run completed | Repository, Workflow, Conclusion, Branch, auslösendes Ereignis und Actor. |
| Workflow job completed | Repository, Workflow, Job, Conclusion, Branch, Runner-Label und Runner-Gruppe. |
| Pull request review submitted | Repository, Review-Status, Base-Branch, Head-Branch und vertrauenswürdiger Autor. |
| Deployment status created | Repository, Umgebung, Status, Ref, Ersteller, App und Produktionsumgebungs-Flag. |
| Issue or pull-request comment created | Repository, Issue/PR-Bereich, vertrauenswürdiger Autor und Kommentar-Präfix. |
Es gibt kein separates GitHub-Label-angewendet-Ereignis. Um auf ein PR-Label zu reagieren, wähle Pull Request, wähle die Aktion Labeled und füge einen Label-Filter hinzu.
Google Calendar und Meet
- Calendar event created, updated oder cancelled, begrenzt auf die von dir gewählte Kalender-ID
- Google Meet transcript generated, für Meetings, die vom verbundenen Mitglied organisiert wurden
Chat und andere Integrationen
- Chat run finished beobachtet einen deiner Chat-Threads. Es kann nach dem Status completed, failed oder cancelled filtern und, für abgeschlossene Runs, nach einem case-insensitiven
*-Wildcard-Muster, das gegen die finale Antwort abgeglichen wird. - Webhook received erstellt eine signierte eingehende URL und ist verfügbar, wenn der Workspace-Plan Webhook-Automatisierungen enthält.
- Google Forms response submitted, Notion page/database events, Strapi entry published und Stripe invoice paid erscheinen nur in Workspaces, in denen diese Automatisierungsfunktionen aktiviert sind.
Ereignis-Automatisierungen setzen außerdem voraus, dass der jeweilige Konnektor oder die Integration für den Automatisierungs-Besitzer verbunden und bereit ist.
Eine Automatisierung erstellen
Aus einem funktionierenden Chat. Führe die Aufgabe zuerst einmalig aus. Wenn sie liefert, was du willst, sag:
"Run this every weekday at 8 a.m. Los Angeles time and DM me the result."
Okou bestätigt den Workflow, den Rhythmus und das Ziel, speichert den Workflow, falls er noch nicht existiert, und hängt die Automatisierung an.
Explizit. Öffne einen Workflow in deinem Workspace und füge ihm eine Automatisierung hinzu, wähle den Triggertyp und seine Filter. Nützlich, wenn du die Form bereits kennst und keinen Trockenlauf möchtest.
Automatisierungen lassen sich einzeln aktivieren und deaktivieren, ohne sie zu löschen — der richtige Schritt vor einem Urlaub oder während du einen lauten Trigger debugst.
Ziele
Eine Automatisierung muss wissen, wohin das Ergebnis geht. Sag es in der Workflow-Anweisung:
- Slack-Kanal oder DM — am häufigsten; landet im Kanal als Nachricht oder Thread
- Feishu oder Microsoft Teams — dasselbe Prinzip für Teams, die dort leben
- Telegram oder SMS — für persönliche, mobile-first Benachrichtigungen
- Eine Notion-Seite oder -Datenbank — für Dinge, die archiviert statt gesendet werden sollen
- Ein Google Doc oder Sheet — angehängt oder überschrieben
- Ein GitHub-Issue oder PR-Kommentar — für Engineering-Workflows
- Ein Gmail-Entwurf — in deinem Konto vorbereitet, damit du ihn prüfen und senden kannst
- Eine gehostete Seite — siehe Hosted sites
- Eine Workspace-Datei — wenn das Artefakt ein Video, Bild oder herunterladbares Asset ist
"Post to #engineering" oder "DM me" ist klarer als "send it somewhere."
Betriebstipps
Diese stammen aus dem Produktivbetrieb von Automatisierungen:
- Beobachte die ersten drei Runs. Automatisierungen sind leicht einzurichten; sie lassen sich noch leichter verfeinern, sobald du siehst, was Okou in deiner Umgebung tatsächlich erzeugt.
- Halte jede Aufgabe klein. Lange, mehrstufige Automatisierungen sind anfälliger. Wenn eine einzige fünf Systeme aktualisieren muss, erwäge, sie in zwei zu teilen.
- Lege das Ziel fest. Kanäle werden umbenannt und Leute gehen. Nenne das Ziel explizit in der Workflow-Anweisung; Okou warnt, wenn es das Ziel beim nächsten Run nicht findet.
- Begrenze lange laufende Abfragen zeitlich. Wenn der Prompt nach „den letzten 30 Tagen" fragt, wiederhole das bei jedem Run, damit das Fenster aktuell bleibt.
- Bestätige die Zeitzone. Geplante und einmalige Automatisierungen speichern eine explizite Zeitzone; prüfe den angezeigten Wert vor dem Speichern.
- Pausiere vor Urlauben. Besonders bei Automatisierungen, die dir DMs schicken — mit 14 kurzen DMs zurückzukommen ist nicht nützlich. Deaktiviere die Automatisierung und aktiviere sie wieder, wenn du zurück bist; der Workflow bleibt intakt.
Kosten und Volumen
Ein Automatisierungs-Auslösen startet einen normalen Run und kann Credits verbrauchen, je nach Modell-Route und genutzten Diensten. Prüfe den Automatisierungs-Chat und Billing, wenn du die Kosten schätzt.
Kurze Intervalle vervielfachen sich schnell: Ein Intervall von 15 Minuten kann bis zu 96-mal am Tag laufen, wenn jeder Run vor dem nächsten Intervall endet. Breite Ereignisfilter können ebenso laut sein. Beginne eng, prüfe die ersten Auslösungen und weite den Filter oder Rhythmus dann bewusst aus.
Deaktiviere eine Automatisierung, wenn du neue Auslösungen stoppen willst, ohne ihren Workflow oder Verlauf zu löschen.
Weiter
- Siehe Workflows für die Prozedur, die eine Automatisierung ausführt.
- Siehe Chat für das, was in jedem Run passiert.
- Siehe Example workflows für fünf vollständige Workflow-plus-Automatisierung-Kombinationen.