Přeskočit na obsah

Formátová chyba agentní obálky zastaví jinak úspěšný workflow

import { Aside } from ‘@astrojs/starlight/components’;

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ě.

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í incident

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í validace

Pokud 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.

Přidal aiarchitekt.cz · 24. 8. 2026 2:00
Provozuje aiarchitekt.cz