Agent Skill Nedir? İşe Yarayan Yetenek Nasıl Yazılır?

Yapay zekâ ajanlarına yetenek yüklemek moda oldu ve ortalık yüzlerce "skill" ile doldu. Denediklerimin çoğu ya hiçbir şey değiştirmiyor ya da bağlamı şişirip işi kötüleştiriyor. Bu yazıda gerçekten fark yaratan yetenek kalıplarını, iyi bir skill'in nasıl yazıldığını ve kurmadan önce yapmanız gereken güvenlik kontrolünü anlatıyorum.

Agent skill nedir?

Agent skill, bir yapay zekâ ajanına belirli bir işi nasıl yapacağını öğreten talimat paketi. Modelin kendisini değiştirmiyor; ihtiyaç duyulduğunda devreye giren bir yönerge dosyası olarak çalışıyor.

Faydası şurada: model her seferinde tahmin etmek yerine yazılı bir yordamı takip ediyor. Bir işi ilk defa iyi yaptırdığınızda o yordamı skill hâline getiriyorsunuz ve sonraki her seferinde aynı kaliteyi alıyorsunuz.

Ajanı çok zeki ama işi yeni öğrenen bir stajyer gibi düşünün. Zekâsı yeterli; eksik olan, sizin nasıl çalıştığınızı bilmesi. Skill tam olarak bu boşluğu dolduruyor.

Bir skill'in anatomisi

İyi bir yetenek dört parçadan oluşuyor ve her parçanın ayrı bir işi var:

• Ad: ne yaptığını söyleyen, kısa. Ajan bunu listede görüyor.
• Tetikleyici açıklama: yeteneğin ne zaman devreye gireceğini anlatan bir iki cümle. Uygulamada en belirleyici parça bu.
• Yordam: işin adımları. Kural listesi biçiminde, gerekçe anlatısı olmadan.
• Referanslar: uzun tablolar, örnekler, şablonlar. Ana dosyaya gömülmez, ayrı tutulup gerektiğinde okunur.

İkinci maddeyi ayrıca vurgulayayım, çünkü çoğu işe yaramayan skill burada başarısız oluyor.

Tetikleyici açıklama nasıl yazılır?

Ajan, hangi yeteneği çağıracağına açıklamaya bakarak karar veriyor. Yordam ne kadar iyi olursa olsun, açıklama belirsizse yetenek hiç devreye girmiyor — ya da yanlış yerde giriyor.

İki örnek:

• Zayıf: "Yazma konusunda yardımcı olur."
• İyi: "Blog yazısı taslağı, başlık ve meta açıklama üretirken kullanılır. Var olan bir metni düzenlerken kullanılmaz."

İkincisi hem kapsamı hem de kapsam dışını söylüyor. Negatif sınır yazmak, yanlış tetiklenmeyi engelleyen en ucuz yöntem.

Kurmadan önce: güvenlik kontrolü

Bu kısım atlanıyor ve atlanmamalı. Bir skill, ajanınıza talimat veren metin demek. İnternetten indirdiğiniz bir metnin ajanınıza ne söyleyeceğini okumadan kabul ediyorsanız, ciddi bir açık bırakıyorsunuz.

Kurmadan önce en az şunları yapın:

• Prompt injection taraması. Skill'in içinde ajanı asıl görevinden saptıran, veri dışarı sızdırmaya yönlendiren ya da izin isteme adımlarını atlatan yönerge var mı?
• Ne talep ediyor? Dosya erişimi, ağ isteği, dış servis bağlantısı — hangisini neden istiyor?
• Alternatifine bakın. Aynı işi yapan daha basit ya da daha iyi bakılan bir skill var mı?
• Şüpheliyse karantinaya alın. Doğrudan ana ortamınıza değil, ayrı bir çalışma alanında deneyin.

Kısaca: skill'i bir kütüphane bağımlılığı gibi görün. Kod tabanınıza rastgele bir paket eklemiyorsanız, ajanınıza da rastgele talimat eklemeyin.

Gerçekten işe yarayan yetenek kalıpları

Yüzlercesi arasında kalıcı değer taşıyan birkaç kalıp var. Hepsinin ortak noktası, modelin doğal zayıflığını kapatmaları.

