Automatyzacja to wyzwalacz dołączony do przepływu pracy. Przepływ pracy mówi, co zrobić; automatyzacja mówi, kiedy uruchomić kolejne wykonanie.
Automatyzacja korzysta z:
- Przepływ pracy, z jego bieżącą procedurą
- Właściciel, którego czat automatyzacji i podłączony dostęp są używane
- Wyzwalacz, taki jak harmonogram, zdarzenie z podłączonej usługi lub przychodzący webhook
Co uruchamia się za każdym razem
Każde wywołanie rozpoczyna nowe uruchomienie w czacie automatyzacji dla tego workflow i właściciela. Nie tworzy za każdym razem zupełnie nowego czatu. Automatyzacje należące do tego samego członka dla tego samego workflow ponownie używają tego czatu automatyzacji.
Uruchomienie korzysta z bieżącej instrukcji workflow i ładunku wyzwalacza. Ponieważ czat jest ponownie używany, wcześniejsze uruchomienia pozostają w historii wątku. Jeśli zadanie musi działać bezstanowo, napisz to w instrukcji workflow i poleć mu używać wyłącznie bieżącego zdarzenia albo jawnego przedziału czasowego.
Model jest wybierany w wątku czatu automatyzacji, a nie w agencie ani w workflow. Gdy czat automatyzacji jest tworzony po raz pierwszy, jego model zaczyna od domyślnego dla członka, a następnie od domyślnego dla obszaru roboczego. Późniejsze wywołania ponownie używają modelu wybranego dla tego wątku.
Otwórz czat automatyzacji, aby sprawdzić jego uruchomienia, wyniki i widoczne błędy. Nieudane wywołanie pozostaje tam widoczne, dzięki czemu możesz poprawić workflow, dostęp konektora lub wyzwalacz i uruchomić je ponownie.
Referencja wyzwalaczy
Selektor automatyzacji w przepływie pracy jest źródłem prawdy o tym, co bieżący obszar roboczy może utworzyć. Niektóre typy zdarzeń są udostępniane za przełącznikami funkcji obszaru roboczego, więc mogą nie pojawiać się wszędzie.
Harmonogramy
| Typ | Zachowanie |
|---|---|
| Zaplanowane | Uruchamia się o godzinach czasu ściennego, używając harmonogramu cron i strefy czasowej IANA. |
| Interwał | Czeka na skonfigurowany interwał po zakończeniu uruchomienia, a następnie planuje następne uruchomienie. Uruchomienia nie nakładają się na siebie. |
| Jednorazowo | Uruchamia się o wybranej dacie i godzinie, a następnie samo się wyłącza. |
Przed zapisaniem potwierdź strefę czasową widoczną w automatyzacji. Użyj automatyzacji zaplanowanej do czasu ściennego, a automatyzacji interwałowej do odpytywania, gdy ważne jest odstępowanie po zakończeniu.
Gmail
| Zdarzenie | Filtry |
|---|---|
| Nowa wiadomość | Opcjonalne dopasowania Od, Do, Cc, Temat i treści. Bez dopasowań każda nowa wiadomość kwalifikuje się. |
| Zastosowano etykietę | Jedna nazwa etykiety Gmail. |
Zacznij od wąskich filtrów dla nowych wiadomości, aby zajęta skrzynka odbiorcza nie tworzyła nieoczekiwanej liczby uruchomień.
GitHub
Zdarzenia GitHub wymagają zainstalowania aplikacji GitHub firmy Okou w Twojej organizacji GitHub. Jeśli nie jest zainstalowana, ekran konfiguracji automatyzacji to wyraźnie pokaże — administrator organizacji otrzymuje tam przycisk Install GitHub App, a wszystkim innym wyświetla się prośba o kontakt z administratorem. Zainstaluj ją raz, a poniższe wyzwalacze GitHub staną się dostępne.
| Zdarzenie | Typowe filtry |
|---|---|
| Pull request | Jedno repozytorium i jedno działanie: otwarto, otwarto ponownie, zamknięto, gotowe do przeglądu, przekonwertowano na wersję roboczą, zsynchronizowano, dodano do kolejki scalania lub z niej usunięto, oznaczono etykietą lub usunięto etykietę. Zawęź według gałęzi bazowej, autora, numeru PR lub etykiety. W przypadku closed możesz odróżnić scalenie od zamknięcia bez scalenia. |
| Zakończono uruchomienie workflow | Repozytorium, workflow, wynik, gałąź, zdarzenie wyzwalające i wykonawca. |
| Zakończono zadanie workflow | Repozytorium, workflow, zadanie, wynik, gałąź, etykieta runnera i grupa runnerów. |
| Przesłano przegląd pull requesta | Repozytorium, stan przeglądu, gałąź bazowa, gałąź źródłowa i zaufany autor. |
| Utworzono status wdrożenia | Repozytorium, środowisko, stan, ref, twórca, aplikacja i flaga środowiska produkcyjnego. |
| Utworzono komentarz do zgłoszenia lub pull requesta | Repozytorium, zakres zgłoszenia/PR, zaufany autor i prefiks komentarza. |
Nie istnieje osobne zdarzenie GitHub label applied. Aby reagować na etykietę PR, wybierz Pull request, wybierz akcję Labeled i dodaj filtr etykiety.
Google Calendar i Meet
- Calendar event created, updated lub cancelled, w zakresie identyfikatora kalendarza, który wybierzesz
- Google Meet transcript generated, dla spotkań zorganizowanych przez podłączonego członka
Chat i inne integracje
- Chat run finished obserwuje jeden z Twoich wątków czatu. Może filtrować według stanu completed, failed lub cancelled, a dla ukończonych uruchomień — case-insensitive wildcard
*dopasowany do końcowej odpowiedzi. - Webhook received tworzy podpisany przychodzący adres URL i jest dostępny, gdy plan obszaru roboczego obejmuje automatyzacje webhooków.
- Google Forms response submitted, Notion page/database events, Strapi entry published i Stripe invoice paid pojawiają się tylko w obszarach roboczych, w których te funkcje automatyzacji są włączone.
Automatyzacje zdarzeń wymagają również, aby odpowiedni konektor lub integracja był podłączony i gotowy dla właściciela automatyzacji.
Wiadomości automatyzacji opisują, co się wydarzyło, prostym językiem, a uruchomienie rozpoczęte przez wyzwalacz chat run finished odsyła do wątku źródłowego.
Tworzenie automatyzacji
Z czatu, który działa. Najpierw uruchom zadanie jednorazowo. Gdy da to wynik, którego chcesz, napisz:
"Uruchamiaj to w każdy dzień roboczy o 8 rano czasu Los Angeles i wyślij mi wynik na DM."
Okou potwierdza workflow, częstotliwość i miejsce docelowe, zapisuje workflow, jeśli jeszcze nie istnieje, i dołącza automatyzację.
Wprost. Otwórz przepływ pracy w swoim obszarze roboczym, kliknij Add automation i wybierz typ wyzwalacza oraz jego filtry. Przydatne, gdy znasz już docelowy kształt i nie chcesz próbnego uruchomienia.
Procedura pochodzi z przepływu pracy. W My Okou uruchomienie korzysta z osobistych Instructions właściciela automatyzacji, pamięci, podłączonych kont i uprawnień w tym obszarze roboczym. W Legacy Agents kontekst agenta dostarcza należący do niego Agent. Wyzwalacz harmonogramu pyta, kiedy uruchomić i w jakiej strefie czasowej.
Publiczny przepływ pracy udostępnia metodę, a nie automatyzacje ani dostęp swojego twórcy. Każdy członek tworzy i zarządza własnymi automatyzacjami. Nie zakładaj, że skopiowanie przepływu pracy przenosi wyzwalacze, poświadczenia ani czat automatyzacji innego członka.
Automatyzacje można indywidualnie włączać i wyłączać bez ich usuwania — to właściwy ruch przed urlopem albo podczas debugowania hałaśliwego wyzwalacza.
Miejsca docelowe
Automatyzacja musi wiedzieć, dokąd trafia wynik. Podaj to w instrukcji workflow:
- Kanał Slack lub wiadomość bezpośrednia — najczęściej; trafia do kanału jako wiadomość lub wątek
- Feishu lub Microsoft Teams — to samo dla zespołów, które tam pracują
- Telegram lub wiadomość tekstowa — do osobistych alertów nastawionych na urządzenia mobilne
- Strona lub baza danych Notion — dla rzeczy, które powinny być archiwizowane zamiast publicznie rozpowszechniane
- Dokument lub arkusz Google — do dopisywania lub nadpisywania
- Komentarz do issue lub PR na GitHub — dla przepływów pracy inżynierskich
- Szkic Gmail — przygotowany na Twoim koncie do przejrzenia i wysłania
- Hostowana strona — zobacz Hostowane strony
- Plik obszaru roboczego — gdy artefakt to wideo, obraz lub zasób do pobrania
„Opublikuj w #engineering” lub „wyślij mi na DM” jest jaśniejsze niż „wyślij to gdzieś.”
Wskazówki operacyjne
Poniższe wskazówki pochodzą z uruchamiania automatyzacji w produkcji:
- Obserwuj pierwsze trzy uruchomienia. Automatyzacje są łatwe do skonfigurowania; jeszcze łatwiej je dopracować, gdy zobaczysz, co Okou rzeczywiście produkuje w Twoim środowisku.
- Utrzymuj każde zadanie małe. Długie, wieloetapowe automatyzacje są bardziej podatne na awarie. Jeśli jedna ma aktualizować pięć systemów, rozważ podzielenie jej na dwie.
- Przypnij miejsce docelowe. Kanały są zmieniane, a ludzie odchodzą. Nazwij miejsce docelowe wprost w instrukcji przepływu pracy; Okou ostrzeże, jeśli nie będzie mógł go znaleźć przy następnym uruchomieniu.
- Ogranicz czasowo długotrwałe zapytania. Jeśli prompt prosi o „ostatnie 30 dni”, powtarzaj to przy każdym uruchomieniu, aby okno pozostało aktualne.
- Potwierdź strefę czasową. Zaplanowane i jednorazowe automatyzacje zapisują jawną strefę czasową; sprawdź wartość widoczną przed zapisaniem.
- Wstrzymaj przed urlopem. Zwłaszcza w przypadku automatyzacji, które wysyłają Ci DM — powrót do 14 krótkich DM-ów nie jest pomocny. Wyłącz automatyzację i włącz ją ponownie po powrocie; przepływ pracy pozostaje nienaruszony.
Koszty i wolumen
Wywołanie automatyzacji rozpoczyna normalne uruchomienie i może zużywać kredyty zgodnie z trasą modelu i używanymi usługami. Przejrzyj czat automatyzacji i Rozliczenia, szacując koszt.
Krótkie interwały szybko się kumulują: interwał 15 minut może uruchomić się do 96 razy w ciągu dnia, jeśli każde uruchomienie zakończy się przed upływem następnego interwału. Szerokie filtry zdarzeń mogą być równie hałaśliwe. Zacznij wąsko, sprawdź pierwszych kilka wywołań, a potem celowo poszerz filtr lub częstotliwość.
Wyłącz automatyzację, gdy chcesz zatrzymać nowe wywołania bez usuwania jej przepływu pracy lub historii.
Co dalej
- Zobacz Przepływy pracy, aby poznać procedurę uruchamianą przez automatyzację.
- Zobacz Czat, aby sprawdzić, co dzieje się w każdym uruchomieniu.
- Zobacz Przykładowe przepływy pracy, aby poznać pięć kompletnych kombinacji przepływu pracy i automatyzacji.
