Een automatisering is een trigger die is gekoppeld aan een workflow. De workflow beschrijft wat er moet gebeuren; de automatisering beschrijft wanneer een nieuwe run moet starten.
Een automatisering gebruikt:
- Een workflow, met de huidige procedure
- Een eigenaar, wiens automatiseringschat en gekoppelde toegang worden gebruikt
- Een trigger, zoals een schema, een gebeurtenis van een gekoppelde service of een inkomende webhook
Wat er elke keer draait
Elke activering start een nieuwe run in de automatiseringschat voor die workflow en die eigenaar. Er wordt bij elke activering niet een volledig nieuwe chat gemaakt. Automatiseringen die door hetzelfde lid voor dezelfde workflow worden beheerd, hergebruiken die automatiseringschat.
De run gebruikt de huidige instructie van de workflow en de trigger-payload. Omdat de chat wordt hergebruikt, blijven eerdere runs zichtbaar in de threadgeschiedenis. Als een taak stateless moet werken, geef dat dan aan in de workflow-instructie en laat de taak alleen de huidige gebeurtenis of een expliciet tijdsvenster gebruiken.
Het model wordt geselecteerd op de thread van de automatiseringschat, niet op de agent of workflow. Wanneer de automatiseringschat voor het eerst wordt gemaakt, begint het model met de standaardinstelling van het lid en daarna met de standaardinstelling van de workspace. Latere activeringen hergebruiken het model dat voor die thread is geselecteerd.
Open de automatiseringschat om de runs, output en zichtbare fouten te bekijken. Een mislukte activering blijft daar zichtbaar, zodat je de workflow, de connectortoegang of de trigger kunt corrigeren en het opnieuw kunt uitvoeren.
Triggerreferentie
De automatiseringskiezer in een workflow is de bron van waarheid voor wat de huidige werkruimte kan aanmaken. Sommige gebeurtenistypen worden achter werkruimte-functieschakelaars uitgerold en verschijnen daarom mogelijk niet overal.
Schema’s
| Type | Gedrag |
|---|---|
| Gepland | Draait op kloktijden met behulp van een cron-schema en een IANA-tijdzone. |
| Interval | Wacht het ingestelde interval nadat een run is voltooid en plant daarna de volgende run in. Runs overlappen niet met zichzelf. |
| Eenmalig | Draait op de geselecteerde datum en tijd en schakelt zichzelf daarna uit. |
Controleer de tijdzone die in de automatisering wordt getoond voordat je opslaat. Gebruik een geplande automatisering voor timing op kloktijd en een intervalautomatisering voor polling wanneer de tussenruimte na voltooiing belangrijk is.
Gmail
| Gebeurtenis | Filters |
|---|---|
| Nieuw bericht | Optionele matchers voor Van, Aan, Cc, Onderwerp en tekst in de body. Zonder matchers komt elk nieuw bericht in aanmerking. |
| Label toegepast | Eén Gmail-labelnaam. |
Begin met smalle filters voor nieuwe berichten, zodat een drukke inbox niet onverwacht veel runs veroorzaakt.
GitHub
GitHub-gebeurtenissen vereisen dat Okou’s GitHub App is geïnstalleerd op je GitHub-organisatie. Als dat niet zo is, vermeldt het scherm voor automatiseringsinstellingen dat expliciet — een organisatiebeheerder ziet daar een knop GitHub App installeren, en iedereen anders krijgt te horen dat die een beheerder moet vragen. Installeer de app één keer en elke GitHub-trigger hieronder wordt beschikbaar.
| Gebeurtenis | Veelgebruikte filters |
|---|---|
| Pull request | Eén repository en één actie: geopend, opnieuw geopend, gesloten, gereed voor review, omgezet naar concept, gesynchroniseerd, toegevoegd aan of verwijderd uit de merge queue, gelabeld of ontlabeld. Beperk op basisbranch, auteur, PR-nummer of label. Voor closed kun je merged onderscheiden van closed zonder samenvoegen. |
| Workflow run completed | Repository, workflow, conclusie, branch, triggerende gebeurtenis en actor. |
| Workflow job completed | Repository, workflow, job, conclusie, branch, runner-label en runnergroep. |
| Pull request review submitted | Repository, reviewstatus, basisbranch, headbranch en vertrouwde auteur. |
| Deployment status created | Repository, omgeving, status, ref, maker, app en vlag voor productieomgeving. |
| Issue or pull-request comment created | Repository, issue/PR-bereik, vertrouwde auteur en commentaarprefix. |
Er is geen aparte gebeurtenis GitHub label toegepast. Als je op een PR-label wilt reageren, kies Pull request, selecteer de actie Labeled en voeg een labelfilter toe.
Google Calendar en Meet
- Agenda-evenement aangemaakt, bijgewerkt of geannuleerd, binnen de agenda-ID die je kiest
- Google Meet-transcript gegenereerd, voor vergaderingen georganiseerd door het gekoppelde lid
Chat en andere integraties
- Chat run finished bewaakt een van je chatthreads. Je kunt filteren op voltooid, mislukt of geannuleerd, en bij voltooide runs op een hoofdletterongevoelige
*wildcard die wordt gematcht tegen het eindantwoord. - Webhook received maakt een ondertekende inkomende URL aan en is beschikbaar wanneer het werkruimteplan webhookautomatiseringen bevat.
- Google Forms response submitted, Notion page/database events, Strapi entry published en Stripe invoice paid verschijnen alleen in werkruimtes waarin die automatiseringsfuncties zijn ingeschakeld.
Gebeurtenisautomatiseringen vereisen ook dat de relevante connector of integratie is gekoppeld en klaarstaat voor de eigenaar van de automatisering.
Automatiseringsberichten beschrijven wat er is gebeurd in gewone taal, en een run die is gestart door een trigger chat run finished verwijst terug naar de oorspronkelijke thread.
Een automatisering maken
Vanuit een chat die werkt. Voer de taak eerst eenmalig uit. Wanneer die oplevert wat je wilt, zeg dan:
"Voer dit elke werkdag om 8 uur Los Angeles-tijd uit en stuur me het resultaat via DM."
Okou bevestigt de workflow, de cadans en de bestemming, slaat de workflow op als die nog niet bestaat en koppelt de automatisering.
Expliciet. Open een workflow in je workspace, klik op Automatisering toevoegen en kies het type trigger en de filters ervan. Handig wanneer je de vorm al van tevoren kent en geen proefrun wilt.
De procedure komt uit de workflow. In My Okou gebruikt de run de persoonlijke instructies (Instructions), het geheugen, de gekoppelde accounts en machtigingen van de eigenaar van de automatisering in die werkruimte. In Legacy Agents levert de owning Agent de agentcontext. Een schematrigger vraagt wanneer er moet worden uitgevoerd en in welke tijdzone.
Een Public Workflow deelt een methode, niet de automatiseringen of toegang van de maker ervan. Elk lid maakt en beheert zijn eigen automatiseringen. Ga er niet van uit dat het kopiëren van een workflow de triggers, inloggegevens of automatiseringschat van een ander lid overneemt.
Automatiseringen kunnen afzonderlijk worden ingeschakeld en uitgeschakeld zonder ze te verwijderen — de juiste keuze vóór een vakantie, of terwijl je een lawaaierige trigger aan het debuggen bent.
Bestemmingen
Een automatisering moet weten waar het resultaat naartoe gaat. Benoem dat in de workflow-instructie:
- Slack-kanaal of DM — het meest gebruikelijk; komt als bericht of thread in het kanaal terecht
- Feishu of Microsoft Teams — hetzelfde idee voor teams die daar werken
- Telegram of sms-bericht — voor persoonlijke, mobielgerichte meldingen
- Een Notion-pagina of database — voor zaken die gearchiveerd moeten worden in plaats van rondgestuurd
- Een Google Doc of Sheet — toegevoegd aan het einde of overschreven
- Een GitHub issue- of PR-commentaar — voor engineering-workflows
- Een Gmail-concept — voorbereid in je account zodat je het kunt nakijken en verzenden
- Een gehoste pagina — zie Gehoste sites
- Een werkruimtebestand — wanneer het artefact een video, afbeelding of downloadbaar bestand is
"Plaats in #engineering" of "stuur me een DM" is duidelijker dan "stuur het ergens heen."
Operationele tips
Deze komen voort uit het draaien van automatiseringen in productie:
- Volg de eerste drie runs. Automatiseringen zijn eenvoudig op te zetten; ze zijn makkelijker te verfijnen zodra je ziet wat Okou in jouw omgeving daadwerkelijk produceert.
- Houd elke taak klein. Lange, meerstapsautomatiseringen zijn kwetsbaarder. Als één automatisering vijf systemen moet bijwerken, overweeg dan om die in tweeën te splitsen.
- Pin de bestemming vast. Kanalen krijgen andere namen en mensen vertrekken. Noem de bestemming expliciet in de workflow-instructie; Okou waarschuwt als het die bij de volgende run niet kan vinden.
- Beperk langlopende zoekopdrachten in de tijd. Als de prompt vraagt om "de laatste 30 dagen", herhaal dat dan bij elke run zodat het venster actueel blijft.
- Bevestig de tijdzone. Geplande en eenmalige automatiseringen slaan een expliciete tijdzone op; controleer de getoonde waarde voordat je opslaat.
- Pauzeer vóór vakanties. Vooral voor automatiseringen die je een DM sturen — terugkomen op 14 korte DM’s is niet nuttig. Schakel de automatisering uit en schakel die weer in wanneer je terug bent; de workflow blijft intact.
Kosten en volume
Een activering van een automatisering start een normale run en kan credits verbruiken volgens de modelroute en services die het gebruikt. Bekijk de automatiseringschat en Facturering wanneer je de kosten inschat.
Korte intervallen stapelen snel op: een interval van 15 minuten kan maximaal 96 keer per dag draaien als elke run klaar is voordat het volgende interval verstrijkt. Brede gebeurtenisfilters kunnen even rumoerig zijn. Begin smal, inspecteer de eerste paar activeringen en verbreed daarna bewust het filter of de cadans.
Schakel een automatisering uit wanneer je nieuwe activeringen wilt stoppen zonder de workflow of geschiedenis te verwijderen.
Wat hierna
- Zie Workflows voor de procedure die een automatisering uitvoert.
- Zie Chat voor wat er binnen elke run gebeurt.
- Zie Voorbeeldworkflows voor vijf complete combinaties van workflow en automatisering.
