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