Torna alla documentazioneConcetti chiave

Flussi di lavoro

Procedure riutilizzabili e con nome che insegnano a Okou come lavora il tuo team.

Ultimo aggiornamento 17 agosto 2026 · 9 min read

Un flusso di lavoro è una procedura con nome e riutilizzabile salvata su un agente. Insegna a Okou come il tuo team fa un certo tipo di lavoro, così la prossima persona che ne ha bisogno non deve riscrivere il prompt.

La prima volta che chiedi qualcosa a Okou, scrivi un prompt. La seconda, incolli lo stesso prompt con piccoli ritocchi. La terza, stai copiando un lungo prompt da un doc Notion che qualcuno ha chiamato la «libreria di prompt del team». È quello il momento di salvare un flusso di lavoro.

Il problema che i flussi di lavoro risolvono

Un chat una tantum va bene per un'attività una tantum. Ma quasi ogni team ha un arretrato di lavoro che si ripete: input diversi, stessa forma:

  • Un cliente scrive → guarda la sua cronologia → redigi una risposta nella sua lingua → registra il ticket
  • Appare un report di bug → estrai i passaggi di riproduzione → classifica la gravità → crea un issue strutturato
  • Lunedì mattina → prendi i numeri della settimana scorsa → confrontali con la precedente → pubblica un digest

Senza flussi di lavoro, ognuno di questi è un prompt da 200 parole che tutti devono ricordare. Con i flussi di lavoro, ognuno è un nome: triage-bug-report, weekly-metrics, customer-reply.

Un flusso di lavoro da solo non ha né pianificazione né trigger: è la procedura. Per farlo girare da solo, allega un'Automation.

Cosa c'è in un flusso di lavoro

CampoCosa fa
NameUno slug minuscolo di 2–64 caratteri con lettere, numeri e trattini interni — triage-bug-report. Usa /triage-bug-report per invocarlo esplicitamente nel chat dell'agente proprietario.
Display nameL'etichetta leggibile mostrata nello spazio di lavoro.
DescriptionUna riga che dice a Okou quando si applica questo flusso di lavoro. Okou confronta le richieste in arrivo con le descrizioni, quindi la formulazione conta.
InstructionLa procedura stessa. La prosa semplice va bene: menziona gli strumenti da usare, la forma dell'output e gli eventuali vincoli.
FilesFile supplementari opzionali: modelli, checklist, linee guida del brand, dati di riferimento, raggruppati con il flusso di lavoro.
Visibilityprivate (solo tu) o public (tutti nello spazio di lavoro).

Niente grafo a nodi, niente configurazione YAML, niente sezione trigger. L'istruzione di solito somiglia molto al prompt di chat che ha funzionato la prima volta.

Una buona descrizione è la differenza tra un flusso di lavoro che scatta quando deve e uno che non scatta mai: «triage a customer-facing bug report and file it to GitHub with severity» è meglio di «do bug stuff.»

I flussi di lavoro appartengono agli agenti

Ogni flusso di lavoro appartiene a esattamente un agente. È questo che rende il comportamento prevedibile: il flusso di lavoro gira con il tono, i valori predefiniti e le concessioni connettore di quell'agente.

  • Flusso di lavoro privato — visibile solo a te. Adatto ad automazioni personali legate a un Gmail o una postazione CRM personale.
  • Flusso di lavoro pubblico — visibile a tutti nello spazio di lavoro, su un agente che il tuo team può raggiungere.

La stessa procedura può vivere su due agenti e produrre risultati diversi, perché ogni agente porta la propria voce e i propri permessi. Per passare un flusso di lavoro a un altro agente, copialo: questo lo duplica, così i due possono poi divergere.

Vedi Agents per come la proprietà dell'agente delimita ciò che un flusso di lavoro può toccare.

Creare un flusso di lavoro

Partire dalla pagina Workflows

  1. Apri Workflows e scegli New workflow.
  2. Seleziona l'agente che deve possedere il flusso di lavoro.
  3. Okou apre un chat con un prompt guidato di creazione. Descrivi risultato, input attesi, strumenti, output e qualsiasi confine di approvazione.
  4. Rivedi nome, descrizione, istruzione, file e visibilità proposti prima che Okou lo crei.

Puoi anche partire da un chat agente esistente e chiedere a Okou di trasformare in flusso di lavoro un'attività che ha già funzionato. Tenere la prima esecuzione riuscita nello stesso chat dà a Okou input, correzioni e output concreti da catturare.

Cosa mettere nell'istruzione

ParteIncludere
GoalIl risultato che il flusso di lavoro deve produrre.
InputsCosa fornisce il chiamante o l'automazione, e quali input sono obbligatori.
ProcedurePassaggi ordinati, inclusi i servizi collegati da leggere o aggiornare.
OutputIl formato richiesto, la destinazione e le regole di denominazione.
BoundariesAzioni da evitare, casi che richiedono chiarimenti e quando fermarsi.
ReferencesModelli, checklist o esempi opzionali allegati come file del flusso di lavoro.

Tieni le credenziali fuori dall'istruzione e dai file. Collega il servizio tramite Connectors, poi concedi all'agente proprietario solo i permessi di cui il flusso di lavoro ha bisogno.

