Concetto

Stato del workflow

Definizione

Il stato del workflow è la rappresentazione completa della condizione attuale di un processo autonomo: azioni in sospeso, passaggi completati, dipendenze dai dati, contesto disponibile, variabili attive e prossimi punti di decisione. Funziona come fonte unica di verità che gli agenti usano per coordinare operazioni complesse in più passaggi e riprendere i processi interrotti senza perdere progressi o contesto.

Nei sistemi autonomi, lo stato del workflow funziona da memoria condivisa che sincronizza più agenti, operatori umani e sistemi esterni, garantendo che tutti lavorino sulla stessa comprensione di ciò che è accaduto, di ciò che sta accadendo e di ciò che deve accadere dopo.

Spiegazione tecnica

La gestione dello stato del workflow è fondamentale per un funzionamento autonomo affidabile. Richiede una progettazione attenta per bilanciare la completezza (catturare tutto ciò che serve per decisioni corrette) con l'efficienza (evitare sovraccarico di informazioni e costi di archiviazione eccessivi).

Componenti dello stato

Modelli di persistenza dello stato

Modelli di coerenza dello stato

// Rappresentazione dello stato del workflow interface WorkflowState { workflowId: string; // Identificatore univoco workflowType: string; // Identificatore del modello/definizione status: WorkflowStatus; // In esecuzione, In pausa, Completato, Fallito currentStep: StepReference; // Dove siamo ora completedSteps: StepResult[]; // Cosa abbiamo fatto pendingSteps: StepReference[]; // Coda delle attività future variables: Map<string, any>; // Contesto dei dati (input, output, derivati) actors: ActorAssignment[]; // Chi fa cosa dependencies: DependencyGraph; // Relazioni tra attività e flusso dei dati constraints: Constraint[]; // Regole di business e SLA eventLog: StateEvent[]; // Cronologia immutabile delle modifiche version: number; // Per il blocco ottimistico metadata: { priority: number; createdAt: Date; deadline?: Date; retryCount: number; maxRetries: number; lastError?: ErrorInfo; }; } // Macchina a stati per il ciclo di vita dell'esecuzione enum WorkflowStatus { PENDING = "pending", // Creato, non ancora avviato RUNNING = "running", // Esecuzione attiva PAUSED = "paused", // Interrotto intenzionalmente WAITING = "waiting", // Bloccato su una dipendenza esterna COMPLETED = "completed", // Completamento riuscito FAILED = "failed", // Stato di errore terminale CANCELLED = "cancelled" // Terminato intenzionalmente } // Esempio: ripresa dopo un fallimento async function resumeWorkflow(workflowId: string): Promise<void> { const state = await stateStore.load(workflowId); if (state.status !== WorkflowStatus.FAILED) { throw new Error("Impossibile riprendere un workflow non fallito"); } // Individua il punto di fallimento const lastError = state.metadata.lastError; const failedStep = state.currentStep; // Determina la strategia di recupero const recoveryPlan = await recoveryEngine.analyze( failedStep, lastError, state.completedSteps ); // Applica il recupero if (recoveryPlan.canRetry) { // Reimposta il passaggio fallito e riprova state.currentStep = failedStep; state.variables = { ...state.variables, ...recoveryPlan.resetValues }; state.status = WorkflowStatus.RUNNING; state.metadata.retryCount += 1; await stateStore.save(state); await executeWorkflow(workflowId); } else if (recoveryPlan.requiresHuman) { // Escala per l'intervento manuale state.status = WorkflowStatus.PAUSED; await notifyHumanOperator(workflowId, recoveryPlan.escalationReason); await stateStore.save(state); } else { // Segna come fallito in modo permanente state.status = WorkflowStatus.FAILED; await stateStore.save(state); } }

Gestione distribuita dello stato

Per workflow che attraversano più sistemi o agenti:

Esempi reali

Pipeline di approvazione dei prestiti

Scenario: elaborazione di una domanda di mutuo con raccolta dei documenti, verifica creditizia, verifica del reddito, revisione da parte dell'analista e coordinamento del finanziamento attraverso oltre 12 sistemi.

Gestione dello stato del workflow:

  • Stato del processo: tiene traccia di quali dei 47 passaggi sono stati completati (ad es. «W2 raccolto», «Verifica creditizia richiesta», «Perizia programmata»).
  • Dipendenze dei dati: individua che la valutazione non può procedere finché la verifica del reddito e la perizia non sono complete.
  • Coordinamento degli attori: indirizza i documenti agli specialisti appropriati (operatore, analista, addetto alla chiusura) in base allo stato attuale e al carico di lavoro.
  • Gestione delle eccezioni: rileva i documenti mancanti dopo 48 ore, attiva il contatto automatizzato con il richiedente ed escala a una persona se il problema resta irrisolto.
  • Snapshot dello stato: se il sistema si arresta durante il bonifico di finanziamento, ripristina lo stato esatto e riprende senza duplicare i passaggi.
