💡 3 Maddede Bu Yazının Özeti
Pydantic AI’nin v2.45.0 sürümü, 18 Eylül 2026’da GitHub’da yayımlandı. Bu küçük görünen sürümün odağında üç pratik konu var: TypeSafe’in Jev modeli için yeni bir model sınıfı, Amazon Bedrock’ta desteklenen profillerde xhigh akıl yürütme çabasının iletilmesi ve uzun yaşayan ajan koşularında…
Pydantic AI’nin v2.45.0 sürümü, 18 Eylül 2026’da GitHub’da yayımlandı. Bu küçük görünen sürümün odağında üç pratik konu var: TypeSafe’in Jev modeli için yeni bir model sınıfı, Amazon Bedrock’ta desteklenen profillerde xhigh akıl yürütme çabasının iletilmesi ve uzun yaşayan ajan koşularında araç/MCP oturumu yönetiminin düzeltilmesi. Değişiklikler yeni bir model denemek isteyen ekipleri olduğu kadar, araç çağıran ve kalıcı (durable) iş akışı çalıştıran Python geliştiricilerini de ilgilendiriyor. Resmî sürüm notları bunları v2.44.0 ile v2.45.0 arasındaki değişiklikler olarak listeliyor.
Sürümde ne değişti?
İlk yenilik, TypeSafe’in Jev modeli için TypeSafeModel eklenmesi. Pydantic AI, belgelerinde model sağlayıcılarını ve araç kullanan ajanları Python tipleri ile doğrulanabilir sonuçlar etrafında bir araya getiren bir çerçeve olarak tanımlıyor. Yeni sınıf, Jev kullanmak isteyen bir uygulamanın sağlayıcı entegrasyonunu kendi sarmalayıcısıyla başlatması yerine çerçevenin model katmanından kurmasına imkân verebilir. Bu, Jev’in kalitesi veya tüm kullanım senaryolarında uygunluğu hakkında bir değerlendirme değildir; sürüm notunun doğruladığı şey, bu sağlayıcı için yerel bir entegrasyonun eklendiğidir. Pydantic AI genel bakışı ve release kaydı başlangıç noktalarıdır.
İkinci değişiklik Bedrock kullanan ekipler için daha doğrudan. Sürüm, model profili bunu desteklediğinde xhigh effort değerinin Bedrock’a aktarılmasını düzeltiyor; ayrıca Bedrock Converse üzerinde üç ek GPT-5.6 model adını kabul ediyor. Bu, her Bedrock modeli veya her hesap için aynı davranışın garanti edildiği anlamına gelmez. Uygulama tarafında seçilen model profili, AWS hesabındaki erişim, bölge ve sağlayıcının kendi ücretlendirmesi ayrıca kontrol edilmelidir. Ancak önceden kaybolan bir yüksek-çaba ayarına güvenen ekip için sürüm yükseltmesi, niyet edilen istek parametresinin korunması açısından anlamlıdır. Değişikliğin kapsamı resmî notlarda açıkça belirtiliyor.
Kalıcı ajan koşularında asıl kullanıcı etkisi
v2.45.0’ın daha önemli bölümü, durable run kullanan uygulamalarda kaynak ömrünü ele alıyor. Release notlarına göre DynamicToolset artık her durable unit içinde yeniden çözülmek yerine bir durable run için bir kez çözülüyor. Aynı notlar, MCP sunucu oturumunun her birim için tekrar açılmayıp koşu başına tutulduğunu ve MCPSamplingModel araç geçmişinin korunduğunu söylüyor. Bu üçü birlikte, çok adımlı bir işte araç listesinin ya da MCP bağlantısının gereksiz yere yeniden kurulmasını azaltmayı ve konuşma/araç bağlamının daha tutarlı kalmasını hedefliyor. Sürüm notları bunları hata düzeltmesi olarak sınıflandırıyor.
Somut bir örnek: Bir destek ajanı, önce müşteri kaydını salt-okunur araçla buluyor, sonra sipariş bilgisini başka bir MCP aracından alıyor ve son olarak insan onayına sunulacak taslağı hazırlıyor olabilir. İş akışı duraklayıp devam ediyorsa aynı MCP sunucusuna her alt adımda yeni oturum açmak hem gecikme hem de durum tutarsızlığı riski yaratabilir. v2.45.0, koşu kapsamındaki oturumu tutarak bu yaşam döngüsünü sadeleştiriyor. Yine de uygulamanın kendi araçlarının yan etkisizliği, zaman aşımı, tekrar deneme ve onay sınırları çerçevenin bu değişikliğinden bağımsız tasarlanmalıdır; sürüm notu iş mantığınızın güvenliğini garanti etmez.
Kimler yükseltmeyi önceliklendirmeli?
Bedrock üzerinden desteklenen bir profil ile xhigh effort gönderenler, durable run içinde DynamicToolset kullananlar veya MCP sampling araç geçmişine dayananlar için yükseltme önceliği yüksektir. FastMCP 4 yüklü bir ortamda pydantic_ai.mcp kullanılıyorsa ayrıca dikkat çekici bir uyumluluk düzeltmesi var: sürüm, FastMCP 4’ün sağlamadığı eski httpx içe aktarımını kaldırıyor. Her ajan koşusunun kullanım bilgisinin kendi span’ında raporlanması da gözlemlenebilirlik sistemlerinde hangi koşunun ne tükettiğini ayırmayı kolaylaştırabilir. Bu maddelerin tamamı v2.45.0 değişiklik listesinde yer alır.
Buna karşılık yalnız basit, tek atımlık bir model çağrısı yapan ve MCP/durable run/Bedrock kullanmayan bir proje için yükseltmenin getirisi daha sınırlı olabilir. Böyle bir ekip yine de bağımlılık çözümünü, test paketini ve kullandığı sağlayıcı eklentisini incelemelidir. Sürüm notları performans yüzdesi, evrensel gecikme kazanımı veya tüm geriye dönük uyumluluk için bir garanti yayınlamıyor. Bu nedenle önce kilitli bağımlılık dosyasında deneme, ardından temsilî araç çağrıları ve hata senaryolarıyla test, üretime doğrudan geçmekten daha ölçülü bir geçiş yoludur.
Kurulum, lisans ve maliyet
Projenin v2.45.0 etiketindeki paket yapılandırması MIT lisansını ve Python >=3.10 gereksinimini bildiriyor. Aynı yapılandırma, kök paketin OpenAI, Anthropic, Google, CLI, MCP, değerlendirme, web ve Logfire bileşenlerini içeren pydantic-ai-slim bağımlılığına dayandığını; Bedrock, Cohere, Mistral, Groq, OpenRouter, Hugging Face ve TypeSafe gibi seçeneklerin eklenti olarak sunulduğunu gösteriyor. Bu yüzden “MIT” ifadesi Pydantic AI kodu için geçerlidir; çağrılan modelin, bulut sağlayıcısının, MCP sunucusunun veya veri kaynağının lisans ve fiyat koşullarını ortadan kaldırmaz. Ayrıntılar için sabit sürümdeki pyproject.toml ve MIT lisans metni incelenmelidir.
Çerçevenin kendisi için ayrı bir lisans ücreti yoktur; gerçek maliyet seçilen modele, istek ve çıktı hacmine, araçların yaptığı API çağrılarına, barındırmaya ve gözlemlenebilirlik hizmetlerine bağlıdır. Özellikle Bedrock’taki effort ayarı daha uzun veya daha maliyetli model işlemleriyle ilişkilendirilebileceğinden, yükseltmeden önce bir bütçe sınırı koymak ve temsilî görevlerde sağlayıcının faturalama ölçümünü izlemek mantıklıdır. Resmî proje yapılandırması eklentilerin varlığını doğrular, fakat üçüncü taraf hizmetler için tek bir fiyat veya veri saklama politikası vaat etmez.
Gizlilik ve güvenlik için kontrol listesi
Durable run ve koşu başına MCP oturumu, teknik olarak daha kalıcı bir durum yaşam döngüsü demektir. Bu nedenle uygulama sahibi hangi aracın hangi kimlik bilgisine eriştiğini, oturumun ne zaman kapandığını, araç geçmişinin nerede günlüğe alındığını ve kişisel verinin hangi sağlayıcıya gittiğini kendi mimarisinde belirlemelidir. v2.45.0’ın araç geçmişini koruma düzeltmesi, geçmişin otomatik olarak güvenli veya silinmiş olduğu anlamına gelmez. Pydantic AI’nin resmî belgeleri çerçevenin yeteneklerini açıklar; veri işleme, saklama süresi ve erişim denetimleri için kullanılan model/araç sağlayıcısının sözleşmesi ile kurumun kendi politikası esas alınmalıdır.
Pratikte araçlara en az yetki vermek, yazma işlemlerini ayrı bir onaya bağlamak, MCP sunucusunu güvenilir uçlarla sınırlamak, gizli anahtarları araç çıktılarından ayırmak ve dayanıklı iş akışları için iptal/temizleme yolunu test etmek gerekir. Ayrıca bağımlılık yükseltmesinden sonra kilit dosyasındaki değişiklikleri gözden geçirmek önemlidir. v2.45.0 yapılandırmasında bazı geçişli bağımlılıklar için güvenlik gerekçeli alt sürüm sınırları bulunduğu görülür; bu, bir bakım sinyalidir ama uygulamanın tüm bağımlılık zincirinin denetlendiği veya güvenlik açığı bulunmadığı iddiası değildir. Yapılandırma dosyası bu sınırların varlığını doğrudan gösterir.
Sınırlar ve güvenli yükseltme kararı
Bu sürümün resmi kaydı bir sürüm notudur; bağımsız bir benchmark, güvenlik denetimi ya da uygulama performans ölçümü değildir. TypeSafeModel için üretim olgunluğu, Bedrock’a erişim, uzun çalışan MCP bağlantılarının ağ arızalarındaki davranışı ve maliyet etkisi, her ekipte kendi yüküyle doğrulanmalıdır. Ayrıca durable run’da oturumun daha uzun tutulması, yararlı bir tutarlılık sağlarken bozuk bir bağlantı veya yanlış yetkilendirme gibi sorunların yaşam döngüsü yönetimini daha görünür hâle getirebilir.
Özetle, Pydantic AI v2.45.0; yeni bir TypeSafe/Jev yolu, Bedrock’taki önemli bir parametre iletimi ve uzun ömürlü araç/MCP koşularında daha doğru kaynak yönetimi sunuyor. Önce test ortamında sürümü sabitleyin, kullandığınız provider extras’ını çözdürün, temsilî bir durable run ve hata/iptal senaryosunu deneyin; ardından maliyet, günlükleme ve yetki kontrolleri kabul edilebilir durumdaysa üretime alın. Değişikliklerin tam listesi ve karşılaştırma bağlantısı için resmî v2.45.0 sürüm notuna dönün.