Eine Automatisierung ist ein Trigger, der an einen Workflow angehängt ist. Der Workflow sagt, was zu tun ist; die Automatisierung sagt, wann ein weiterer Lauf gestartet werden soll.
Eine Automatisierung verwendet:
- Einen Workflow mit seinem aktuellen Verfahren
- Einen Eigentümer, dessen Automatisierungs-Chat und verbundener Zugriff verwendet werden
- Einen Trigger, z. B. einen Zeitplan, ein Ereignis aus einem verbundenen Dienst oder einen eingehenden Webhook
Was bei jedem Auslösen ausgeführt wird
Jedes Auslösen startet eine neue Ausführung im Automatisierungs-Chat für diesen Workflow und diesen Eigentümer. Dabei wird nicht bei jedem Auslösen ein brandneuer Chat erstellt. Automatisierungen, die demselben Mitglied für denselben Workflow gehören, verwenden diesen Automatisierungs-Chat erneut.
Die Ausführung verwendet die aktuelle Anweisung des Workflows und die Trigger-Payload. Da der Chat wiederverwendet wird, bleiben frühere Ausführungen in seinem Thread-Verlauf erhalten. Wenn eine Aufgabe zustandslos sein muss, sagen Sie das in der Workflow-Anweisung und weisen Sie sie an, nur das aktuelle Ereignis oder ein explizites Zeitfenster zu verwenden.
Das Modell wird im Automatisierungs-Chat-Thread ausgewählt, nicht im Agent oder im Workflow. Wenn der Automatisierungs-Chat zum ersten Mal erstellt wird, beginnt sein Modell mit dem Standard des Mitglieds und dann mit dem Arbeitsbereich-Standard. Spätere Auslösungen verwenden das für diesen Thread ausgewählte Modell erneut.
Öffnen Sie den Automatisierungs-Chat, um seine Ausführungen, Ausgaben und sichtbaren Fehler zu prüfen. Eine fehlgeschlagene Auslösung bleibt dort sichtbar, damit Sie den Workflow, den Connector-Zugriff oder den Trigger korrigieren und erneut ausführen können.
Trigger-Referenz
Die Automatisierungs-Auswahl in einem Workflow ist die maßgebliche Quelle dafür, was der aktuelle Workspace erstellen kann. Einige Ereignistypen werden hinter Workspace-Feature-Schaltern freigegeben und erscheinen daher nicht überall.
Zeitpläne
| Typ | Verhalten |
|---|---|
| Geplant | Wird zu Uhrzeitpunkten gemäß einem Cron-Zeitplan und einer IANA-Zeitzone ausgeführt. |
| Intervall | Wartet nach Abschluss eines Runs das konfigurierte Intervall ab und plant dann den nächsten Run. Runs überlappen sich nicht mit sich selbst. |
| Einmalig | Wird zum ausgewählten Datum und zur ausgewählten Uhrzeit ausgeführt und deaktiviert sich dann. |
Bestätigen Sie vor dem Speichern die in der Automatisierung angezeigte Zeitzone. Verwenden Sie eine geplante Automatisierung für die Uhrzeitlogik und eine Intervall-Automatisierung für Polling, bei dem der Abstand nach Abschluss wichtig ist.
Gmail
| Ereignis | Filter |
|---|---|
| Neue Nachricht | Optionale Matcher für Von, An, Cc, Betreff und Textkörper. Ohne Matcher ist jede neue Nachricht zulässig. |
| Label angewendet | Ein Gmail-Labelname. |
Beginnen Sie mit engen Filtern für neue Nachrichten, damit ein stark genutzter Posteingang nicht unerwartet viele Runs erzeugt.
GitHub
GitHub-Ereignisse erfordern, dass Okous GitHub App in Ihrer GitHub-Organisation installiert ist. Falls nicht, steht das auf dem Einrichtungsbildschirm der Automatisierung — ein Organisations-Admin erhält dort einen GitHub App installieren-Button, und allen anderen wird gesagt, einen Admin zu fragen. Installieren Sie sie einmal, und jeder der folgenden GitHub-Trigger wird verfügbar.
| Ereignis | Häufige Filter |
|---|---|
| Pull Request | Ein Repository und eine Aktion: geöffnet, erneut geöffnet, geschlossen, zur Überprüfung bereit, in Draft konvertiert, synchronisiert, zur Merge-Queue hinzugefügt oder daraus entfernt, gelabelt oder ungelabelt. Eingrenzung nach Basis-Branch, Autor, PR-Nummer oder Label. Für closed können Sie zwischen zusammengeführt und geschlossen unterscheiden, ohne zusammenzuführen. |
| Workflow Run abgeschlossen | Repository, Workflow, Conclusion, Branch, auslösendes Ereignis und Actor. |
| Workflow-Job abgeschlossen | Repository, Workflow, Job, Conclusion, Branch, Runner-Label und Runner-Gruppe. |
| Pull-Request-Review übermittelt | Repository, Review-Status, Basis-Branch, Head-Branch und vertrauenswürdiger Autor. |
| Deployment-Status erstellt | Repository, Umgebung, Status, Ref, Ersteller, App und Flag für Produktionsumgebung. |
| Issue- oder Pull-Request-Kommentar erstellt | Repository, Issue/PR-Umfang, vertrauenswürdiger Autor und Kommentarpräfix. |
Es gibt kein separates Ereignis GitHub-Label angewendet. Um auf ein PR-Label zu reagieren, wählen Sie Pull Request, die Aktion Gelabelt und fügen Sie einen Label-Filter hinzu.
Google Kalender und Meet
- Kalenderereignis erstellt, aktualisiert oder storniert, begrenzt auf die von Ihnen gewählte Kalender-ID
- Google-Meet-Transkript erstellt, für Besprechungen, die vom verbundenen Mitglied organisiert wurden
Chat und andere Integrationen
- Chat-Run beendet überwacht einen Ihrer Chat-Threads. Er kann nach dem Status abgeschlossen, fehlgeschlagen oder storniert filtern und, bei abgeschlossenen Runs, nach einer nicht zwischen Groß- und Kleinschreibung unterscheidenden
*-Platzhalterübereinstimmung gegen die letzte Antwort. - Webhook empfangen erstellt eine signierte eingehende URL und ist verfügbar, wenn der Workspace-Plan Webhook-Automatisierungen umfasst.
- Google-Forms-Antwort gesendet, Notion-Seiten-/Datenbankereignisse, Strapi-Eintrag veröffentlicht und Stripe-Rechnung bezahlt erscheinen nur in Workspaces, in denen diese Automatisierungsfunktionen aktiviert sind.
Ereignis-Automatisierungen erfordern außerdem, dass der relevante Connector oder die Integration mit dem Automatisierungs-Eigentümer verbunden und bereit ist.
Automatisierungsnachrichten beschreiben in Klartext, was passiert ist, und ein durch einen Trigger Chat-Run beendet gestarteter Run verweist zurück auf den ursprünglichen Thread.
Eine Automatisierung erstellen
Aus einem Chat, der funktioniert. Führen Sie die Aufgabe zuerst einmalig aus. Wenn sie das gewünschte Ergebnis liefert, sagen Sie:
"Führe das jeden Werktag um 8 Uhr Los-Angeles-Zeit aus und schicke mir das Ergebnis per DM."
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. Öffnen Sie einen Workflow in Ihrem Workspace, klicken Sie auf Automatisierung hinzufügen und wählen Sie den Trigger-Typ und seine Filter. Nützlich, wenn Sie die Form im Voraus kennen und keinen Testlauf möchten.
Das Verfahren stammt aus dem Workflow. In My Okou verwendet die Ausführung die persönlichen Anweisungen (Instructions), das Gedächtnis, die verbundenen Konten und die Berechtigungen des Eigentümers der Automatisierung in diesem Arbeitsbereich. In Legacy Agents stellt der Agent des Eigentümers den Agent-Kontext bereit. Ein Zeitplan-Trigger fragt, wann ausgeführt werden soll und in welcher Zeitzone.
Ein öffentlicher Workflow teilt eine Methode, nicht die Automatisierungen oder den Zugriff seines Erstellers. Jedes Mitglied erstellt und verwaltet seine eigenen Automatisierungen. Gehen Sie nicht davon aus, dass das Kopieren eines Workflows die Trigger, Anmeldedaten oder den Automatisierungs-Chat eines anderen Mitglieds mit überträgt.
Automatisierungen können einzeln aktiviert und deaktiviert werden, ohne sie zu löschen — der richtige Schritt vor einem Urlaub oder während Sie einen lauten Trigger debuggen.
Ziele
Eine Automatisierung muss wissen, wohin das Ergebnis geht. Geben Sie es in der Workflow-Anweisung an:
- Slack-Kanal oder DM — am häufigsten; landet im Kanal als Nachricht oder Thread
- Feishu oder Microsoft Teams — derselbe Gedanke für Teams, die dort arbeiten
- Telegram oder SMS — für persönliche, mobilorientierte Benachrichtigungen
- Eine Notion-Seite oder -Datenbank — für Dinge, die archiviert statt verbreitet 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 Ihrem Konto vorbereitet, damit Sie ihn prüfen und senden können
- Eine gehostete Seite — siehe Gehostete Websites
- Eine Datei im Arbeitsbereich — wenn das Artefakt ein Video, ein Bild oder ein herunterladbares Asset ist
"Poste nach #engineering" oder "schick mir eine DM" ist klarer als "schick es irgendwohin".
Betriebstipps
Diese stammen aus dem produktiven Einsatz von Automatisierungen:
- Beobachten Sie die ersten drei Runs. Automatisierungen sind leicht einzurichten; sie lassen sich noch leichter verfeinern, sobald Sie sehen, was Okou in Ihrer Umgebung tatsächlich erzeugt.
- Halten Sie jede Aufgabe klein. Lange, mehrstufige Automatisierungen sind fragiler. Wenn eine einzige fünf Systeme aktualisieren muss, sollten Sie sie in zwei aufteilen.
- Fixieren Sie das Ziel. Kanäle werden umbenannt und Personen gehen. Benennen Sie das Ziel in der Workflow-Anweisung explizit; Okou warnt Sie, wenn es beim nächsten Run nicht gefunden werden kann.
- Zeitlich begrenzte Langlaufabfragen. Wenn die Aufforderung "die letzten 30 Tage" verlangt, formulieren Sie das bei jedem Run neu, damit das Zeitfenster aktuell bleibt.
- Zeitzone bestätigen. Geplante und einmalige Automatisierungen speichern eine explizite Zeitzone; prüfen Sie den angezeigten Wert vor dem Speichern.
- Vor Urlaub pausieren. Besonders bei Automatisierungen, die Ihnen eine DM schicken — zu 14 kurzen DMs zurückzukehren ist nicht hilfreich. Deaktivieren Sie die Automatisierung und aktivieren Sie sie wieder, wenn Sie zurück sind; der Workflow bleibt erhalten.
Kosten und Volumen
Ein Auslösen einer Automatisierung startet einen normalen Run und kann je nach Modellroute und verwendeten Diensten Credits verbrauchen. Prüfen Sie den Automatisierungs-Chat und Abrechnung, wenn Sie die Kosten abschätzen.
Kurze Intervalle vervielfachen sich schnell: Ein Intervall von 15 Minuten kann bis zu 96-mal an einem Tag laufen, wenn jeder Run endet, bevor das nächste Intervall abläuft. Breite Ereignisfilter können ebenso laut sein. Beginnen Sie eng, prüfen Sie die ersten wenigen Auslösungen und erweitern Sie den Filter oder das Intervall dann gezielt.
Deaktivieren Sie eine Automatisierung, wenn Sie neue Auslösungen stoppen möchten, ohne ihren Workflow oder Verlauf zu löschen.
Was als Nächstes
- Siehe Workflows für das Verfahren, das eine Automatisierung ausführt.
- Siehe Chat für das, was innerhalb jedes Runs geschieht.
- Siehe Beispiel-Workflows für fünf vollständige Workflow-und-Automatisierungs-Kombinationen.
