Una automazione è un trigger collegato a un flusso di lavoro. Il flusso di lavoro dice cosa fare; l'automazione dice quando avviare un'altra esecuzione.
Un'automazione usa:
- Un flusso di lavoro, incluso l'agente che lo possiede
- Un proprietario, di cui si usano il chat di automazione e gli accessi collegati
- Un trigger, come una pianificazione, un evento di un servizio collegato o un webhook in ingresso
Cosa viene eseguito ogni volta
Ogni attivazione avvia una nuova esecuzione nel chat di automazione di quel flusso di lavoro e proprietario. Non crea un chat completamente nuovo a ogni attivazione. Le automazioni dello stesso membro per lo stesso flusso di lavoro riutilizzano quel chat di automazione.
L'esecuzione usa l'istruzione corrente del flusso di lavoro e il payload del trigger. Poiché il chat viene riutilizzato, le esecuzioni precedenti restano nella cronologia del thread. Se un'attività deve comportarsi senza stato, dillo nell'istruzione del flusso di lavoro e chiedi di usare solo l'evento corrente o una finestra temporale esplicita.
Il modello viene selezionato sul thread del chat di automazione, non sull'agente né sul flusso di lavoro. Quando il chat di automazione viene creato la prima volta, il suo modello parte dal valore predefinito del membro e poi da quello dello spazio di lavoro. Le attivazioni successive riutilizzano il modello scelto per quel thread.
Apri il chat di automazione per ispezionare esecuzioni, output ed errori visibili. Un'attivazione fallita resta visibile lì, così puoi correggere il flusso di lavoro, l'accesso al connettore o il trigger ed eseguirla di nuovo.
Riferimento dei trigger
Il selettore di automazione su un flusso di lavoro è la fonte di verità per ciò che lo spazio di lavoro attuale può creare. Alcuni tipi di evento sono pubblicati dietro interruttori di funzionalità dello spazio di lavoro e quindi potrebbero non apparire ovunque.
Pianificazioni
| Tipo | Comportamento |
|---|---|
| Scheduled | Esegue a orari di calendario con una pianificazione cron e un fuso orario IANA. |
| Interval | Attende l'intervallo configurato dopo il completamento di un'esecuzione, poi pianifica la successiva. Le esecuzioni non si sovrappongono. |
| Once | Esegue alla data e all'ora scelte, poi si disattiva. |
Conferma il fuso orario mostrato nell'automazione prima di salvare. Usa un'automazione pianificata per l'orario di calendario e una a intervallo per il polling dove conta la spaziatura dopo il completamento.
Gmail
| Evento | Filtri |
|---|---|
| New message | Corrispondenze facoltative su Da, A, Cc, Oggetto e testo del corpo. Senza corrispondenze, ogni nuovo messaggio è idoneo. |
| Label applied | Un nome di etichetta Gmail. |
Inizia con filtri stretti sui nuovi messaggi, così una casella piena non crea un numero inatteso di esecuzioni.
GitHub
| Evento | Filtri comuni |
|---|---|
| Pull request | Un repository e un'azione: opened, reopened, closed, ready for review, converted to draft, synchronized, added to or removed from the merge queue, labeled o unlabeled. Restringi per branch base, autore, numero PR o etichetta. Per closed, puoi distinguere merged da closed without merging. |
| Workflow run completed | Repository, workflow, conclusione, branch, evento scatenante e attore. |
| Workflow job completed | Repository, workflow, job, conclusione, branch, etichetta runner e gruppo runner. |
| Pull request review submitted | Repository, stato della revisione, branch base, branch head e autore fidato. |
| Deployment status created | Repository, ambiente, stato, ref, creatore, app e flag di ambiente di produzione. |
| Issue or pull-request comment created | Repository, ambito issue/PR, autore fidato e prefisso del commento. |
Non esiste un evento separato GitHub label applied. Per reagire a un'etichetta PR, scegli Pull request, seleziona l'azione Labeled e aggiungi un filtro etichetta.
Google Calendar e Meet
- Calendar event created, updated o cancelled, limitato all'ID calendario che scegli
- Google Meet transcript generated, per riunioni organizzate dal membro collegato
Chat e altre integrazioni
- Chat run finished osserva uno dei tuoi thread di chat. Può filtrare per stato completed, failed o cancelled e, per le esecuzioni completate, per un carattere jolly
*senza distinzione tra maiuscole, confrontato con la risposta finale. - Webhook received crea un URL in ingresso firmato ed è disponibile quando il piano dello spazio di lavoro include automazioni webhook.
- Google Forms response submitted, Notion page/database events, Strapi entry published e Stripe invoice paid compaiono solo negli spazi di lavoro in cui quelle funzionalità di automazione sono abilitate.
Le automazioni di eventi richiedono anche che il connettore o l'integrazione pertinente sia collegato e pronto per il proprietario dell'automazione.
Creare un'automazione
Da un chat che funziona. Esegui prima l'attività come una tantum. Quando produce ciò che vuoi, di':
"Run this every weekday at 8 a.m. Los Angeles time and DM me the result."
Okou conferma il flusso di lavoro, la cadenza e la destinazione, salva il flusso di lavoro se non esiste ancora e allega l'automazione.
Esplicitamente. Apri un flusso di lavoro nel tuo spazio di lavoro e aggiungici un'automazione, scegliendo il tipo di trigger e i suoi filtri. Utile quando conosci la forma in anticipo e non vuoi una prova a secco.
Le automazioni possono essere attivate e disattivate singolarmente senza eliminarle: la mossa giusta prima di una vacanza, o mentre fai debug di un trigger rumoroso.
Destinazioni
Un'automazione deve sapere dove va il risultato. Indicalo nell'istruzione del flusso di lavoro:
- Canale o DM Slack — il più comune; arriva nel canale come messaggio o thread
- Feishu o Microsoft Teams — stessa idea per i team che vivono lì
- Telegram o SMS — per avvisi personali, mobile-first
- Una pagina o database Notion — per ciò che va archiviato invece che trasmesso
- Un Google Doc o Sheet — aggiunto o sovrascritto
- Un issue o commento PR GitHub — per i flussi di lavoro di ingegneria
- Una bozza Gmail — preparata nel tuo account perché tu la rilegga e invii
- Una pagina ospitata — vedi Hosted sites
- Un file dello spazio di lavoro — quando l'artefatto è un video, un'immagine o un asset scaricabile
"Post to #engineering" o "DM me" è più chiaro di "send it somewhere."
Consigli operativi
Questi vengono dall'esecuzione di automazioni in produzione:
- Osserva le prime tre esecuzioni. Le automazioni sono facili da configurare; sono ancora più facili da rifinire una volta che vedi cosa Okou produce davvero nel tuo ambiente.
- Mantieni ogni attività piccola. Le automazioni lunghe e multi-step sono più fragili. Se una sola deve aggiornare cinque sistemi, considera di dividerla in due.
- Fissa la destinazione. I canali vengono rinominati e le persone se ne vanno. Nomina la destinazione esplicitamente nell'istruzione; Okou avviserà se non la trova alla prossima esecuzione.
- Delimita nel tempo le query lunghe. Se il prompt chiede "gli ultimi 30 giorni", ribadiscilo a ogni esecuzione così la finestra resta fresca.
- Conferma il fuso orario. Le automazioni pianificate e una tantum salvano un fuso esplicito; controlla il valore mostrato prima di salvare.
- Metti in pausa prima delle vacanze. Soprattutto per le automazioni che ti inviano DM: tornare a 14 DM brevi non è utile. Disattiva l'automazione e riattivala al ritorno; il flusso di lavoro resta intatto.
Costi e volume
Un'attivazione di automazione avvia un'esecuzione normale e può consumare crediti in base alla rotta del modello e ai servizi usati. Controlla il chat di automazione e Billing quando stimi il costo.
Gli intervalli brevi si moltiplicano in fretta: un intervallo di 15 minuti può arrivare a 96 esecuzioni al giorno se ogni esecuzione termina prima dell'intervallo successivo. I filtri di evento ampi possono essere altrettanto rumorosi. Inizia stretto, ispeziona le prime attivazioni, poi allarga deliberatamente filtro o cadenza.
Disattiva un'automazione quando vuoi fermare nuove attivazioni senza eliminare il suo flusso di lavoro o la cronologia.
Passaggi successivi
- Vedi Workflows per la procedura che un'automazione esegue.
- Vedi Chat per cosa succede dentro ogni esecuzione.
- Vedi Example workflows per cinque combinazioni complete flusso di lavoro + automazione.