Passaggi

I passaggi girano dall'alto verso il basso. Aggiungili, rimuovili e riordinali nell'editor, e dai a ciascuno un nome facoltativo così la cronologia delle esecuzioni si legge bene.

Passarsi i risultati

Un passaggio può usare quello che ha prodotto un passaggio precedente, tramite un riferimento:

• {{run.input}}: l'input con cui è stata avviata questa esecuzione
• {{trigger.summary}}: un campo del trigger
• {{steps.summarise.output}}: quello che ha prodotto il passaggio chiamato summarise

Digita / in un campo qualsiasi per inserirne uno invece di scriverlo a mano. Sbagliare l'id di un passaggio è una causa frequente di risultato vuoto.

Eseguire una volta per elemento

Se punti l'input di un passaggio a un passaggio la cui uscita è un elenco, viene eseguito una volta per elemento, con {{item}} disponibile all'interno.

Dieci concorrenti riassunti uno per uno invece che in blocco, oppure ogni file di una cartella di Drive elaborato a turno.

Poi scegli cosa succede quando un elemento fallisce:

• Interrompi l'esecuzione: ferma tutto. Giusto quando gli elementi sono parti di un unico risultato.
• Continua con gli altri elementi: salta quello difettoso e prosegui. Giusto quando sono indipendenti, e l'esecuzione finisce come Completato con problemi così lo sai.

Passaggi Agente

Esegue un agente. Due modi per specificarlo:

Definisci qui. Scrivi istruzioni e scegli strumenti solo per questo passaggio. Buono quando il lavoro è specifico di questo workflow e non esiste come agente.

Usa un agente esistente. Punta a uno dei tuoi agenti e fissa una Revisione, così le modifiche successive a quell'agente non cambiano in silenzio questo workflow. L'accesso viene ricontrollato quando il workflow gira, quindi se perdi l'accesso all'agente il passaggio fallisce invece di girare con permessi vecchi.

Preferisci un agente esistente quando lo stesso lavoro viene fatto anche a mano in chat. Una sola definizione, mantenuta una sola volta.

Puoi anche impostare il modello, la temperatura e le raccolte fissate per il passaggio.

Passaggi Approvazione

Mette in pausa l'esecuzione finché una persona non decide. L'esecuzione resta su In attesa di approvazione finché qualcuno non approva o rifiuta, e il rifiuto termina l'esecuzione.

Approvatori: nomina persone specifiche, oppure lascia vuoto per il proprietario e gli editor.

Messaggio: di' cosa vuoi che guardino. "Verifica le cifre rispetto alla dashboard prima che questo vada al cliente" è un messaggio utile. "Per favore approva" no.

Mettine uno prima di qualsiasi cosa esca dall'azienda: un'email ai clienti, un file scritto su un'unità condivisa, un messaggio pubblicato su un canale.

Passaggi Condizione

Controlla qualcosa e decide se proseguire.

Origine: cosa controllare, di solito un riferimento come {{steps.research.output}}.

Tipo di controllo, uno dei due:

Regola confronta in modo meccanico: non è vuoto, è vuoto, contiene, non contiene, è uguale a, maggiore di, minore di. Prevedibile e gratuita. Usala ogni volta che la domanda è meccanica.

Chiedi al modello pone la domanda con parole tue: "Questo segnala un'anomalia?". Usalo solo quando il giudizio richiede davvero una comprensione del testo, dato che costa una chiamata al modello e può rispondere in modo diverso su due input simili.

Se il controllo fallisce, salta a un passaggio successivo o alla fine del workflow. I passaggi saltati sono contrassegnati come saltati nell'esecuzione, così una settimana fiacca si legge come "niente da riportare" e non come un fallimento.

La condizione più comune e più utile è semplicemente Non è vuoto su un passaggio di ricerca, così il workflow non fa niente invece di mandare un digest vuoto.

Passaggi Azione

Fa una cosa specifica: invia un'email, crea un file, chiama uno strumento di un servizio collegato.

Scegli lo strumento, poi compila quello che gli serve. Ogni campo accetta un riferimento, quindi il corpo di un'email può essere {{steps.writeup.output}}.

Modifica dati è un'etichetta sugli strumenti che fanno qualcosa nel mondo invece di limitarsi a leggere. Tratta ognuno di questi come bisognoso di un passaggio di approvazione prima, a meno che tu non sia certo.

Come i passaggi Agente, un'azione può eseguire una volta per elemento di un elenco.

Se uno strumento diventa non disponibile (un connettore spento, un server MCP rimosso) il passaggio te lo dice e tu ne scegli un altro. Non fa niente in silenzio.

Validare prima di salvare

L'editor controlla i tuoi passaggi e segnala i campi mancanti o malformati sul passaggio specifico. Un workflow con errori non si salva, ed è voluto: un workflow rotto che si salva è un workflow rotto che gira alle 9 di lunedì mattina.