Testare prima di automatizzare

  1. Esegui il flusso di lavoro manualmente con un input rappresentativo.
  2. Conferma che l'agente proprietario possa raggiungere ogni connettore e permesso richiesto.
  3. Ispeziona il chat risultante per contesto mancante, scritture inattese e forma finale dell'output.
  4. Modifica le Instructions o i file allegati e riesegui finché il risultato è ripetibile.
  5. Aggiungi un'automazione solo dopo che l'esecuzione manuale è corretta. Inizia con filtri di evento stretti o una pianificazione a bassa frequenza, poi ispeziona le prime attivazioni.

La verifica manuale separa i problemi di flusso di lavoro dai problemi di trigger: se Run now fallisce, correggi prima il flusso di lavoro o il suo accesso; se Run now riesce ma un evento non scatta mai, ispeziona la configurazione dell'automazione.

Come Okou sceglie un flusso di lavoro

Non devi invocare un flusso di lavoro per nome. Okou ne carica automaticamente uno quando una richiesta in arrivo corrisponde alla sua descrizione. Un flusso di lavoro chiamato customer-reply-draft, descritto come «draft a reply to a customer email using our voice and docs», scatta quando inoltri un'email cliente, senza bisogno di nome.

Per forzarne uno specifico, dillo: "Use the customer-reply-draft workflow on this email."

Flussi di lavoro integrati

Ogni agente Okou viene fornito con un insieme di flussi di lavoro trasversali mantenuti da Okou: ricerca e analisi, finanza e contabilità, legale e conformità, prodotto, marketing, assistenza clienti e comunicazione del team. Sono procedure di dominio, non cablaggio di connettori: ciascuno insegna a Okou a gestire un tipo di lavoro ricorrente.

Un assaggio:

  • deep-dive — ricerca strutturata e progettazione di soluzioni; raccogli i fatti, poi esplora le opzioni
  • prd-writing — requisiti di prodotto con inquadramento strutturato del problema e criteri di accettazione
  • copywriting — testi di marketing multicanale (blog, email, social, landing page)
  • competitor-matrix — matrici di confronto funzionalità, analisi di posizionamento, analisi vittorie/perdite
  • customer-reply — risposte empatiche e in linea col brand, adattate a canale e urgenza
  • nda-screening — classifica gli NDA in arrivo come GREEN / YELLOW / RED e li instrada
  • status-updates — report di avanzamento e aggiornamenti per gli stakeholder, adattati a qualsiasi pubblico

I tuoi flussi di lavoro stanno accanto a questi e hanno la precedenza quando le loro descrizioni corrispondono più da vicino.

Quando crearne uno

La regola onesta: se hai scritto sostanzialmente lo stesso prompt più di due volte, o immagini che un collega lo scriverà, salvalo.

Segnali concreti:

  • Il lavoro ha un nome che il tuo team già usa («morning brief», «competitor scan»)
  • Il prompt nomina strumenti, canali o modelli specifici che non dovrebbero cambiare a ogni esecuzione
  • L'output ha una forma fissa (un digest, una bozza, un issue creato)
  • Più di una persona deve attivarlo
  • Vuoi che giri su pianificazione o evento: vedi Automations

Schemi comuni

  • Il modulo di ingresso. Prende un input (un'email, un report di bug, un thread) e produce un artefatto strutturato (un issue, una bozza, una riga).
  • Il brief di cadenza. Un flusso di lavoro abbinato a un'automazione pianificata che gira ogni giorno o settimana e pubblica in un posto visibile.
  • L'aiutante a metà conversazione. Attivato da Okou in un canale per fare una sotto-attività mirata: cercare, riassumere, classificare.
  • Il compositore. Produce un pacchetto multiformato — bozza di blog più post social più card — in un'unica esecuzione.
  • Il risponditore di eventi. Abbinato a un'automazione di eventi: una nuova email, una PR mergiata o una nuova pagina Notion avvia l'esecuzione. Vedi Automations.

Insidie da evitare

  • Troppo stretto. Un flusso di lavoro che calza solo un input specifico è fragile. Punta alla forma del lavoro, non ai dettagli di un esempio.
  • Troppo vago. «Help with marketing» è così ampio che Okou non saprà quando applicarlo. Sii specifico nella descrizione.
  • Credenziali codificate. Non incollare mai chiavi API in un'istruzione. Usa i Custom connectors: la credenziale resta sulla piattaforma, fuori dalla portata del modello.
  • Forma dell'output sepolta. Indica come deve apparire l'artefatto: «a numbered list of three items» o «a draft reply under 150 words.»
  • Dimenticare l'agente. Un flusso di lavoro può usare solo i connettori per cui il suo agente host è autorizzato. Se un flusso di lavoro non raggiunge Gmail, controlla la scheda Authorization dell'agente, non l'istruzione.

Passaggi successivi

  • Allega un trigger con Automations perché un flusso di lavoro giri senza di te.
  • Vedi Agents per chi esegue un flusso di lavoro e con quali permessi.
  • Vedi Permissions per limitare ciò che un flusso di lavoro può toccare.
  • Vedi Example workflows per cinque scritti da capo a fondo.