Lezione gratuita

Che cosa significa «il processo funziona»

Che cosa significa «il processo funziona» — Gestire workflow AI affidabili. Stato del processo e risultato del lavoro; Macchina a stati del lavoro; Verificare esiti senza un modello attivo. Esercitazione pratica: Che cosa significa «il processo funziona».

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Stato del processo e risultato del lavoro
  • Macchina a stati del lavoro
  • Verificare esiti senza un modello attivo

Stato del processo e risultato del lavoro

Un processo attivo può non completare lavori per ore. Parti dal risultato osservabile dall’utente. Nel workflow didattico meeting.txt passa da lettura a riepilogo, verifica e salvataggio di summary.json in una cartella privata. Il successo è un artefatto valido legato alla versione dell’ingresso, non il solo exit code 0 o «fatto» del modello. Definisci process_alive, job_started, artifact_validated e artifact_persisted separatamente. Se job_started è vecchio ma process_alive recente, verifica lavoro bloccato o coda vuota invece di riavviare tutto. Una coda vuota è idle. Un lavoro incompleto è running, oppure stuck oltre una scadenza specificata. Altrimenti la normale inattività sembra un guasto e l’attività senza risultati sembra sana. Registra percorso e hash dell’artefatto come prova del salvataggio.

Macchina a stati del lavoro

Definisci le transizioni prima delle ripetizioni: queued → running → validated → completed. Usa retry_wait per guasti temporanei, failed per tentativi esauriti e outcome_unknown per scritture esterne incerte. Non consentire completed prima di verificare l’artefatto e salvarne il riferimento. Un summary.json vuoto non è completo solo perché esiste. Il worker registra un errorCode sicuro e deve completare o rilasciare il lavoro preso. Se si arresta in running, un altro processo può controllare e recuperare dopo la scadenza del lease. Il lease è un diritto temporaneo d’esecuzione, non una prova di completamento. Separa attemptNumber da jobId: una ripetizione è un altro tentativo dello stesso lavoro. Valida centralmente le transizioni invece di distribuirle tra messaggi di registro.

Verificare esiti senza un modello attivo

Prepara uno stub generatore con tre uscite: JSON valido, stringa vuota e eccezione TIMEOUT. Passale attraverso il validatore effettivo e la macchina a stati. Il JSON valido viene salvato con inputHash; il vuoto produce VALIDATION_FAILED senza completed; il timeout entra in retry_wait secondo la politica. Verifica l’infrastruttura del workflow, non la qualità di un modello reale. Per i contenuti servono fixture fattuali o revisione manuale separata. Salva i risultati osservati in report.json con status, attempt e artifactHash. Se descrivi soltanto il test, indica not_run senza inventare hash. Lo stub consente di sviluppare affidabilità senza API reali, ma non determina costi o latenza del futuro servizio. Mantieni invariati i file originali durante il test.

Esercitazione pratica

Che cosa significa «il processo funziona»

Vai alla lezione

Programma del corso

  1. Che cosa significa «il processo funziona»
  2. Registri strutturati senza segreti
  3. Tracciamento e latenza senza aritmetica fuorviante
  4. Ripetizioni, idempotenza e limiti di costo
  5. Segnali che portano a un’azione concreta
  6. Checkpoint, backup e prove di ripristino