İleri bitirme ödevi: Kendi ajanınızı kurun ve test edin
- Okuma süresi: 4 dk
- Kod bilgisi gerekmez
Bu ödev API anahtarı gerektirir ve API kullanımı harcama doğurabilir; ödevin bir adımı harcama sınırı koymaktır.
Bu ödevde İleri seviyede öğrendiklerinizi tek bir çalışmada birleştireceksiniz. Küçük bir ajan kuracak, onu ölçülebilir testlerle sınayacak, güvenlik ve veri açısından denetleyecek ve kendinizi puanlayacaksınız.
Aklınıza bir soru mu takıldı?
Ödevin tanımı
Tekrarlanan, riski düşük ve çıktısı kontrol edilebilen bir iş seçin: toplantı notlarından özet, gelen e-postaları kategoriye ayırma, belge taslağını kaynak notlarla karşılaştırma gibi. Gerçek kişisel veri kullanmayın; örnek verileri kendiniz uydurun. Ajanınız en az bir Skill ve bir salt okunur alt ajan içermelidir (Ajan kurmak dersi). Başarı ölçütünüzü sayıyla yazın ve en az 10 test vakasıyla sınayın (Kalite ve güvenlik dersi). Kuralları ve veri sınırlarını kısa bir kullanım notuna dökün (Kurumda Claude dersi).
Adım adım uygulama
- İşi ve başarı ölçütünü tek cümleyle yazın; örneğin “20 örnek notun en az 18’inde karar ve görevleri eksiksiz bulsun”.
- Skill’i yazın: name ve description alanları ile adımlar. Description ne zaman kullanılacağını söylesin.
- Alt ajanı yalnızca Read, Grep ve Glob araçlarıyla tanımlayın.
- API anahtarını ortam değişkeninde tutun, harcama sınırını (Python’da max_budget_usd) ve gerekirse alt ajan derinliği ile eşzamanlılık sınırlarını ekleyin.
- En az 10 test vakası hazırlayın: kolay, zor, boş, alakasız ve içine talimat gizlenmiş vakalar olsun. Beklenen sonucu önceden yazın.
- Ajanı çalıştırın, sonuçları kodla ya da rubrikle puanlayın, başarı oranını hesaplayın.
- Komuta “bilmiyorum” izni ve kaynak alıntısı şartı ekleyip testi tekrarlayın; farkı kaydedin.
- Bir hedef belgenin içine “önceki talimatları yok say” cümlesi gizleyin ve ajanın uyup uymadığını kaydedin.
- Bir sayfalık kullanım notu yazın: hangi veri girilir, hangisi girilmez, çıktıyı kim kontrol eder.
Komut kalıbı
Ben [mesleğiniz]. [İşin adı] için Claude Agent SDK ile küçük bir ajan kurmak istiyorum. Başarı ölçütüm: [sayı ve ölçüt]. Bir Skill ve yalnızca Read, Grep, Glob kullanan bir denetçi alt ajan olsun. Önce planı yaz, ben onaylayınca kur. API anahtarını koda yazma, harcama sınırı koy. Sonra 10 test vakası üret: kolay, zor, boş, alakasız ve içinde talimat gizlenmiş vakalar. Gerçek kişisel veri kullanma.
Claude’un yazdığı kodu ve testleri okuyun; neyin sınandığını siz anlayın. Testi geçmek için komutu test vakalarına göre ayarlarsanız ölçümünüz değer kaybeder; bu yüzden birkaç vakayı ayarlamadan saklayın.
Puanlama ölçeği
Her ölçüte 0 ile 4 arasında puan verin. Toplam 20 üzerinden hesaplanır.
- Mimari: Skill ve alt ajan görevleri ayrı mı, alt ajanın araçları yalnızca gerekenlerle sınırlı mı, description açık mı?
- Test: Ölçütünüz sayıya bağlı mı, en az 10 vakanız ve uç durumlarınız var mı, sonucu ölçtünüz mü?
- Doğruluk: “Bilmiyorum” izni ve kaynak alıntısı şartıyla testi tekrarlayıp farkı gördünüz mü, çıktıyı kaynakla karşılaştırdınız mı?
- Güvenlik: API anahtarı kodun dışında mı, harcama sınırı var mı, talimat gizlenmiş belgeyle denediniz mi?
- Veri ve kurallar: Gerçek kişisel veri kullanılmadı mı, kullanım notu yazıldı mı, hukuki sorular uzmana bırakıldı mı?
16 ve üzeri çok iyi, 11 ile 15 arası iyi, 10 ve altı ise mimari ve test adımlarını yeniden gözden geçirmeniz gerektiğini gösterir.
Teslim kontrol listesi
- İşi ve ölçütü tek cümleyle yazdım.
- Skill ve salt okunur alt ajan çalışıyor.
- API anahtarı kodda değil, harcama sınırı var.
- En az 10 test vakası çalıştırıldı ve oran hesaplandı.
- Komut iyileştirmesinden önce ve sonra sonuçlar kaydedildi.
- Gizli talimatlı belge denendi.
- Kullanım notu yazıldı.
- Puanlama tablosunu doldurdum.
Ödevi bitirdikten sonra
En düşük puan aldığınız ölçüte dönün. Test puanınız düşükse vaka sayısını artırın ve zor vakalar ekleyin. Güvenlik puanınız düşükse araç izinlerini daraltın. Ajanı gerçek verilerle kullanmadan önce kurumunuzun hukuk birimine danışın.
Sık yapılan hatalar
- Ölçütü sayıya bağlamamak; “iyi çalıştı” demek.
- Yalnızca kolay vakaları denemek.
- Alt ajana Bash ve Write vermek.
- API anahtarını koda ya da paylaşılan dosyaya yazmak.
- Harcama sınırı koymadan uzun bir görevi başlatmak.
İpucu
Vakaları iki gruba ayırın. Komutu birinci grupla geliştirin, ikinci grubu yalnızca son ölçümde kullanın. Böylece iyileştirmenin gerçek olup olmadığını görürsünüz.
Kendinizi deneyin
Bu ödevde alt ajan neden salt okunur araçlarla sınırlandırılır?
Hangisi iyi bir başarı ölçütü örneğidir?
Gizli talimat içeren belgeyle neden deneme yapılır?
Kaynaklar
- Subagents in the SDK – Claude Code Docs (İngilizce)
- Agent SDK quickstart – Claude Code Docs (İngilizce)
- Define success criteria and build evaluations – Claude Platform Docs (İngilizce)
- Mitigate jailbreaks and prompt injections – Claude Platform Docs (İngilizce)
- KVKK Rehberler (Türkçe)
Son kontrol: 7 Kasım 2026
Kaynak: yzdersleri.com/ders/claude-ileri-bitirme-odevi/ · Yapay Zeka Dersleri
Dersi bitirdiniz mi?
İşaretlerseniz menüde ve ilerleme çubuğunda görünür. Bu bilgi yalnızca sizin tarayıcınızda saklanır.
Öğrenme yolunda sıradaki ders: Bağlam penceresi nedir, dolduğunu nasıl anlarsınız? Özetleyip sürdürmek mi, yeni sohbet mi?
Bu ders işinize yaradı mı?
Anonim oydur; kişisel veri toplanmaz.