Netleştirici sorgulama

Ajanların en pahalı hatası, eksik anlaşılmış bir isteği hızlıca yapmak. Bu kalıp tam tersini yaptırıyor: iş başlamadan önce ajan size soru soruyor. Kim için, hangi kısıtla, başarı ölçütü ne?

Basit ama etkisi büyük. "Yeni bir iş fikri düşünüyorum, beni bunun üzerine sorgula" dediğinizde aldığınız sorular, çoğu zaman fikrin zayıf yerini siz farkına varmadan ortaya çıkarıyor.

Devir teslim belgesi

Bir ajandan diğerine ya da bir oturumdan sonrakine geçerken her şeyi baştan anlatmak zorunda kalıyorsunuz. Bu kalıp, çalışmayı yapılandırılmış bir belgeye döküyor: mevcut durum, alınan kararlar, sonraki adımlar, önerilen araçlar ve dikkat edilmesi gereken hassas bilgiler.

Uzun süren işlerde bunun değeri çok yüksek. Bir haftalık çalışmanın bağlamını iki paragrafta özetlemek yerine, gerçekten devredilebilir bir belge elde ediyorsunuz.

Öğretme kipi

Çoğu kişi ajana soru sorup tek paragraflık cevap alıyor ve orada bırakıyor. Bu kalıp etkileşimi derse çeviriyor: önce hedefi belirliyor (bunu neden öğreniyorsun?), sonra tek seferde tek konu anlatıyor, sonunda da neyin akılda kaldığını sınıyor.

Fark şurada: hedefe bağlanmayan bilgi unutuluyor. "Instagram'da nasıl büyürüm" sorusuna genel bir liste yerine, sizin amacınıza göre kurgulanmış bir ders almak bambaşka bir sonuç veriyor.

İyi bir skill nasıl yazılır?

En değerli skill, başka skill'leri iyi yazmanızı sağlayan kurallar bütünü. Kendi kullandığım ilkeler:

• Tek iş, tek skill. Bir yeteneğin kapsamı büyüdükçe ne zaman devreye gireceği belirsizleşiyor ve model onu yanlış yerde çağırıyor.
• Açıklamayı kısaltın. Bir skill'in tanımı her turda bağlamda taşınıyor. Gereksiz her kelimenin sürekli bir maliyeti var.
• Ayrıntıyı talep üzerine yükleyin. Uzun referansları ana dosyaya gömmek yerine ayrı dosyalara koyup yalnızca gerektiğinde okutun.
• Kural yazın, hikâye değil. "Şunu yapmalısın" listesi, paragraflarca gerekçeden daha iyi çalışıyor.
• Direktif olun. Modeller olasılıksaldır; bazen doğru yeteneği kendiliğinden çağırmaz. Kritik işlerde hangi skill'i kullanacağını açıkça söyleyin.

Son madde sık yanlış anlaşılıyor. Ajan çoğu zaman doğru yeteneği kendi buluyor, ama "çoğu zaman" üretim işi için yeterli bir garanti değil.

Skill'i nasıl test edersiniz?

Yazdığınız yeteneği kurup "çalışıyor galiba" demek yeterli değil. Üç testi geçmesi gerekiyor:

1. Tetikleme testi. Yeteneği adıyla çağırmadan, sadece işi tarif ederek isteyin. Devreye giriyor mu? Girmiyorsa açıklama zayıf.
2. Yanlış tetikleme testi. Yeteneğin kapsamı dışında ama benzer görünen bir iş isteyin. Devreye girmemeli. Giriyorsa kapsam çok geniş.
3. Tekrar testi. Aynı isteği üç kez, ayrı oturumlarda çalıştırın. Üç sonuç birbirine yakın mı? Değilse yordam yeterince belirleyici değil.

Üçüncü test en çok bilgi vereni. Bir yeteneğin varlık sebebi zaten tekrarlanabilirlik; üç farklı sonuç veriyorsa o yetenek işini yapmıyor demektir.

Test sırasında modelin ne yaptığını değil, neyi neden yaptığını izleyin. Doğru sonuca yanlış yoldan varan bir yetenek, girdi biraz değiştiğinde kırılıyor.