// Stato del workflow della domanda di prestito loanApplicationState = { workflowId: "loan_12345", status: "running", currentStep: "underwriting_review", variables: { applicantId: "cust_789", loanAmount: 450000, creditScore: 742, ltv: 0.78, documents: { w2: { status: "collected", timestamp: "2024-01-15" }, paystub: { status: "collected", timestamp: "2024-01-15" }, bankStatement: { status: "pending", due: "2024-01-22" } } }, completedSteps: [ "application_received", "credit_pull_initiated", "income_verification_sent", "asset_verification_started" ], pendingSteps: [ "underwriting_review", "appraisal_ordering", "title_search", "closing_coordination" ], dependencies: { "underwriting_review": { requires: ["credit_pull", "income_verification", "asset_verification"] }, "closing_coordination": { requires: ["underwriting_approval", "appraisal_complete"] } }, metadata: { slaDeadline: "2024-02-15", priority: "high", retryCount: 0, lastUpdated: "2024-01-20T10:30:00Z" } }

Beneficio: i tempi di lavorazione sono passati da 45 a 22 giorni grazie al monitoraggio automatizzato dello stato, al rilevamento dei colli di bottiglia e all'escalation delle eccezioni. Nessun prestito perso o duplicato nonostante diversi guasti di sistema durante la migrazione.

Onboarding dei clienti con più agenti

Scenario: piattaforma SaaS con 5 agenti specializzati (ricercatore, scrittore, sviluppatore, tester, addetto alla distribuzione) che collaborano su implementazioni personalizzate per clienti aziendali.

Gestione dello stato del workflow:

  • Contesto condiviso: tutti gli agenti accedono a uno stato unificato che include requisiti, decisioni prese, modifiche al codice e risultati dei test.
  • Protocolli di passaggio di consegne: l'agente ricercatore segna l'attività come completata → lo stato passa a «development_ready» → l'agente sviluppatore si assegna automaticamente e inizia a lavorare.
  • Lavoro concorrente: più stati monitorati simultaneamente (ad es. lo sviluppatore lavora alla funzione A mentre il ricercatore indaga sulla funzione B).
  • Capacità di rollback: se la distribuzione fallisce, lo stato torna alla condizione precedente e avvisa l'operatore umano.
  • Trasparenza dell'avanzamento: la dashboard del cliente legge lo stato del workflow per mostrare l'avanzamento in tempo reale senza interrogare i singoli agenti.
// Coordinamento dello stato tra più agenti onboardingWorkflowState = { activeSprints: [ { feature: "Integrazione SSO", state: "in_development", assignedAgent: "developer_01", dependencies: ["oauth_spec_approved"], blockers: [], progress: 0.65 }, { feature: "Registrazione degli audit", state: "in_research", assignedAgent: "researcher_02", dependencies: ["compliance_requirements"], blockers: ["waiting_for_security_input"], progress: 0.20 } ], completed: ["user_model_update", "database_migration"], blockers: [ { id: "sec_input_001", description: "Serve l'approvazione del team di sicurezza sugli ambiti OAuth", reportedBy: "researcher_02", escalatedTo: "human_manager", createdAt: "2024-01-18" } ], // Sincronizzazione in tempo reale tra agenti version: 147, lastModifiedBy: "developer_01", lastModifiedAt: "2024-01-20T14:22:00Z" } // L'agente interroga lo stato per nuove assegnazioni async function pollForWork(agentId: string): Promise<Task | null> { const state = await workflowState.getCurrent(); return state.pendingSteps.find(task => task.requiredSkills.includes(agentId.skillset) && task.dependencies.every(dep => state.completedSteps.includes(dep)) ); }

Beneficio: i tempi del ciclo di onboarding sono diminuiti del 40% grazie all'esecuzione parallela, a una chiara gestione delle dipendenze e al coordinamento automatico degli agenti. Nessun lavoro perso nonostante 3 guasti di agenti in un periodo di 6 mesi.

Gestione delle eccezioni nella catena di approvvigionamento

Scenario: catena di approvvigionamento globale con oltre 200 fornitori, più operatori logistici e dipendenze complesse su più livelli.

Gestione dello stato del workflow:

  • Rilevamento a cascata: la macchina a stati rileva che un ritardo del fornitore A influisce sulla produzione B e sul cliente C.
  • Instradamento alternativo: valuta e passa automaticamente ai fornitori di riserva quando vengono superate le soglie.
  • Propagazione dello stato: gli aggiornamenti si propagano a tutti i sistemi a valle (ERP, portali clienti, logistica) mantenendo la coerenza.
  • Monitoraggio del recupero: tiene traccia delle azioni di mitigazione e calcola in tempo reale le nuove date di consegna stimate.

Beneficio: le rotture di scorta sono diminuite dell'89%, l'approvvigionamento alternativo automatico si è attivato 340 volte in 6 mesi e la gestione manuale delle eccezioni è passata da 15 ore a 2 ore a settimana.

Termini correlati

Resta aggiornato.

Analisi tecniche, nuovi sistemi realizzati e lezioni dalla distribuzione di IA autonoma. Un'email a settimana, direttamente nella tua casella.

Un'email a settimana. Esci con un clic.