Automatizace je spouštěč připojený k workflow. Workflow říká, co se má udělat; automatizace říká, kdy se má spustit další běh.
Automatizace používá:
- Pracovní postup, s jeho aktuálním postupem
- Vlastník, jehož automatizační chat a připojený přístup se používají
- Spouštěč, například plán, událost z připojené služby nebo příchozí webhook
Co se spustí při každém vyvolání
Každé vyvolání spustí nový běh v automatizačním chatu pro dané workflow a vlastníka. Při každém vyvolání nevytváří zcela nový chat. Automatizace vlastněné stejným členem pro stejné workflow znovu používají tento automatizační chat.
Běh používá aktuální instrukci pracovního postupu a payload spouštěče. Protože se chat znovu používá, předchozí běhy zůstávají v historii vlákna. Pokud se úloha musí chovat bez stavu, uveďte to v instrukci pracovního postupu a řekněte jí, aby používala jen aktuální událost nebo explicitní časové okno.
Model se vybírá ve vlákně automatizačního chatu, ne u agenta ani pracovního postupu. Když se automatizační chat vytvoří poprvé, jeho model začíná z výchozího nastavení člena a poté z výchozího nastavení pracovního prostoru. Další vyvolání znovu používají model vybraný pro toto vlákno.
Otevřete automatizační chat a zkontrolujte jeho běhy, výstupy a viditelné chyby. Neúspěšné vyvolání tam zůstane viditelné, abyste mohli opravit workflow, přístup konektoru nebo spouštěč a spustit ho znovu.
Referenční informace ke spouštěčům
Výběr automatizace u pracovního postupu je jediným zdrojem pravdy o tom, co může aktuální pracovní prostor vytvořit. Některé typy událostí jsou vydány za přepínači funkcí pracovního prostoru, a proto se nemusí zobrazovat všude.
Plány
| Typ | Chování |
|---|---|
| Naplánované | Spouští se v čase podle hodin na základě cron plánu a časového pásma IANA. |
| Interval | Po dokončení běhu čeká zadaný interval a poté naplánuje další běh. Běhy se navzájem nepřekrývají. |
| Jednou | Spustí se v zvoleném datu a čase a poté se deaktivuje. |
Před uložením potvrďte časové pásmo zobrazené v automatizaci. Použijte naplánovanou automatizaci pro časování podle hodin a intervalovou automatizaci pro dotazování, kde záleží na prodlevě po dokončení.
Gmail
| Událost | Filtry |
|---|---|
| Nová zpráva | Volitelné shody pro Od, Komu, Kopie, Předmět a text těla. Bez shod je způsobilá každá nová zpráva. |
| Použit štítek | Jeden název štítku Gmail. |
Začněte s úzkými filtry pro nové zprávy, aby vytížená schránka nevytvořila neočekávaný počet běhů.
GitHub
Události GitHubu vyžadují, aby byla v organizaci GitHub nainstalována aplikace GitHub od Okou. Pokud není, obrazovka nastavení automatizace to uvede — správce organizace tam dostane tlačítko Install GitHub App a všichni ostatní jsou vyzváni, aby požádali správce. Nainstalujte ji jednou a níže budou dostupné všechny spouštěče GitHubu.
| Událost | Běžné filtry |
|---|---|
| Pull request | Jeden repozitář a jedna akce: opened, reopened, closed, ready for review, converted to draft, synchronized, přidáno do slučovací fronty nebo z ní odebráno, labeled nebo unlabeled. Zúžení podle base branch, autora, čísla PR nebo štítku. U closed můžete rozlišit merged od closed bez sloučení. |
| Workflow run completed | Repozitář, workflow, conclusion, větev, spouštěcí událost a actor. |
| Workflow job completed | Repozitář, workflow, job, conclusion, větev, štítek běhového prostředí a runner group. |
| Pull request review submitted | Repozitář, stav review, base branch, head branch a důvěryhodný autor. |
| Deployment status created | Repozitář, prostředí, stav, ref, tvůrce, app a příznak produkčního prostředí. |
| Issue or pull-request comment created | Repozitář, rozsah issue/PR, důvěryhodný autor a předpona komentáře. |
Neexistuje samostatná událost GitHub label applied. Pokud chcete reagovat na štítek PR, zvolte Pull request, vyberte akci Labeled a přidejte filtr štítku.
Google Calendar a Meet
- Vytvořena, aktualizována nebo zrušena událost kalendáře, v rozsahu ID kalendáře, který si zvolíte
- Vygenerovaný přepis Google Meet, pro schůzky organizované připojeným členem
Chat a další integrace
- Chat run finished sleduje jedno z vašich vláken chatu. Může filtrovat podle stavu completed, failed nebo cancelled a u completed běhů pomocí zástupného znaku bez rozlišení velikosti písmen
*porovnaného s konečnou odpovědí. - Webhook received vytvoří podepsanou příchozí URL a je dostupný, když plán pracovního prostoru zahrnuje automatizace webhooků.
- Google Forms response submitted, Notion page/database events, Strapi entry published a Stripe invoice paid se zobrazují pouze v pracovních prostorech, kde jsou tyto funkce automatizace povoleny.
Událostní automatizace také vyžadují, aby byl příslušný konektor nebo integrace připojená a připravená pro vlastníka automatizace.
Zprávy automatizace popisují, co se stalo, srozumitelným jazykem, a běh spuštěný spouštěčem chat run finished odkazuje zpět na původní vlákno.
Vytvoření automatizace
Z chatu, který funguje. Nejprve úlohu spusťte jednorázově. Když vytvoří to, co chcete, řekněte:
"Spusť to každý pracovní den v 8 a. m. času Los Angeles a pošli mi výsledek do DM."
Okou potvrdí workflow, frekvenci i cílové místo, uloží workflow, pokud ještě neexistuje, a připojí automatizaci.
Explicitně. Otevřete ve svém pracovním prostoru workflow, klikněte na Add automation a zvolte typ spouštěče a jeho filtry. Užitečné, když znáte podobu dopředu a nechcete zkušební běh.
Postup vychází z Workflow. V My Okou běh používá osobní pokyny (Instructions) vlastníka automatizace, paměť, připojené účty a oprávnění v daném pracovním prostoru. V Legacy Agents poskytuje kontext vlastník agenta. Spouštěč plánu se ptá, kdy spustit a v jakém časovém pásmu.
Veřejný pracovní postup sdílí metodu, ne automatizace nebo přístup svého tvůrce. Každý člen vytváří a spravuje své vlastní automatizace. Nepředpokládejte, že kopie workflow přenese spouštěče, přihlašovací údaje nebo automatizační chat jiného člena.
Automatizace lze jednotlivě povolit a zakázat bez jejich odstranění — správný krok před dovolenou nebo zatímco ladíte hlučný spouštěč.
Cíle
Automatizace musí vědět, kam výsledek putuje. Uveďte to v instrukci workflow:
- Kanál nebo DM ve Slacku — nejčastější; dorazí do kanálu jako zpráva nebo vlákno
- Feishu nebo Microsoft Teams — stejný princip pro týmy, které tam pracují
- Telegram nebo textová zpráva — pro osobní upozornění zaměřená na mobil
- Stránka nebo databáze v Notionu — pro věci, které mají být archivovány, ne vysílány
- Google Doc nebo Sheet — přidáno na konec nebo přepsáno
- Komentář k issue nebo PR na GitHubu — pro inženýrské pracovní postupy
- Koncept e-mailu v Gmailu — připravený ve vašem účtu k revizi a odeslání
- Hostovaná stránka — viz Hostované weby
- Soubor v pracovním prostoru — když je artefaktem video, obrázek nebo stahovatelný soubor
"Publikovat do #engineering" nebo "pošli mi to do DM" je jasnější než "pošli to někam."
Provozní tipy
Tyto tipy vycházejí z provozování automatizací v produkci:
- Sledujte první tři běhy. Automatizace se snadno nastavují; ještě snadněji se dolaďují, jakmile uvidíte, co Okou ve vašem prostředí skutečně vytváří.
- Udržujte každou úlohu malou. Dlouhé, vícekrokové automatizace jsou křehčí. Pokud jedna z nich musí aktualizovat pět systémů, zvažte rozdělení na dvě.
- Připněte cíl. Kanály se přejmenovávají a lidé odcházejí. Pojmenujte cíl explicitně v instrukci pracovního postupu; Okou vás upozorní, pokud ho při dalším běhu nenajde.
- Časově omezte dlouho běžící dotazy. Pokud prompt říká „za posledních 30 dnů“, zopakujte to při každém běhu, aby okno zůstalo čerstvé.
- Potvrďte časové pásmo. Naplánované a jednorázové automatizace ukládají explicitní časové pásmo; před uložením zkontrolujte zobrazenou hodnotu.
- Před dovolenou pozastavte. Zejména u automatizací, které vám posílají DM — návrat k 14 krátkým DM není užitečný. Automatizaci vypněte a po návratu ji znovu zapněte; workflow zůstane zachované.
Náklady a objem
Vyvolání automatizace spustí běžný běh a může spotřebovat kredity podle modelové trasy a služeb, které používá. Při odhadu nákladů zkontrolujte automatizační chat a Billing.
Krátké intervaly se rychle násobí: interval 15 minut může běžet až 96krát za den, pokud každý běh skončí před uplynutím dalšího intervalu. Stejně hlučné mohou být i široké filtry událostí. Začněte úzce, zkontrolujte prvních několik vyvolání a pak filtr nebo frekvenci záměrně rozšiřte.
Automatizaci vypnete, když chcete zastavit nová vyvolání bez odstranění jejího workflow nebo historie.
Co dál
- Viz Pracovní postupy pro postup, který automatizace spouští.
- Viz Chat pro to, co se děje uvnitř každého běhu.
- Viz Ukázkové pracovní postupy pro pět kompletních kombinací workflow a automatizace.
