Een automatisering is een trigger gekoppeld aan een workflow. De workflow bepaalt wat er gebeurt; de automatisering bepaalt wanneer er een nieuwe run start.
Een automatisering gebruikt:
- Een workflow, inclusief de agent die eigenaar is
- Een eigenaar, wiens automatiseringschat en gekoppelde toegang worden gebruikt
- Een trigger, zoals een planning, een gebeurtenis van een gekoppelde dienst, of een inkomende webhook
Wat er elke keer gebeurt
Elke trigger start een nieuwe run in de automatiseringschat voor die workflow en eigenaar. Er wordt niet bij elke trigger een volledig nieuwe chat aangemaakt. Automatiseringen van hetzelfde lid voor dezelfde workflow hergebruiken die automatiseringschat.
De run gebruikt de huidige instructie van de workflow en de triggerpayload. 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 vermeld dat alleen het huidige event of een expliciet tijdsvenster gebruikt mag worden.
Het model wordt gekozen op de automatiseringschat-thread, niet op de agent of workflow. Wanneer de automatiseringschat voor het eerst wordt aangemaakt, start het model vanuit de standaard van het lid en vervolgens de standaard van de werkruimte. Latere triggers hergebruiken het model dat voor die thread is geselecteerd.
Open de automatiseringschat om de runs, uitkomsten en zichtbare fouten te bekijken. Een mislukte trigger blijft daar zichtbaar zodat je de workflow, connector-toegang of trigger kunt corrigeren en opnieuw kunt uitvoeren.
Triggerreferentie
De automatiseringskiezer op een workflow is de bron van waarheid voor wat de huidige werkruimte kan aanmaken. Sommige gebeurtenistypen zijn alleen beschikbaar via werkruimte-feature switches en verschijnen daarom niet overal.
Planningen
| Type | Gedrag |
|---|---|
| Gepland | Voert uit op kloktijden via een cronschema en een IANA-tijdzone. |
| Interval | Wacht het ingestelde interval na afloop van een run en plant dan de volgende run. Runs overlappen zichzelf niet. |
| Eenmalig | Voert uit op de gekozen datum en tijd en schakelt zichzelf daarna uit. |
Controleer de weergegeven tijdzone in de automatisering voordat je opslaat. Gebruik een geplande automatisering voor kloktijden en een intervalautomatisering voor polling waarbij de tijd tussen afrondingen belangrijk is.
Gmail
| Gebeurtenis | Filters |
|---|---|
| Nieuw bericht | Optioneel Van, Aan, Cc, Onderwerp en tekstmatchers in de inhoud. Zonder matchers is elk nieuw bericht geschikt. |
| Label toegepast | Eén Gmail-labelnaam. |
Begin met smalle nieuw-berichtfilters zodat een drukke inbox niet onverwacht veel runs veroorzaakt.
GitHub
GitHub-gebeurtenissen vereisen dat de GitHub-app van Okou is geïnstalleerd op je GitHub-organisatie. Als dat niet zo is, geeft het automatiseringsscherm dit aan — een org-beheerder krijgt daar een GitHub App installeren-knop, en anderen krijgen het verzoek een beheerder te vragen. Installeer het één keer en elke onderstaande GitHub-trigger wordt beschikbaar.
| Gebeurtenis | Veelvoorkomende filters |
|---|---|
| Pull request | Eén repository en één actie: geopend, heropend, gesloten, klaar voor review, omgezet naar concept, gesynchroniseerd, toegevoegd aan of verwijderd uit de merge queue, gelabeld of label verwijderd. Filter op basisbranch, auteur, PR-nummer of label. Voor closed kun je onderscheid maken tussen gemerged en gesloten zonder merge. |
| Workflow-run voltooid | Repository, workflow, conclusie, branch, triggerende gebeurtenis en actor. |
| Workflow-job voltooid | Repository, workflow, job, conclusie, branch, runner-label en runner-groep. |
| Pull request review ingediend | Repository, reviewstatus, basisbranch, head branch en vertrouwde auteur. |
| Deploymentstatus aangemaakt | Repository, omgeving, status, ref, maker, app en productie-omgeving-vlag. |
| Issue- of pull-requestcommentaar aangemaakt | Repository, issue/PR-scope, vertrouwde auteur en commentaarprefix. |
Er is geen aparte GitHub label toegepast-gebeurtenis. Om te reageren op een PR-label, kies je Pull request, selecteer je de Gelabeld-actie en voeg je een labelfilter toe.
Google Agenda en Meet
- Agenda-evenement aangemaakt, bijgewerkt of geannuleerd, beperkt tot de agenda-ID die je kiest
- Google Meet-transcript gegenereerd, voor vergaderingen georganiseerd door het gekoppelde lid
Chat en andere integraties
- Chat-run voltooid bewaakt een van je chatthreads. Kan filteren op voltooid, mislukt of geannuleerd en, voor voltooide runs, een hoofdletterongevoelige
*-wildcard op het eindantwoord. - Webhook ontvangen maakt een ondertekende inkomende URL aan en is beschikbaar als het werkruimte-abonnement webhook-automatiseringen bevat.
- Google Forms-reactie ingediend, Notion pagina/database-gebeurtenissen, Strapi-item gepubliceerd en Stripe-factuur betaald verschijnen alleen in werkruimtes waar deze automatiseringsfuncties zijn ingeschakeld.
Gebeurtenisautomatiseringen vereisen ook dat de relevante connector of integratie is gekoppeld en klaar is voor de eigenaar van de automatisering.
Automatiseringsberichten beschrijven in gewone taal wat er is gebeurd, en een run gestart door een chat-run voltooid-trigger verwijst terug naar de oorspronkelijke agent en thread.
Een automatisering aanmaken
Vanuit een chat die werkt. Voer de taak eerst eenmalig uit. Als het resultaat goed is, zeg dan:
"Voer dit elke werkdag om 8 uur Los Angeles-tijd uit en DM mij het resultaat."
Okou bevestigt de workflow, de frequentie en de bestemming, slaat de workflow op als die nog niet bestaat, en koppelt de automatisering.
Expliciet. Open een workflow in je werkruimte, klik op Automatisering toevoegen en kies het triggertype en de filters. Handig als je het proces al kent en geen testrun wilt.
De agent en de instructie komen uit de workflow zelf, dus een plannings-trigger vraagt alleen wanneer en in welke tijdzone de run moet starten.
Automatiseringen kunnen individueel worden in- en uitgeschakeld zonder ze te verwijderen — handig voor bijvoorbeeld een vakantie of tijdens het debuggen van een luidruchtige trigger.
Bestemmingen
Een automatisering moet weten waar het resultaat naartoe gaat. Geef dit aan in de workflow-instructie:
- Slack-kanaal of DM — het meest gebruikelijk; verschijnt als bericht of thread in het kanaal
- Feishu of Microsoft Teams — hetzelfde idee voor teams die daar werken
- Telegram of sms — voor persoonlijke, mobiele meldingen
- Een Notion-pagina of database — voor zaken die gearchiveerd moeten worden in plaats van gedeeld
- Een Google Doc of Sheet — toegevoegd of overschreven
- Een GitHub-issue of PR-commentaar — voor technische workflows
- Een Gmail-concept — voorbereid in je account om te controleren en te verzenden
- Een gehoste pagina — zie Gehoste sites
- Een werkruimtebestand — als het resultaat een video, afbeelding of downloadbaar bestand is
"Post naar #engineering" of "DM mij" is duidelijker dan "stuur het ergens heen."
Praktische tips
Deze tips komen uit het draaien van automatiseringen in productie:
- Bekijk de eerste drie runs. Automatiseringen zijn eenvoudig op te zetten; ze zijn makkelijker te verfijnen als je ziet wat Okou daadwerkelijk in jouw omgeving oplevert.
- Houd elke taak klein. Lange, meerstaps-automatiseringen zijn kwetsbaarder. Als één automatisering vijf systemen moet bijwerken, splits het dan op.
- Specificeer de bestemming. Kanalen worden hernoemd en mensen vertrekken. Noem de bestemming expliciet in de workflow-instructie; Okou waarschuwt als deze niet gevonden kan worden bij de volgende run.
- Beperk lange queries in de tijd. Als de prompt vraagt om "de laatste 30 dagen," herhaal dat bij elke run zodat het venster actueel blijft.
- Controleer de tijdzone. Geplande en eenmalige automatiseringen slaan een expliciete tijdzone op; controleer de waarde voordat je opslaat.
- Pauzeer voor vakanties. Vooral voor automatiseringen die je DM'en — terugkomen op 14 korte DM's is niet handig. Schakel de automatisering uit en weer in als je terug bent; de workflow blijft behouden.
Kosten en volume
Een automatiseringstrigger start een normale run en kan credits verbruiken afhankelijk van het modelpad en de gebruikte diensten. Bekijk de automatiseringschat en Facturatie bij het inschatten van kosten.
Korte intervallen tellen snel op: een interval van 15 minuten kan tot 96 keer per dag draaien als elke run op tijd klaar is. Brede eventfilters kunnen net zo veel lawaai veroorzaken. Begin smal, bekijk de eerste paar uitvoeringen, en verbreed daarna bewust het filter of de frequentie.
Schakel een automatisering uit als je nieuwe triggers wilt stoppen zonder de workflow of geschiedenis te verwijderen.
Wat nu
- Zie Workflows voor de procedure die een automatisering uitvoert.
- Zie Chat voor wat er binnen elke run gebeurt.
- Zie Voorbeeldworkflows voor vijf complete workflow-plus-automatisering-combinaties.