Skill şişmesi: asıl tehlike

Zamanla onlarca yetenek biriktiriyorsunuz ve bir noktadan sonra sistem yavaşlıyor, ajan yanlış yeteneği çağırmaya başlıyor. Buna skill şişmesi diyorum.

İki kuralla önlüyorum:

1. Yeni bir skill yazmadan önce sorun: var olanı genişletmek mi daha doğru, yenisini yazmak mı? Neredeyse her zaman cevap "genişlet" oluyor.
2. Düzenli budayın. Üç aydır bir kez bile devreye girmemiş yeteneği silin. Silmek geri alınabilir, kirlilik geri alınamaz.

Skill mi, kural dosyası mı, düz prompt mu?

Üçü karıştırılıyor ve yanlış olanı seçmek zaman kaybettiriyor. Ayrımım şöyle:

• Düz prompt — iş bir kere yapılacaksa. Yordamı yazmak, işi yapmaktan uzun sürüyorsa orada durun.
• Kural dosyası (projenin kökünde duran, her oturumda geçerli olan yönergeler) — kısıt her zaman geçerliyse. Kod stiliniz, dilinize dair tercihler, dokunulmaması gereken dizinler. Bunlar tetiklenmez, sürekli açıktır.
• Skill — iş tekrar ediyorsa ama her zaman geçerli değilse. Yalnızca o iş geldiğinde devreye girmesi gereken yordamlar.

En sık görülen hata, sürekli geçerli olması gereken bir kuralı skill hâline getirmek. O kural tetiklenmediği sürece yok sayılıyor ve neden uygulanmadığını anlamıyorsunuz.

Tersi de olur: her oturumda taşınması gereken uzun bir yordam kural dosyasına konur ve hiç kullanılmadığı turlarda bile bağlamı işgal eder.

Ajanı sürekli çalışır tutmak

Ajanın en güçlü özellikleri, siz başında değilken de çalışabilmesinden geliyor: gelen bir mesaja yanıt vermek, zamanlanmış bir işi yürütmek, uzun bir görevi arka planda tamamlamak.

Dizüstü bilgisayarınızı kapattığınızda bunların hepsi duruyor. Bu yüzden gerçekten sürekli çalışan bir kurulum istiyorsanız ajanı kendi makineniz yerine sürekli açık bir sunucuda çalıştırmanız gerekiyor. Küçük bir sanal sunucu bu iş için fazlasıyla yeterli.

Bir uyarı: sürekli çalışan bir ajana API anahtarı ve servis erişimi veriyorsunuz. Harcama limiti tanımlayın, erişimleri dar tutun ve ne yaptığını görebileceğiniz bir kayıt tutun.

Sık sorulan sorular

Skill ile prompt arasındaki fark ne?

Prompt tek seferlik bir istektir; skill, tekrar eden bir işin yazılı yordamıdır. Aynı prompt'u üçüncü kez yazıyorsanız, orası skill'e dönüştürülecek yerdir.

Kaç tane skill kurmalıyım?

Sayı hedef değil. Benim düzenimde gerçekten iş gören bir avuç yetenek var, gerisi zamanla budandı. Az sayıda ve iyi tanımlanmış yetenek, çok sayıda ve bulanık olandan her zaman daha iyi çalışıyor.

Skill'i kendim mi yazmalıyım, hazır mı kurmalıyım?

Hazır olanlarla başlayıp kendi işinize göre değiştirin. Ama içeriğini okumadan hiçbirini kurmayın — bu, hem güvenlik hem de kalite meselesi.

Skill yazmak için kod bilmek gerekir mi?

Genellikle hayır. Çoğu yetenek düz metin talimattan ibaret. Kod bilmek, yeteneğin çalıştırdığı adımları doğrulayabilmenizi sağlıyor; bu bir avantaj ama önkoşul değil.

Özetle

Skill kurmak bir koleksiyon işi değil. Değer, sayıda değil; tekrar eden işlerinizi yazılı yordama çevirmekte, kurduğunuz her yeteneği okumuş olmakta ve işini görmeyeni silmekte. Az sayıda iyi yazılmış yetenek, ajanınızı gerçekten farklı bir seviyeye taşıyor.