PydanticAI 2.11 zlepšuje chyby pri limitoch a opravuje štruktúrované výstupy

PydanticAI vydal verziu 2.11.0, relatívne malé, ale prakticky dôležité vydanie pre tímy, ktoré stavajú agentov nad viacerými poskytovateľmi modelov. Release neprináša veľkú marketingovú funkciu, no rieši presne tie okraje, ktoré v produkčných agentoch zvyknú spôsobovať veľa času: zrozumiteľnosť chýb, práca s históriou a správne odosielanie schém pre štruktúrované výstupy.

Najviditeľnejšia novinka je export HistoryProcessor. Pre vývojárov to znamená jednoduchší prístup k mechanizmu, ktorý spracúva históriu správ pred tým, než sa použije v agentickom behu. V praxi je história čoraz dôležitejšia, pretože agenti pracujú s dlhšími konverzáciami, nástrojovými volaniami, čiastočnými výsledkami a opakovanými pokusmi. Ak framework umožní lepšie zasahovať do histórie, tímy môžu presnejšie kontrolovať, čo sa dostane do kontextu modelu.

Druhá zmena sa týka chybových hlásení pri limitoch používania a opakovaní nástrojov. PydanticAI má po novom pridávať akčnejšie nápovedy, teda hlásenia, ktoré vývojárovi nepovedia iba, že niečo zlyhalo, ale aj čo má skontrolovať alebo upraviť. Pri agentoch je to dôležité, pretože limity často vznikajú až z interakcie viacerých vrstiev: model potrebuje viac krokov, nástroj vracia nečakaný výsledok, retry politika sa vyčerpá a používateľ vidí len všeobecnú chybu.

Vydanie opravuje aj validáciu streamovaných čísel v MistralStreamedResponse. Zmena je technická, ale ukazuje, aké jemné môžu byť rozdiely medzi poskytovateľmi a režimami výstupu. Int hodnoty reprezentované ako čísla majú byť akceptované, booleany naopak odmietnuté. Pri štruktúrovaných dátach je podobná presnosť dôležitá, pretože chyba typu sa môže preniesť do ďalšieho nástroja alebo validátora.

Najpraktickejšie opravy sa týkajú natívnych štruktúrovaných výstupov pri Anthropic a Amazon Bedrock. Release uvádza opravy transformácie schémy v situáciách, keď sa režim dosiahne cez profil s default_structured_output_mode nastaveným na native. Inak povedané, framework už nemá posielať nepretransformovanú schému tam, kde konkrétny backend očakáva vlastný formát.

To je presne typ problému, ktorý sa v lokálnych testoch nemusí ukázať, no v produkcii rozbije agentický workflow. Agent môže mať správne napísaný Pydantic model, správny prompt aj správny nástroj, ale ak sa schéma pri prechode na konkrétneho poskytovateľa zle preloží, zlyhá celé volanie alebo vznikne nevalidný výstup. Frameworky pre agentov preto musia robiť viac než obaliť API; musia normalizovať rozdiely medzi poskytovateľmi.

PydanticAI 2.11 prichádza krátko po verzii 2.10, ktorá už riešila históriu správ, režim na pozadí a bezpečnostnú závislosť. To naznačuje rýchly cyklus stabilizácie po väčších zmenách v druhej generácii frameworku. Pre tímy v produkcii to má dve strany: oplatí sa sledovať nové opravy, ale zároveň treba mať dobré integračné testy, pretože aj menšie vydania môžu meniť správanie naprieč poskytovateľmi.

Pre slovenské vývojárske tímy je praktický záver jednoduchý. Ak používajú PydanticAI s Anthropic, Bedrockom alebo Mistralom a spoliehajú sa na štruktúrované výstupy, verzia 2.11 stojí za kontrolu. Nie preto, že prináša novú veľkú schopnosť, ale preto, že znižuje riziko tichých hraničných chýb pri schémach a typoch.

Zároveň je to ďalší dôkaz, že agentické frameworky dozrievajú cez malé prevádzkové opravy. Vývojárov často lákajú benchmarky modelov, no spoľahlivosť agenta v skutočnosti stojí na detailoch: ako sa spracuje história, ako presne sa validujú typy, ako zrozumiteľné sú chyby a či abstrakcia nad poskytovateľmi naozaj zachová správnu schému. PydanticAI 2.11 je práve takýto údržbový, ale produkčne relevantný krok.

Aj keď ide o údržbové vydanie, má význam pre governance agentických aplikácií. Organizácie, ktoré povoľujú agentom volať nástroje naprieč cloudmi, potrebujú vedieť, že schéma poslaná modelu je rovnaká, akú očakáva ich validačná vrstva. Každá oprava v tejto oblasti znižuje priestor pre nejasné zlyhania, kde sa chyba objaví až v ďalšom kroku workflow. Preto sa oplatí čítať aj malé release notes, nie iba veľké oznámenia modelov.