Formátová chyba agentní obálky zastaví jinak úspěšný workflow
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Implementační agent dokončí kontrolu nebo změnu a vrátí strukturovanou JSON obálku. Jeden důkaz však obsahuje zkrácený nebo jinak neplatný SHA-256, takže striktní parser odmítne celou odpověď. Orchestrátor následně ukáže terminální incident, přestože samotná práce mohla být dokončena správně.
Root cause
Sekce “Root cause”Systém nerozlišoval dvě odlišné třídy selhání:
- chybu práce nebo neznámý stav vedlejších účinků;
- lokální chybu formátu finální předávací obálky.
Obě výjimky končily stejnou terminální větví. Automatické zopakování celé práce by přitom bylo nebezpečné, zatímco zopakování pouze serializace výsledku je bezpečné a žádoucí.
práce dokončena → neplatná evidence.sha256 → parser error → terminální incidentFix
Sekce “Fix”Adaptér po prvním validačním selhání spustí právě jedno omezené opravné kolo. Agent dostane přesnou chybu parseru a výslovný zákaz opakovat práci, měnit soubory, commit nebo externí stav. Má pouze znovu ověřit skutečné hodnoty a vrátit korektní obálku svázanou se stejným correlation ID a operation ID.
první obálka neplatná → přesná validační chyba → „neměň stav, oprav jen obálku" → druhá obálka → znovu plná striktní validacePokud selže i druhá obálka, workflow teprve potom skončí incidentem. Bezpečnostní validace se nezměkčuje a neplatný hash se nikdy automaticky nedopočítává z nedůvěryhodného textu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Testuj zvlášť neplatný hash, chybějící pole, špatnou korelaci a dvě obálky v jedné odpovědi.
- Anti-pattern: Každou výjimku adaptéru okamžitě mapovat na terminální incident bez klasifikace fáze a vedlejších účinků.
- Lepší přístup: Opravuj jen přenosovou obálku, zachovej původní identitu operace a omez počet pokusů pevnou konstantou.
Sister bugs / související
Sekce “Sister bugs / související”Příbuzná je kolize aktivního zapisovatele při obnově sdílené agentní session. V obou případech má orchestrátor rozlišit technickou chybu adaptéru od věcného výsledku práce, ale nesmí automaticky opakovat neznámé mutace.