Flussi di lavoro

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

La prima volta che chiedi a Okou di fare qualcosa, scrivi un prompt. La seconda volta, incolli lo stesso prompt con piccole modifiche. Alla terza volta, stai copiando un prompt lungo da un documento di Notion che qualcuno ha chiamato "team prompt library". È il momento giusto per salvare un flusso di lavoro.

Il problema che i flussi di lavoro risolvono

Una chat una tantum va bene per un'attività una tantum. Ma quasi ogni team ha una coda di lavoro che si ripete — input diversi, stessa struttura:

• Un cliente scrive → recupera la sua cronologia → prepara una risposta nella sua lingua → registra il ticket
• Appare una segnalazione di bug → estrai i passaggi per riprodurlo → classifica la gravità → apri un issue strutturato
• Lunedì mattina → recupera i numeri della settimana scorsa → confrontali con quelli della settimana precedente → pubblica un riepilogo

Senza flussi di lavoro, ognuno di questi è un prompt di 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 pianificazione né trigger — è la procedura. Per farlo eseguire da solo, collega un'automazione.

Cosa contiene un flusso di lavoro

Nessun grafo dei nodi, nessuna configurazione YAML, nessuna sezione trigger. L'istruzione di solito assomiglia molto al prompt in chat che ha funzionato la prima volta.

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

Proprietà e visibilità

My Okou: i flussi di lavoro vivono nello spazio di lavoro corrente. Un flusso di lavoro privato appartiene all'utente corrente. Un flusso di lavoro pubblico è condiviso con i membri dello spazio di lavoro; pubblico non significa pubblicato su Internet. Ogni esecuzione usa le istruzioni personali (Instructions), la memoria, gli account collegati e le autorizzazioni dell'utente che esegue. Condividere la procedura non condivide queste risorse personali né i risultati privati.

Il tuo flusso di lavoro privato con lo stesso nome ha la precedenza su un flusso di lavoro pubblico. Usa l'ID esplicito del flusso di lavoro quando devi identificare una definizione condivisa specifica. Crea una copia privata ti fornisce una versione separata da adattare; le modifiche successive non si sincronizzano con l'originale. Le automazioni di un altro membro non vengono copiate. Creare un flusso di lavoro privato non ti dà il permesso di pubblicare o mantenere flussi di lavoro pubblici; le regole di pubblicazione esistenti dello spazio di lavoro continuano ad applicarsi.

Legacy Agents: ogni flusso di lavoro appartiene a un solo agente. Anche i compagni di team devono avere accesso al suo agente proprietario. Copia flusso di lavoro seleziona un agente di destinazione e crea un fork privato. L'agente fornisce il proprio profilo e le proprie istruzioni, mentre l'esecuzione usa comunque l'accesso autorizzato all'account del membro che lo sta eseguendo.

Vedi My Okou e legacy Agents per le istruzioni permanenti.

Quale esperienza stai usando?

Questa documentazione copre entrambe le esperienze. Se Settings → Personal → My Okou è disponibile, segui i passaggi di My Okou. Se usi una pagina Agents con New agent, segui i passaggi dei Legacy Agents. La disponibilità può variare tra i membri; questa documentazione non cambia la tua esperienza.

In entrambe le esperienze, puoi eseguire più chat o attività contemporaneamente, riutilizzare i flussi di lavoro e condividere con il tuo team il lavoro già verificato. Un subagent di runtime è uno strumento di esecuzione, non un profilo prodotto separato che devi creare.

Creare un flusso di lavoro

Parti dalla pagina Flussi di lavoro

1. Apri Workflows. My Okou: scegli Create in chat. Legacy Agents: scegli New workflow dove disponibile.
2. My Okou: continua nella tua chat; non è necessaria alcuna selezione di agente. Legacy Agents: seleziona l'agente che deve possedere il flusso di lavoro.
3. Okou apre una chat con un prompt guidato per la creazione del flusso di lavoro. Descrivi il risultato, gli input previsti, gli strumenti, l'output e qualsiasi limite di approvazione.
4. Rivedi il nome proposto, la descrizione, l'istruzione, i file e la visibilità prima che Okou lo crei.

Puoi anche iniziare in una chat esistente e chiedere a Okou di trasformare in un flusso di lavoro un'attività che ha già funzionato. Mantenere la prima esecuzione riuscita nella stessa chat fornisce a Okou input concreti, correzioni e output da acquisire.

Esempio My Okou: le istruzioni del flusso di lavoro descrivono il lavoro ripetibile.

Cosa inserire nell'istruzione

Tieni le credenziali fuori dall'istruzione e dai file. Collega il servizio tramite Connectors, quindi rivedi l'account collegato e concedi solo le autorizzazioni di cui il flusso di lavoro ha bisogno; nei Legacy Agents, autorizza anche il suo agente proprietario.

