Agentic AI Osservabilità per il fan-out: dimostrare il quorum di completamento

In una corsa di agenti di fan out, un genitore finito non è la prova che il lavoro è completo. Il genitore potrebbe aver raccolto il ramo più veloce, ignorato una revisione richiesta, combinato un risultato obsoleto, o contato lo stesso ramo due volte. L'osservabilità dell'agente AI richiede un quorum di completamento: un elenco congelato delle succursali attese più ricevute fresche, uniche e verificate dal risultato per ogni succursale richiesta e il numero dichiarato di succursali facoltativi. Il default pratico è rigoroso. Prima di spedire, congela il manifesto della filiale, identifica il lavoro richiesto e opzionale, fissa una scadenza e lascia che solo le ricevute verificate soddisfino il quorum. Prima della scadenza, la copertura mancante può essere waiting . Dopo la scadenza è incomplete . Se il modello di riferimento segnala il successo senza copertura, etichettalo con la false complete invece di trasformare in verde la bandiera del terminale conveniente. Le tracce mostrano il ventilatore, ma non definiscono il completamento Il OpenAI Agents SDK documentazione di tracciamento registra generazioni, chiamate agli strumenti, guardrails, consegne, eventi personalizzati, ID di span dei genitori e timestamp. La OpenTelemetry convenzioni di span degli agenti GenAI, attualmente contrassegnata Development, descrive le operazioni che comprendono l'invocazione di agenti, la pianificazione e l'esecuzione degli strumenti. Tali registri sono prove utili dell'attività. Non sanno quali filiali richiede l'operatore o quale risultato osservabile deve ciascun ramo. Una traccia può contenere quattro spazi successivi, mentre non viene mai visualizzato il quinto ramo, la revisione della sicurezza, la verifica della destinazione o la fonte di dati regionali. Guardare solo le spalle emesse crea un problema di selezione: mancare di lavoro non lascia spazio per l'ispezione. I sistemi di lotti generali rendono esplicito l'insieme previsto. La Kubernetes Documentazione del lavoro distingue il lavoro parallelo con un numero di completamenti fisso dai lavori in coda di lavoro. Per i lavori indicizzati, il completamento richiede un Pod con successo per ogni indice; la documentazione avverte anche che più di un Pod possono iniziare per lo stesso indice e conta solo il primo completamento con successo. Il fan out dell'agente non è un lavoro di Kubernetes, ma il trasferimento delle lezioni operative: l'identità e la copertura prevista sono importanti, non solo un numero totale di eventi di successo. Per il lavoro di agente, il genitore deve congelare un manifesto come questo prima di delegare: Il congelamento conta. Se il genitore può rimuovere silenziosamente un ramo lento richiesto dopo la spedizione, il denominatore cambia per adattarsi al risultato osservato. Una revisione manifesta può essere legittima, ma ha bisogno di una nuova versione, ragione e limite di approvazione piuttosto che di una modifica in loco. Facciamo sì che ogni ricevuta sia un risultato Una ricevuta di succursale richiede più di status: succeeded . Dategli l'identità del ramo congelato, il tempo di osservazione, un digestivo delle prove e un risultato di un controllo indipendente: La digestione dovrebbe coprire una proiezione canonica e non segreta del risultato promesso. Per un ramo di prova, questo potrebbe includere il commit, il comando di prova, lo stato di uscita e il sommario di prova normalizzato. Per la ricerca, potrebbe coprire gli URL di sorgente selezionati, i tempi di recupero e il libro dei reclami. Per un ramo di consegna, utilizzare l'identità dell'oggetto di destinazione e un risultato di verifica sul lato lettura. Non scambiate in modo accurato le richieste grezzi, le credenziali o i carichi utili sensibili solo per far sembrare rigoroso il ricevimento. Valutare le ricevute in un ordine che preservi l'incertezza: 1. Repudiare un manifesto invalido, un ID di filiera sconosciuto o ricevute duplicate in conflitto come uncertain . 2. Ritorna incomplete quando un ramo richiesto fallisce esplicitamente. 3. Ritorna unverified quando il risultato richiesto è obsoleto, manca di una digestione delle prove o non si verifica l'esito indipendentemente. 4. La copertura contabile è limitata a quando ogni ramo richiesto ha un nuovo successo verificato e i successi verificati facoltativi soddisfano il quorum dichiarato. 5. Ritorna complete solo quando la copertura è soddisfatta e il genitore è terminale; altrimenti restituisce ready to finalize . 6. Se la copertura manca, restituire waiting solo mentre il termine rimane aperto. 7. Ritorna false complete quando la data di scadenza è precoce o incomplete quando scade prima la scadenza. I duplicati in conflitto meritano un trattamento speciale. Due ricevute per lo stesso ramo con diverse digestioni di prove possono indicare un nuovo tentativo, una divisione cerebrale o un'uscita non deterministica. Accettare arbitrariamente il risultato più recente nasconde il conflitto. Tenere lo stato uncertain fino a quando una politica specifica per l'azienda non identifica il tentativo di autorizzazione. Riproduci sette stati di completamento L'artefatto di accompagnamento ha un classificatore deterministico su sette casi di ventilazione sintetica: Il replay ha prodotto: research 42 ha verificato le ricevute per entrambe le succursali richieste e per una delle due succursali facoltative, soddisfacendo esattamente il suo quorum facoltativo. Poiché il suo genitore è terminale, è complete . merge 17 ha la copertura richiesta completa, ma rimane ready to finalize perché l'esecuzione madre è ancora aperta. I casi di errore in coppia rivelano perché un singolo campo running/completed è inadeguato. approval 09 manca una ricevuta richiesta ma rimane entro la scadenza, quindi è waiting . early parent 08 ha lo stesso intervallo di copertura ma una madre terminale, quindi diventa immediatamente false complete . Il classificatore non attende il termine per ammettere che l'affermazione di successo non è corroborata. unchecked 24 include una ricevuta di controllo di destinazione con successo il cui campo outcomeVerified è falso. E' unverified , non completo. conflict 15 presenta due digesti diversi per lo stesso ramo e rimane quindi uncertain . L'artefatto tratta le prove mancanti e le prove contraddittorie come diversi problemi operativi. Si tratta di una regola decisionale falsificabile, non di una misurazione della frequenza di fallimento della produzione. Sette casi costruiti dimostrano copertura di filiali e ordini statali; non possono stabilire scadenze universali o mostrare quanto spesso gli agenti reali perdano il lavoro di fan out. Calibrare il quorum senza renderlo cosmetico Inizia con la semantica dei rami. Di solito è richiesta una revisione della sicurezza, l'approvazione dell'azione distruttiva o la verifica della destinazione, anche se succedono diversi rami di arricchimento opzionali. Non lasciare mai che un quorum numerico facoltativo superi un ramo richiesto. Se due delle tre fonti è accettabile, codificare tutte e tre come facoltative con quorum due e preservare le loro identità. Determina la scadenza dalla classe di compiti, non da un timeout globale dell'agente. Una revisione interattiva del codice e una scansione regionale di notte hanno aspettative diverse. Registra il tempo del collezionista e il tempo della fonte; respingere le ricevute osservate prima del congelamento manifesto o in modo improbabile dopo il tempo di osservazione. Se gli orologi non possono essere affidabili, superficiale uncertain piuttosto che indovinare la freschezza. Persiste il manifesto e le ricevute abbastanza duratura per sopravvivere ai riavviamenti dei genitori. Un elenco ricostruito basato solo su bambini attualmente visibili può omettere un ramo che ha fallito prima che la telemetria fosse rovinata. Immagazzinare una versione del manifesto, l'ID di esecuzione dei genitori, l'identità della filiale, l'identità del tentativo di ricevimento e il motivo finale di classificazione. Se è possibile eseguire una duplice esecuzione, rendere esplicita la regola dell'autorità invece di basarsi sull'ordine di arrivo. Infine, separare la diagnosi dall'intervento. Una ricevuta mancante può giustificare la notifica al proprietario, la richiesta di prove o la preparazione di un nuovo tentativo limitato. Non autorizza la spesa ripetuta, la cancellazione, i cambiamenti di credenziali o la silenziosa caduta della filiale. Dopo un nuovo tentativo approvato, richiedere una nuova ricevuta e rivedere il quorum. Il limite è importante: un quorum di completamento dimostra la copertura dichiarata, non che il manifesto cattura ogni reale esigenza. Un controllo dei rami deboli può anche verificare l'artefatto sbagliato. Rivedere la progettazione del manifesto e i controlli dei risultati con la stessa attenzione del codice del classificatore. Sidewisp è attualmente in anteprima privata. Il suo sito pubblico e la sua biblioteca di articoli sono in diretta, ma la raccolta dell'agente di produzione sanità, gli adattatori runtime e il recupero non sono generalmente spediti. Sidewisp è destinato a contribuire a rendere visibili i confini di prova, attesa, errore di completamento e approvazione accanto ai tempi di esecuzione esistentinon a sostituire il tempo di esecuzione o a fungere da fissatore autonomo. Se i quorum di completamento corrispondono a un fallimento che è necessario ispezionare, è possibile aderire all'accesso anticipato senza considerare l'anteprima come una richiesta di monitoraggio implementata.