Automatyzacja to wyzwalacz przypisany do workflow. Workflow określa co zrobić; automatyzacja określa kiedy uruchomić kolejne wykonanie.
Automatyzacja wykorzystuje:
- Workflow, wraz z agentem będącym jego właścicielem
- Właściciela, którego czat automatyzacji i połączone dostępy są używane
- Wyzwalacz, taki jak harmonogram, zdarzenie z połączonej usługi lub przychodzący webhook
Co uruchamia się za każdym razem
Każde wyzwolenie rozpoczyna nowy run w czacie automatyzacji dla danego workflow i właściciela. Nie tworzy nowego czatu przy każdym wyzwoleniu. Automatyzacje należące do tego samego członka i tego samego workflow korzystają z tego samego czatu automatyzacji.
Run wykorzystuje bieżącą instrukcję workflow oraz dane wyzwalacza. Ponieważ czat jest współdzielony, wcześniejsze wykonania pozostają w historii wątku. Jeśli zadanie musi działać bezstanowo, należy to określić w instrukcji workflow i wskazać, by używało tylko bieżącego zdarzenia lub określonego przedziału czasu.
Model wybierany jest na wątku czatu automatyzacji, a nie na agencie czy workflow. Gdy czat automatyzacji jest tworzony po raz pierwszy, jego model pochodzi najpierw z domyślnego ustawienia członka, a następnie z domyślnego ustawienia workspace. Kolejne wyzwolenia korzystają z modelu wybranego dla tego wątku.
Otwórz czat automatyzacji, aby sprawdzić jego wykonania, wyniki i widoczne błędy. Nieudane wyzwolenie pozostaje tam widoczne, abyś mógł poprawić workflow, dostęp do konektora lub wyzwalacz i uruchomić je ponownie.
Odniesienie do wyzwalaczy
Wybierak automatyzacji w workflow jest źródłem prawdy na temat tego, jakie automatyzacje są dostępne w bieżącym workspace. Niektóre typy zdarzeń są udostępniane po włączeniu odpowiednich funkcji workspace i dlatego mogą nie być widoczne wszędzie.
Harmonogramy
| Typ | Zachowanie |
|---|---|
| Zaplanowane | Uruchamia się o określonych godzinach według harmonogramu cron i strefy czasowej IANA. |
| Interwał | Oczekuje ustawiony interwał po zakończeniu run, a następnie planuje kolejne wykonanie. Runy nie nakładają się na siebie. |
| Jednorazowe | Uruchamia się w wybranym dniu i godzinie, po czym się wyłącza. |
Przed zapisaniem potwierdź strefę czasową pokazaną w automatyzacji. Użyj zaplanowanej automatyzacji do precyzyjnego czasu, a interwałowej do cyklicznych zapytań, gdzie odstęp po zakończeniu ma znaczenie.
Gmail
| Zdarzenie | Filtry |
|---|---|
| Nowa wiadomość | Opcjonalne filtry: Od, Do, DW, temat i treść. Bez filtrów każda nowa wiadomość kwalifikuje się do uruchomienia. |
| Nadana etykieta | Nazwa jednej etykiety Gmail. |
Zacznij od wąskich filtrów nowych wiadomości, aby ruchliwa skrzynka nie generowała nieoczekiwanej liczby runów.
GitHub
Zdarzenia GitHub wymagają zainstalowania aplikacji Okou GitHub App w Twojej organizacji GitHub. Jeśli nie jest zainstalowana, ekran konfiguracji automatyzacji poinformuje o tym — administrator organizacji zobaczy tam przycisk Install GitHub App, a pozostali zostaną poproszeni o kontakt z administratorem. Po instalacji wszystkie poniższe wyzwalacze GitHub stają się dostępne.
| Zdarzenie | Typowe filtry |
|---|---|
| Pull request | Jedno repozytorium i jedna akcja: otwarty, ponownie otwarty, zamknięty, gotowy do przeglądu, przekonwertowany na draft, zsynchronizowany, dodany do/wyjęty z kolejki merge, oznaczony etykietą lub bez etykiety. Można zawęzić po bazowej gałęzi, autorze, numerze PR lub etykiecie. Dla closed można rozróżnić scalone od zamkniętych bez scalenia. |
| Workflow run completed | Repozytorium, workflow, wynik, gałąź, wyzwalające zdarzenie i aktor. |
| Workflow job completed | Repozytorium, workflow, zadanie, wynik, gałąź, etykieta runnera i grupa runnera. |
| Pull request review submitted | Repozytorium, stan recenzji, bazowa gałąź, gałąź źródłowa i zaufany autor. |
| Deployment status created | Repozytorium, środowisko, stan, ref, twórca, aplikacja i flaga środowiska produkcyjnego. |
| Issue or pull-request comment created | Repozytorium, zakres issue/PR, zaufany autor i prefiks komentarza. |
Nie ma osobnego zdarzenia GitHub label applied. Aby reagować na etykietę PR, wybierz Pull request, zaznacz akcję Labeled i dodaj filtr etykiety.
Google Calendar i Meet
- Utworzone, zaktualizowane lub anulowane wydarzenie kalendarza, ograniczone do wybranego ID kalendarza
- Wygenerowany transkrypt Google Meet, dla spotkań organizowanych przez połączonego członka
Czat i inne integracje
- Zakończony run czatu obserwuje jeden z Twoich wątków czatu. Może filtrować po statusie zakończonym, nieudanym lub anulowanym oraz, dla zakończonych runów, po dopasowaniu wieloznacznika
*(bez rozróżnienia wielkości liter) do końcowej odpowiedzi. - Otrzymany webhook tworzy podpisany przychodzący URL i jest dostępny, gdy plan workspace obejmuje automatyzacje webhooków.
- Przesłana odpowiedź Google Forms, zdarzenia strony/bazy Notion, opublikowany wpis Strapi i opłacona faktura Stripe pojawiają się tylko w workspace'ach, gdzie te funkcje automatyzacji są włączone.
Automatyzacje zdarzeń wymagają również, by odpowiedni konektor lub integracja były połączone i gotowe dla właściciela automatyzacji.
Wiadomości automatyzacji opisują, co się wydarzyło, prostym językiem, a run uruchomiony przez wyzwalacz zakończony run czatu wskazuje na pierwotnego agenta i wątek.
Tworzenie automatyzacji
Z działającego czatu. Najpierw uruchom zadanie jednorazowo. Gdy uzyskasz oczekiwany rezultat, powiedz:
„Uruchamiaj to w każdy dzień roboczy o 8 rano czasu Los Angeles i wyślij mi wynik na DM.”
Okou potwierdzi workflow, częstotliwość i miejsce docelowe, zapisze workflow, jeśli jeszcze nie istnieje, i dołączy automatyzację.
Ręcznie. Otwórz workflow w swoim workspace, kliknij Add automation i wybierz typ wyzwalacza oraz jego filtry. Przydatne, gdy znasz już strukturę i nie chcesz próbnego uruchomienia.
Agent i instrukcja pochodzą z samego workflow, więc wyzwalacz harmonogramu pyta tylko, kiedy uruchomić i w jakiej strefie czasowej.
Automatyzacje można włączać i wyłączać indywidualnie bez ich usuwania — to dobre rozwiązanie przed urlopem lub podczas debugowania głośnego wyzwalacza.
Miejsca docelowe
Automatyzacja musi wiedzieć, gdzie wysłać wynik. Określ to w instrukcji workflow:
- Kanał Slack lub DM — najczęściej; trafia do kanału jako wiadomość lub wątek
- Feishu lub Microsoft Teams — podobnie dla zespołów korzystających z tych narzędzi
- Telegram lub SMS — do osobistych, mobilnych powiadomień
- Strona lub baza Notion — do archiwizacji zamiast publikacji
- Dokument lub arkusz Google — dopisywane lub nadpisywane
- Komentarz do issue lub PR na GitHub — dla workflow inżynierskich
- Szkic Gmail — przygotowany na Twoim koncie do przejrzenia i wysłania
- Strona hostowana — zobacz Strony hostowane
- Plik workspace — gdy artefakt to wideo, obraz lub plik do pobrania
„Opublikuj na #engineering” lub „Wyślij mi na DM” jest jaśniejsze niż „wyślij gdzieś”.
Wskazówki operacyjne
Oto wskazówki z praktyki produkcyjnej:
- Obserwuj pierwsze trzy runy. Automatyzacje łatwo skonfigurować; łatwiej je dopracować, gdy zobaczysz, co Okou faktycznie generuje w Twoim środowisku.
- Dziel zadania na małe części. Długie, wieloetapowe automatyzacje są bardziej podatne na błędy. Jeśli jedna musi aktualizować pięć systemów, rozważ podział na dwie.
- Wskazuj miejsce docelowe. Kanały zmieniają nazwy, ludzie odchodzą. Nazwij miejsce docelowe w instrukcji workflow; Okou ostrzeże, jeśli nie znajdzie go przy kolejnym uruchomieniu.
- Ogranicz czasowo długie zapytania. Jeśli prompt prosi o „ostatnie 30 dni”, powtarzaj to przy każdym runie, by okno było aktualne.
- Potwierdź strefę czasową. Zaplanowane i jednorazowe automatyzacje zapisują wyraźną strefę czasową; sprawdź wartość przed zapisaniem.
- Wstrzymaj przed urlopem. Zwłaszcza dla automatyzacji wysyłających DM — powrót do 14 krótkich DM nie jest użyteczny. Wyłącz automatyzację i włącz ją po powrocie; workflow pozostaje nienaruszony.
Koszty i wolumen
Wyzwolenie automatyzacji uruchamia zwykły run i może zużywać kredyty zgodnie z trasą modelu i używanymi usługami. Przeglądaj czat automatyzacji i Billing przy szacowaniu kosztów.
Krótkie interwały szybko się mnożą: interwał 15 minut może dać do 96 uruchomień dziennie, jeśli każdy run kończy się przed kolejnym. Szerokie filtry zdarzeń mogą być równie głośne. Zacznij od wąskich filtrów, sprawdź pierwsze wyzwolenia, a potem świadomie poszerz filtr lub częstotliwość.
Wyłącz automatyzację, gdy chcesz zatrzymać nowe wyzwolenia bez usuwania workflow lub historii.
Co dalej
- Zobacz Przepływy pracy, aby poznać procedurę uruchamianą przez automatyzację.
- Zobacz Czat, aby dowiedzieć się, co dzieje się w każdym runie.
- Zobacz Przykładowe workflow — pięć kompletnych połączeń workflow z automatyzacją.
