Přeskočit na obsah

Provider session limit zapsaný jako obecný incident

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

Implementační agent ukončil CLI s návratovým kódem 1 a zprávou, že dosáhl limitu relace. Orchestrátor událost uložil jako obecný INCIDENT, i když poslední věcný výsledek i pracovní strom zůstaly beze změny. Standardní budget recovery pak operaci odmítla, protože podporovala jen stav BLOCKED_ON_BUDGET.

Adapter sloučil dvě odlišné třídy selhání do stejného výsledku:

provider usage/session limit -> rc 1 -> generic adapter incident
arbitrary adapter failure -> rc 1 -> generic adapter incident

Tím se ztratila informace, že první větev je bezpečně obnovitelná rotací agentní relace. Obecné obnovení každého rc 1 by naopak bylo nebezpečné, protože neznámý výsledek mohl nastat po částečném efektu.

Recovery přijímá jen hash konkrétní journal události a úzký normalizovaný tvar provider hlášky. Dále ověří, že incident vznikl přímo z implementační fáze, že neexistuje novější incident a že databáze stále odpovídá přesné verzi blokace.

INCIDENT(version=N, source=IMPLEMENTING)
+ exact journal SHA
+ recognized provider session-limit message
+ no newer failure
-> atomic CAS to IMPLEMENTING(version=N+1)
-> fresh operation-scoped session, initialized=false

Před změnou databáze se durabilně zapíše recovery intent. Po atomické změně fáze a session bindingu se zapíše výsledek, takže opakované spuštění je idempotentní. Jakýkoli jiný adapter error zůstává fail-closed.

Jak se tomu vyvarovat v jiných systémech

Sekce “Jak se tomu vyvarovat v jiných systémech”
  • Detection: Hledej obecné větve rc != 0 -> INCIDENT, které nezkoumají strojově rozpoznatelné provider limity.
  • Anti-pattern: Recovery podle volného textu bez vazby na journal hash, verzi stavu a původní fázi.
  • Lepší přístup: Klasifikuj limit co nejblíže adapteru; recovery dělej jako úzký compare-and-swap s novým session ID, durable intentem a regresním testem pro odmítnutí nesouvisejícího rc 1.

Sister bugs / související

Sekce “Sister bugs / související”

Příbuzná je ztráta finální agentní obálky po úspěšné assistant zprávě. Tam je vhodná reconciliation stejné relace; zde je správná rotace relace, protože provider výslovně ukončil její dostupný rozpočet.

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