PydanticAI 2.23 pridáva limity nákladov a opravuje únik prihlasovacích údajov v Google Cloud

PydanticAI vydal verziu 2.23.0 s funkciami pre kontrolu nákladov, dynamickú dostupnosť nástrojov a širšie nastavenie požiadaviek na Amazon Bedrock. Vydanie zároveň opravuje chybu v práci s prihlasovacími údajmi Google Cloud, možné zablokovanie pri nesprávnom limite súbehu Bedrocku a nedôslednosti v streamovaní, instrumentácii a ukončovaní asynchrónnych spojení. Ide o pokračovanie rýchlo vydávanej série 2.x; správcovia projektu označili 2.23.0 za najnovšiu verziu 4. augusta.

Najviditeľnejšou novinkou pre produkčné nasadenia je pridanie položky cost do objektu RunUsage a limitu cost_limit do UsageLimits. Framework tak môže popri počte požiadaviek či tokenov pracovať aj s finančným rozpočtom behu. Pri agentoch je takáto hranica dôležitejšia než pri jednorazovom volaní modelu: agent môže opakovane plánovať, volať nástroje, opravovať chybu a znova sa pýtať modelu. Malá chyba v slučke preto nemusí vytvoriť iba pomalú odpoveď, ale aj nečakane vysokú spotrebu platenej služby.

Samotná existencia cost_limit ešte neznamená úplné finančné riadenie aplikácie. Výsledok závisí od toho, či konkrétny poskytovateľ a model dodajú údaje, z ktorých framework cenu spoľahlivo odvodí, a či cenník zodpovedá reálnemu účtovaniu. Limit na úrovni jedného behu tiež nenahrádza rozpočet pre používateľa, tím alebo celé prostredie. Nová primitíva však umožňuje vývojárom začleniť cenu priamo do pravidiel vykonávania namiesto toho, aby ju kontrolovali iba spätne v samostatnom monitoringu.

Druhá nová schopnosť, ToolAvailabilityDeltaPart, slúži na natívne vykreslenie udalostí tool_addition a additional_tools. Prakticky ide o podporu situácie, keď sa množina nástrojov dostupných agentovi mení počas streamovaného behu. Agentické aplikácie čoraz častejšie nepripájajú všetky integrácie vopred: nástroj môže pribudnúť podľa kontextu, oprávnenia používateľa alebo výsledku predchádzajúceho kroku. Explicitná udalosť je čistejší mechanizmus než neformálne vkladanie informácie o novom nástroji do textu konverzácie.

Pre používateľov Amazon Bedrock pribudla podpora ModelSettings.extra_headers. Aplikácia tak môže cez spoločné modelové nastavenia doplniť špecifické hlavičky požiadavky aj pri tomto poskytovateľovi. Vydanie súčasne opravuje kontrolu bedrock_max_concurrency: nulová hodnota už nemá viesť k deadlocku, ale má byť odmietnutá validáciou. Je to malá zmena s výrazným prevádzkovým významom, pretože chybné nastavenie limitu súbežnosti sa má prejaviť ako zrozumiteľná konfiguračná chyba, nie ako agent, ktorý bez vysvetlenia prestane pokračovať.

PydanticAI tiež obnovil stabilné aliasy brány pre gemini-3-pro-image a gemini-3.1-flash-image. Alias umožňuje aplikácii odkazovať na podporovaný názov modelu bez viazania každej časti kódu na podrobnosti konkrétnej integrácie. Keď sa takýto názov správa nestabilne alebo prestane smerovať na očakávaný model, problém sa môže prejaviť až pri produkčnom volaní. Oprava je preto relevantná najmä pre aplikácie, ktoré cez PydanticAI Gateway kombinujú viac poskytovateľov alebo multimodálne modely.

Bezpečnostne najdôležitejšia položka opravuje rozsah prihlasovacích údajov v GoogleCloudProvider a únik premennej prostredia spojenej s Application Default Credentials. Release notes neuvádzajú podrobný scenár zneužitia ani hodnotenie závažnosti, preto z krátkeho popisu nemožno vyvodiť, že prihlasovacie údaje unikli mimo procesu alebo k cudziemu používateľovi. Pre prevádzkovateľov Google Cloud je však rozumné vnímať aktualizáciu ako prioritnú: nesprávne zdieľanie autentifikačného stavu medzi komponentmi môže viesť k použitiu inej identity alebo k pretrvaniu dočasnej konfigurácie dlhšie, než aplikácia očakáva.

Viacero opráv sa týka streamovania a životného cyklu agenta. Framework po novom číta časovú značku created z ľubovoľného chunku streamovanej odpovede OpenAI, nielen z predpokladaného miesta. Pri ukončení asynchrónneho streamu ho má aktívne zatvoriť namiesto čakania na garbage collector. Takéto detaily sa pri krátkom lokálnom teste nemusia prejaviť, no v dlho bežiacej službe ovplyvňujú správnosť telemetrie, uvoľňovanie spojení a stabilitu pri veľkom počte súbežných relácií.

Opravené boli aj hooky udalostí schopností a uzlov pri použití agent.iter(). Integrácie, ktoré sledujú jednotlivé kroky iteratívneho behu, by tak mali dostávať rovnaké udalosti ako ostatné režimy vykonávania. Ďalšia zmena zachováva instrumentáciu hostiteľskej aplikácie pri použití Temporal LogfirePlugin a odstránená bola hranica cache TypeAdapter pre payloady Temporal. Framework zároveň zachováva podtriedy kontajnerov schopností pri bindovaní, čo je dôležité pre používateľov, ktorí základné typy rozšírili vlastným správaním.

Verzia 2.23.0 nie je veľkým prepracovaním API ani novým modelom. Jej význam je v súbore kontrolných mechanizmov a prevádzkových opráv, ktoré sa pri agentoch násobia: cena rastie počas slučiek, dynamické nástroje menia dostupné akcie, streamy držia zdroje a cloudová identita určuje dosah každej operácie. Pred aktualizáciou by tímy mali skontrolovať správanie vlastných limitov, callbackov, streamovacích klientov a integrácií Temporal či Google Cloud v testovacom prostredí. Zverejnené release notes neuvádzajú migračné upozornenie ani samostatné bezpečnostné advisory, preto by nebolo presné označovať vydanie za opravu potvrdenej zraniteľnosti; obsahuje však chybu autentifikačného rozsahu, ktorú by produkční používatelia nemali ignorovať.