Prova prima di automatizzare

1. Esegui il flusso di lavoro manualmente con un input rappresentativo.
2. Conferma che il membro che esegue abbia l'accesso all'account e le autorizzazioni richieste; nei Legacy Agents, verifica anche l'autorizzazione dell'agente proprietario.
3. Esamina la chat risultante per individuare contesto mancante, scritture inattese e la forma finale dell'output.
4. Modifica le Instructions o i file allegati ed eseguilo di nuovo finché il risultato non è ripetibile.
5. Aggiungi un'automazione solo dopo che l'esecuzione manuale è corretta. Inizia con filtri evento stretti o una pianificazione a bassa frequenza, poi controlla i primi eventi attivati.

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

Come Okou sceglie un flusso di lavoro

Non è necessario richiamare 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 "scrivi una bozza di risposta a un'email di un cliente usando il nostro tono di voce e la nostra documentazione", si attiva quando inoltri un'email di un cliente, senza bisogno di indicarne il nome.

Per forzarne uno specifico, dillo esplicitamente: "Usa il flusso di lavoro customer-reply-draft per questa email."

Flussi di lavoro predefiniti

Okou include un elenco di flussi di lavoro interfunzionali mantenuti da Okou — ricerca e analisi, finanza e contabilità, legale e compliance, prodotto, marketing, assistenza clienti e comunicazione di team. Sono procedure di dominio, non plumbing di connector: ognuno insegna a Okou come 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 framing strutturato del problema e criteri di accettazione
• copywriting — copy di marketing su più canali (blog, email, social, landing page)
• competitor-matrix — matrici di confronto delle funzionalità, teardown di posizionamento, analisi win/loss
• customer-reply — risposte empatiche, in linea con il brand, adattate al canale e all'urgenza
• nda-screening — classifica gli NDA in arrivo come GREEN / YELLOW / RED e instradali
• status-updates — report di avanzamento e aggiornamenti per gli stakeholder adattati a qualsiasi pubblico

I tuoi flussi di lavoro si affiancano 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 puoi immaginare che lo scriva un collega — salvalo.

Segnali concreti:

• Il lavoro ha un nome che il tuo team usa già ("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 riepilogo, una bozza, un issue aperto)
• Più di una persona deve poterlo attivare
• Vuoi che venga eseguito su un programma o in risposta a un evento — vedi Automazioni

Schemi comuni

• Il modulo di intake. Prende un input (un'email, una segnalazione di bug, un thread) e produce un artefatto strutturato (un issue, una bozza, una riga).
• Il brief cadenzato. Un flusso di lavoro abbinato a un'automazione pianificata che viene eseguita ogni giorno o ogni settimana e pubblica in un punto visibile.
• L'assistente in corso di conversazione. Attivato da @Okou in un canale per svolgere una singola sotto-attività mirata — cercare, riassumere, classificare.
• Il compositore. Produce in un'unica esecuzione un pacchetto multi-formato — bozza di blog più post social più card.
• Il responder di eventi. Abbinato a un'automazione basata su evento: una nuova email, una PR mergiata o una nuova pagina Notion avvia l'esecuzione. Vedi Automazioni.

Insidie da evitare

• Troppo restrittivo. Un flusso di lavoro che si adatta solo a un input molto specifico è fragile. Punta alla forma del lavoro, non ai dettagli di un singolo esempio.
• Troppo vago. "Aiuta con il marketing" è così ampio che Okou non saprà quando applicarlo. Sii specifico nella descrizione.
• Credenziali hardcoded. Non incollare mai chiavi API in un'istruzione. Usa invece custom connectors — la credenziale resta sulla piattaforma, fuori dalla portata del modello.
• Forma dell'output nascosta. Indica come dovrebbe apparire l'artefatto: "un elenco numerato di tre elementi" oppure "una bozza di risposta sotto 150 parole."
• Dimenticare l'accesso. Un flusso di lavoro condiviso non concede l'accesso ai connector. Controlla il tuo account collegato, le autorizzazioni richieste e qualsiasi controllo dell'account Chat disponibile per te. Nei Legacy Agents, controlla anche le impostazioni di Authorization dell'agente proprietario.

Prossimi passi

• Collega un trigger con Automazioni così un flusso di lavoro viene eseguito senza di te.
• Vedi Agents per sapere chi esegue un flusso di lavoro e con quali autorizzazioni.
• Vedi Autorizzazioni per limitare a cosa può accedere un flusso di lavoro.
• Vedi Flussi di lavoro di esempio per cinque esempi scritti dall'inizio alla fine.