💡 3 Maddede Bu Yazının Özeti
Anthropic, Python SDK’sının 1.8.0 sürümünü 22 Eylül 2026’da yayımladı. Sürüm; Claude Opus 5.5 için tür desteği, satır içi araç tanımları ve beta durumundaki MCP araç listesi sabitleme özelliğini aynı pakette bir araya getiriyor. Ayrıca açık bırakılan akışların Python 3.13 kapanışında…
Anthropic, Python SDK’sının 1.8.0 sürümünü 22 Eylül 2026’da yayımladı. Sürüm; Claude Opus 5.5 için tür desteği, satır içi araç tanımları ve beta durumundaki MCP araç listesi sabitleme özelliğini aynı pakette bir araya getiriyor. Ayrıca açık bırakılan akışların Python 3.13 kapanışında yol açabildiği çökme ile araç çalıştırıcısındaki iki davranış düzeltiliyor.
Bu sürüm, son kullanıcıya dönük büyük bir arayüz değişikliğinden çok ajan ve araç entegrasyonu geliştiren ekipleri ilgilendiriyor. Özellikle aynı konuşmanın sonraki adımlarında hangi MCP araçlarının modele sunulduğunu daha öngörülebilir tutma hedefi dikkat çekiyor. Ancak özelliklerin bir bölümü beta API altında: üretim ortamında kullanılmadan önce izinler, hata yolları ve geri dönüş planı ayrıca sınanmalı.
Python SDK 1.8.0 ile gelen başlıca değişiklikler
Resmî 1.8.0 sürüm notu, yenilikleri üç başlıkta özetliyor: claude-opus-5-5 desteği, satır içi araç tanımları ve beta MCP araç listesi sabitleme. Aynı notlarda dört hata düzeltmesi de yer alıyor:
- Managed Agents olaylarında değerlendirilen izin değerleri için ortak bir enum kullanılması,
- Açık bırakılmış bir akış nedeniyle Python 3.13 kapanışında oluşabilen çökmenin önlenmesi,
add_tools()ile eklenen araçların hemen etkili olması,- Araç çalıştırıcısının sıkıştırma isteğine yalnızca yanıtta anlam taşıyan parametreleri eklememesi.
Geçişi “yalnızca paket yükseltme” olarak ele almamak gerekiyor. Araç şemaları, beta içerik blokları ve konuşma geçmişinin yeniden gönderilme biçimi; ajanın gördüğü bağlamı ve hangi aracı seçebileceğini etkileyebilir.
MCP araç listesi sabitleme ne anlama geliyor?
MCP sunucuları, kullanıma açtıkları araçları ad, açıklama ve giriş şemasıyla listeler. 1.8.0’daki yeni beta tiplerinde mcp_tool_listing adlı bir içerik bloğu bulunuyor. Özelliği ekleyen resmî değişiklik kaydı, önceki yanıttaki bu bloğun asistan mesajıyla birlikte değiştirilmeden sonraki isteğe gönderilebileceğini belirtiyor.
Böyle yapıldığında eşleşen MCP araç takımı için sunucuya araçları yeniden sormak yerine taşınan liste kullanılabiliyor. SDK’daki tools alanının açıklaması da liste mevcutsa örnekleme öncesinde MCP sunucusunun tekrar sorgulanmadığını ve tam olarak verilen girdilerin kullanıldığını söylüyor. Bu davranış, uzun bir ajan oturumunda araç kümesinin adımlar arasında beklenmedik biçimde değişmesini azaltmaya yardımcı olabilir.
“Sabitleme” sözcüğü güvenlik garantisi olarak anlaşılmamalı. Uygulama araç listesinin hangi yanıttan alındığını, konuşma geçmişinin değiştirilmediğini ve sunucu tarafındaki yetkilerin geçerli olduğunu denetlemeli. Eski bir araç şemasını taşımak, sunucudaki güncel davranışla uyuşmazlık oluşturabilir. Liste sürümü veya zaman damgası kaydetmek, şema uyuşmazlığında kontrollü biçimde yeniden keşif yapmak ve hassas araçları varsayılan olarak kapalı tutmak daha güvenli bir yaklaşım olur.
Satır içi araç tanımları ve araç takımları
Aynı değişiklik, beta tiplerine MCP araç tanımı ile tarayıcı ve bilgisayar araç takımı yapılandırmaları ekliyor. MCP aracı; araç adı, isteğe bağlı açıklama ve giriş şemasını taşıyor. Araç takımı düzeyindeki default_config tüm araçlar için varsayılan davranışı, configs ise araç adına göre istisnaları belirleyebiliyor. enabled ve defer_loading alanlarıyla hangi araçların modele sunulacağı ve yüklemenin ertelenip ertelenmeyeceği ifade ediliyor.
Bu yapı, çok sayıda aracı tek tek yönetmek yerine bir araç ailesi için ortak politika tanımlamayı kolaylaştırabilir. Yine de daha az yapılandırma satırı, daha az test gereksinimi demek değil. Dosya yükleme, JavaScript çalıştırma, sayfada tıklama veya ağ yanıtlarını okuma gibi etkisi yüksek araçlar açıkça sınırlandırılmalı; aracın görünür olması ile kullanıcının o eyleme izin vermesi birbirinden ayrılmalı.
Claude Opus 5.5 adı da Managed Agents model türlerine eklenmiş durumda. Buradaki kanıt, SDK’nın ilgili model tanımlayıcısını kabul ettiğini gösteriyor; tek başına her hesap, bölge veya API yüzeyinde erişim garantisi vermiyor. Uygulamalar kullanılabilirliği kendi Anthropic hesabında doğrulamalı ve model bulunamadığında kontrollü bir alternatif seçmeli.
Araç çalıştırıcı düzeltmeleri neden önemli?
add_tools() için bildirilen düzeltme, çalışma zamanında araç ekleyen ajanları doğrudan etkiliyor. Resmî düzeltme kaydına göre eklenen araçlar artık hemen etkili oluyor. Böylece uygulamanın bir aracı eklediğini düşündüğü hâlde sonraki model adımının eski araç kümesiyle sürmesi riski azalıyor.
Diğer düzeltme, araç çalıştırıcısının sıkıştırma isteğinde yalnızca yanıta ait parametreleri dışarıda bırakıyor. İlgili değişiklik kaydı, bu alanların sıkıştırma çağrısına taşınmamasını hedefliyor. Bağlam sıkıştırma kullanan uzun oturumlarda istek gövdesinin API beklentisiyle uyumlu kalması açısından bu ayrım önemli.
Python 3.13 akış kapanışı düzeltmesi
1.8.0, bir akış açık bırakıldığında Python 3.13 yorumlayıcısının kapanışında görülebilen çökme için de düzeltme içeriyor. Resmî commit, akışın sonlandırma yolunu ele alıyor. Bu, akışları bilinçli kapatma gereğini ortadan kaldırmıyor; bağlam yöneticisi kullanmak ve hata durumlarında kaynağı kapatmak hâlâ doğru uygulama.
Yükseltme testine en az üç senaryo eklenebilir: normal tamamlanan akış, istisnayla yarıda kesilen akış ve süreç kapanırken açık kalan akış. Testler Python 3.13’ün yanında desteklenen en eski Python sürümünde de çalıştırılmalı. Böylece düzeltmenin bir sürümde yarar sağlarken başka bir çalışma ortamında gerileme oluşturmadığı görülebilir.
Erişilebilir ajan deneyimi açısından etkisi
Sürüm notlarında doğrudan bir erişilebilirlik özelliği duyurulmuyor. Bununla birlikte araç listesinin tutarlı kalması ve yeni eklenen araçların öngörülen anda devreye girmesi, ekran okuyucu veya yalnızca klavye kullanan kişilere sunulan ajan akışlarının daha kararlı tasarlanmasına katkı sağlayabilir. Buradaki katkı dolaylıdır; SDK yükseltmesi tek başına erişilebilirlik sağlamaz.
Örneğin bir ajan kullanıcı adına web formu dolduruyorsa araç açıklamaları eylemin hedefini ve sonucunu açıkça söylemeli. Görsel konuma dayalı “şuraya tıkla” ifadeleri yerine erişilebilir ad, rol ve durum bilgileri kullanılmalı. Kritik işlemden önce onay istenmeli; hata mesajı yalnızca renk veya geçici bildirimle verilmemeli; yapılan işlem metin olarak tekrar sunulmalı. Araç listesi sabit olsa bile bu kullanıcı deneyimi kuralları ayrıca uygulanmalıdır.
MCP araç şemalarında alan adlarının anlaşılır olması da önem taşır. Belirsiz parametreler, modelin yanlış seçim yapmasının yanında kullanıcıya sunulan onay ekranını da anlamsızlaştırabilir. Onay metni; hangi aracın, hangi veriyi, hangi hedefte, ne amaçla kullanacağını açıklamalıdır. İptal seçeneği klavyeyle erişilebilir olmalı ve odak beklenmedik biçimde başka bir yere taşınmamalıdır.
Yükseltme için kısa kontrol listesi
- Bağımlılığı önce ayrı bir dalda 1.8.0’a sabitleyin ve kilit dosyasını gözden geçirin.
- Beta MCP araç listesi kullanıyorsanız ilk yanıttaki liste bloğunun sonraki isteğe değiştirilmeden taşındığını test edin.
- Sunucudaki araç listesi değiştiğinde eski sabit listenin nasıl yenileneceğini tanımlayın.
add_tools()sonrasında eklenen aracın bir sonraki model adımında gerçekten göründüğünü doğrulayın.- Normal, yarıda kesilen ve açık kalan akışları Python 3.13 üzerinde çalıştırın.
- Yetkili araçlarda kullanıcı onayı, kayıt tutma, zaman aşımı ve geri alma yollarını sınayın.
- Ekran okuyucu ve yalnızca klavye ile araç seçimi, onay, hata ve tamamlanma mesajlarını uçtan uca deneyin.
Özetle Anthropic Python SDK 1.8.0, ajanların araç kümesini daha belirgin yönetmeye ve bazı çalışma zamanı sürprizlerini azaltmaya odaklanan bir sürüm. En güçlü yenilik MCP araç listesini konuşma adımları arasında taşıyabilme; en pratik düzeltmeler ise araçların hemen etkinleşmesi ve Python 3.13 akış kapanışıyla ilgili. Beta özellikleri aşamalı açmak, ölçümlemek ve kolayca geri alınabilir tutmak en güvenli geçiş yolu.
