Agent SDK: İş Akışlarınıza Özel Kod Tabanlı Ajanlar Geliştirin

Yazılım ekipleri, geliştirme yaşam döngüsü boyunca tekrarlayan işleri yönetmek için kod olarak tanımlanmış ajanlar (agents) kullanıyor. Bir pull request (PR) incelemesinden uyumluluk süreçlerini yürütmeye veya olay incelemesine kadar pek çok alanda çalışan bu ajanlar, en yüksek verimi ekibin kendi çalışma biçimine uyarlandığında sağlıyor. Cursor, kendi yönetilen ajanları olan Bugbot, Security Reviewer ve Rollouts'u geliştirmek için kullandığı Agent SDK çatısını kullanıma sundu. Bu SDK ile ajanları tıpkı standart bir yazılım projesi gibi kodla tanımlayabilir, şablonlardan başlayabilir ve hazır olduğunda agent-sdk deploy komutuyla tek seferde Cursor altyapısına dağıtabilirsiniz.

Kendi İş Akışınıza Göre İnşa Edin#

Agent SDK, ekibinizin mevcut çalışma şekline uyum sağlayan, inceleyip değiştirebileceğiniz politikalara bağlı kalan ajanlar oluşturmanıza olanak tanır. Örneğin kod inceleme süreçlerinde her ekibin standartları farklıdır. GitHub, GitLab veya Bitbucket üzerindeki PR olaylarına yanıt veren bir ajan tasarlayarak değişikliğin riskini değerlendirebilir, doğru ekibe yönlendirebilir ve politikalara uyan değişiklikleri otomatik onaylayabilirsiniz.

• Kurumsal Hafıza Denetimi: Cursor içindeki bir ekip, geçmişte alınan derslerin yer aldığı büyüyen bir bilgi tabanına sahipti. Agent SDK ile yaklaşık bir günde kb-reviewer adlı ajanı geliştirdiler. Bu ajan her PR'da çalışarak geçmiş kararlarla çelişen değişiklikleri işaretliyor, ilgili nota atıfta bulunuyor ve mühendisleri tutarsızlıkları gidermeye teşvik ediyor.
• Çoklu Ajan ve Paralel Çalışma: Karmaşık işlerde ajanlar, görevi kendi araçlarına ve oturumlarına sahip başka bir uzman ajana devredebilir veya işi paralel çalışan alt ajanlar (subagents) arasında bölebilir.
• Değerlendirme (Evals) ve Olay Tekrarı: Kutudan çıktığı haliyle sunulan değerlendirme (evals) ve olay tekrarı (event replay) desteği, kritik iş akışlarının beklendiği gibi çalışmasını güvence altına alarak hızlı iterasyon yapılmasını sağlar. Nitekim PGA Tour baş mühendisi Michael Gyarmathy, yazılım fabrikalarının her bileşenini Cursor altyapısında inşa ettiklerini ve yerleşik evals desteği sayesinde yeni fikirleri güvenle optimize ettiklerini belirtiyor.

Her Şeyi Kod Olarak Tanımlayın#

Bir Agent SDK ajanı, küçük bir yazılım projesi gibi organize edilir. Ajanı yönlendiren talimatlar; araçların kodları, dış servis bağlantıları ve test için kullanılan değerlendirmelerle yan yana durur:

• Dosya Yapısı: Her dosya ajanın bildiği veya yapabildiği bir şeyi temsil eder.
• Markdown ve TypeScript Uyumu: İstemler (prompts) Markdown formatında yazılırken, araçlar (tools) TypeScript fonksiyonları olarak tanımlanır.
• Mühendislik Pratiği Çıkarımı: Her şeyin kod olması, ajan davranışlarındaki değişikliklerin diğer yazılımlarınızla aynı sürüm kontrolü (version control) ve kod inceleme süreçlerinden geçmesini sağlar. Bu yaklaşım, yapay zeka geliştirme süreçlerini standart yazılım mühendisliği disipliniyle birleştirir.

Ajanları İhtiyaç Duyduğunuz Her Yere Dağıtın#

Ajanınızı kullanıma almaya hazır olduğunuzda, proje dizininden agent-sdk deploy komutunu çalıştırarak doğrudan Cursor altyapısına dağıtabilirsiniz. Bu pratik yaklaşım, altyapı yönetimi yükünü ortadan kaldırarak geliştiricilerin doğrudan iş mantığına ve ajan yeteneklerine odaklanmasını sağlar.