Pydantic AI 2.0, ajanlar için temel yapı taşı olarak capabilities kavramına geçiyor

Capabilities temel yapı taşı haline geliyor

dev.to'da yayımlanan yoğunlaştırılmış bir eğitim, Pydantic AI 2.0 ile ajan geliştirmeyi ele alıyor ve öne çıkan değişiklik mimari yönde. Gönderiye göre sürüm 2, framework'ü capabilities etrafında tamamen yeniden yapılandırmış ve onları ajanların inşa edildiği temel birime dönüştürmüş. Her ajanı prompt'lar, araçlar ve ayarlardan oluşan geçici bir paket olarak yapılandırmak yerine, geliştiriciler artık olduğu gibi kullanılabilecek, birleştirilebilecek veya sıfırdan yazılabilecek capability birimleriyle çalışıyor.

Capabilities'in her proje için yeniden inşa edilmesi değil, yeniden kullanılması hedefleniyor. Eğitim mevcut capabilities'lerin nasıl kullanılacağını, kendinizinkileri nasıl yazacağınızı gösteriyor ve yazarın Pydantic tarafından sürdürülen resmî bir hazır capabilities seti olarak tanımladığı Pydantic AI harness'ten alınan iki örneği ele alıyor. Videonun yanında, izleyicilerin kodu takip edebilmesi için bir Google Colab defteri de sunuluyor.

Ajan araç takımının geri kalanı

Capabilities, bir ajanın diğer bileşenlerinin yerini almıyor ve eğitim onları da kapsıyor. Gönderiye göre müfredat şunları içeriyor:

• Instructions (talimatlar), dinamik talimatlar dahil
• Tools (araçlar), bir modelin çalışma sırasında çağırabileceği fonksiyonlar
• Dependencies (bağımlılıklar)
• Structured output (yapılandırılmış çıktı)
• MCP desteği, yani Model Context Protocol
• Logfire ile observability (gözlemlenebilirlik)

Yazara göre sonunda izleyiciler bu parçaların üzerine kendi ajanlarını kurabilmeli.

Güvenlik notu en çok dikkati hak ediyor

Gönderinin en geniş uygulama alanına sahip kısmı, sırlar hakkında kısa bir uyarı. Yazar, bir system prompt'a veya bir ajanın talimatlarına yerleştirilen her şeyin, modeli destekleyen inference sağlayıcısına iletildiği uyarısında bulunuyor — ve ajan Logfire gibi bir gözlemlenebilirlik aracına bağlıysa, tam bağlamı o üçüncü taraf hizmete de gönderiliyor. API anahtarları ve diğer hassas değerler bu nedenle prompt'larda yer almamalı.

Önerilen çözüm ihtiyatlı değil, yapısal. Bir sırrı bir prompt'a gömme dürtüsü hissettiğinizde, bu dürtüyü mantığın aslında bir tool fonksiyonuna ait olduğunun bir işareti olarak değerlendirin. Araçlar kendi sunucunuzda çalıştığı için sırları doğrudan ortam değişkenlerinden yükleyebilirler. Gönderinin altını çizdiği tek kural, aracın bu değerleri asla modele geri vermemesi gerektiğidir.

Neden önemli

Bir framework'ün temel primitivesi, herkesin onunla nasıl geliştirdiğini şekillendirir. Capabilities'i Pydantic AI 2.0'ın merkezine yerleştirmek, ajan geliştirmeyi her proje için ajan başına yapılandırma tekrarlamak yerine, birlikte yazılabilirlik yönüne itiyor — davranışı, ister kurum içinde yazılmış ister resmî harness'ten alınmış yeniden kullanılabilir birimlerden oluşturmak. Geliştiriciler için bu, daha az boilerplate ve fikirden çalışan ajana giden daha kısa bir yol anlamına gelebilir; harness de bir nevi ajan parçalarının standart kütüphanesi gibi işlev görür.

Güvenlik rehberliği ikinci çıkarım ve tartışmalı biçimde bu framework'ün ötesine en çok taşınan nokta. Gözlemlenebilirlik araçları ajan stack'inin varsayılan bir parçası haline geldikçe, bir ajanın tam bağlamını alan dış hizmetlerin sayısı artıyor. Prompt hijyeni — sırları modelin görebildiği her şeyin dışında tutmak — artık hoş bir ek değil, ajanları güvenli biçimde sunmanın temel bir gereksinimi haline geliyor.